不要用angular的語法去寫angular2,有人說兩者就像Java和JavaScript的區別。css
一、 項目所用:angular2+ionic2+typescripthtml
二、 項目結構java
三、 Src目錄是咱們本地開發的目錄文件,www我ionic2編譯後生成的文件node
四、 每一個文件夾下面都有三個文件 分別是.Html、.scss、.ts分別表明結構文件、樣式文件、功能文件。也就是HTML+css+js,ionic2+angular2所用的是typescript插件替代js。瞭解 typescriptandroid
五、 注意事項node_modules文件放在本地便可沒必要提交。git
六、 開發準備:github
一、 安裝nodetypescript
Npm install -g nodeapache
二、 安裝ionicnpm
Npm install –g ionic
三、 安裝typescript
Npm install –g typescript
七、 開始開發(一個demo並不是項目開發)
案例實現的功能:獲取後臺數據進行頁面渲染、新增頁面、頁面間跳轉
一、 建立模板
a) ionic start projectname tutorial --v2
projectname表示你的文件名
tutorial表示建立的模板樣式,ionic總有三套模板
若不寫則表示默認建立tabs模板
--v2表示建立ionic2 不寫着默認建立ionic
2、運行
模板建立好後 ionic serve
你會看到
咱們還能夠跨平臺運行 ionic serve –l
當你第一次產生ionic2應用程序,這是生成的項目結構
├── ├── config.xml
├── hooks
├── ionic.config.json
├── node_modules
├── package.json
├── platforms
├── plugins
├── resources
├── src
├── tsconfig.json
├── tslint.json
咱們幾乎老是會花90%的時間在src文件夾,這就是應用程序邏輯。然而整個應用程序一般從一個簡單的src /index.html文件,它在構建複製到一個新文件夾www
三、
src/index.html
<!DOCTYPE html> <html lang="en" dir="ltr"> <head> <meta charset="UTF-8"> <title>Ionic App</title> <meta name="viewport" content="width=device-width, initial-scale=1.0, minimum-scale=1.0, maximum-scale=1.0, user-scalable=no"> <meta name="format-detection" content="telephone=no"> <meta name="msapplication-tap-highlight" content="no"> <link rel="icon" type="image/x-icon" href="assets/icon/favicon.ico"> <link rel="manifest" href="assets/manifest.json"> <meta name="theme-color" content="#4e8ef7"> <!-- un-comment this code to enable service worker <script> if ('serviceWorker' in navigator) { navigator.serviceWorker.register('assets/service-worker.js') .then(() => console.log('service worker installed')) .catch(err => console.log('Error', err)); } </script>--> <link href="build/main.css" rel="stylesheet"> </head> <body> <!-- Ionic's root component and where the app will load --> <ion-app></ion-app> <!-- cordova.js required for cordova apps --> <script src="cordova.js"></script> <!-- The polyfills js is generated during the build process --> <script src="build/polyfills.js"></script> <!-- The bundle js is generated during the build process --> <script src="build/main.js"></script> </body> </html>
咱們幾乎從不碰這個文件。
注意< ion-app > < / ion-app >:這是ionic的應用程序的入口點。這叫作根組件的應用程序。
咱們很快就會看到它的定義,但這就是angular2應用程序的構建。總有一種<root-component> < /root-component>結構指數。html頁面。這個文件的其餘部分只是裝載離子構建依賴關係。
四、 簡要描述項目結構。
五、 config.xml -這包含配置應用程序的名稱,和包名,將被用於咱們的應用程序安裝到一個實際的設備。
src -這就是咱們花費咱們大部分的時間創建應用程序。它包含結構化程序的源代碼。
node_modules -包含了npm包
package.json 這些都是包構建ionic應用程序所必需的
platforms -這就是平臺的具體構建,構建工具和包/庫存儲。你會發現一個文件夾你正在構建的平臺。例如,添加一個平臺, ionic platform add android,這將文件夾安卓文件夾添加到文件夾中。
plugins -這就是cordova plugins。cordova插件容許你的應用在移動設備本地功能,e。g訪問的媒體存儲設備,甚至藍牙API。
resources -這也包含特定於平臺的資源(如圖標和啓動屏幕)
六、 最後,讓咱們仔細看看src / app / app.module.ts
import { NgModule } from '@angular/core';
import { IonicApp, IonicModule } from 'ionic-angular';
import { MyApp } from './app.component';
import { HelloIonicPage } from '../pages/hello-ionic/hello-ionic';
import { ItemDetailsPage } from '../pages/item-details/item-details';
import { ListPage } from '../pages/list/list';
七、
@NgModule({ declarations: [ MyApp, HelloIonicPage, ItemDetailsPage, ListPage ], imports: [ IonicModule.forRoot(MyApp) ], bootstrap: [IonicApp], entryComponents: [ MyApp, HelloIonicPage, ItemDetailsPage, ListPage ], providers: [] }) export class AppModule {}
七、因爲咱們使用這個angular2模塊結構,咱們須要申報前手的全部組件,提供者、指示或管道,咱們的應用程序使用。咱們會將這些添加到這個文件。您能夠看到,這個模板導入全部它須要的頁面,添加的宣言財產@NgModule entryComponents財產。這也是咱們導入根組件中定義的地方src / app / app.component.ts
咱們的ionic的應用將有3個主要頁面。一個對於github用戶,另外一個用於github組織,另外一個用於github庫。最後兩頁只是視圖來顯示咱們能夠與側邊欄導航,他們將沒有任何內容。然而,github用戶頁面將使您可以查看用戶的詳細信息。
八、在src /頁面中刪除全部文件夾。而後咱們將首先快速建立三個主要頁面的幫助下離子CLI。運行這些在你的終端
ionic g page users
ionic g page repos
ionic g page organisations
你會發現src/pages文件下生成了三個頁面
User-details是後面開發所生成並不是此次所生成的
九、打開三個文件夾中的html文件
< ion-navbar >負責導航欄。咱們能夠說這是在這種狀況下的導航組件。
ion-button是ionic的建於指令2按鈕。這個例子中有一個
icon-only指令來代表這是一個圖標按鈕。
menuToggle是一個建在指令幫助切換菜單。
而後咱們有< ion-icon >,這是一個組件負責處理圖標。咱們只是給它的圖標名稱基於這個ionic圖標列表。
< ion-title >顯示頁面標題。
< ion-content >保存頁面的內容。它有一個填充指令提供一點填充內容。
10、打開新建立三個文件中的ts文件
ionViewDidLoad()方法是一個ionic生命週期鉤。一旦一個離子視圖加載它他就進行加載此函數內的代碼
咱們會將這些頁面添加到導航。去src / app / app.component.ts咱們會作一些改變。若是你仔細檢查有一個類屬性叫作pages。這就是組成的sidenav(ion-menu)視圖,顯示在
src / app / app.html。
<ion-menu [content]="content"> <ion-header> <ion-toolbar> <ion-title>Pages</ion-title> </ion-toolbar> </ion-header> <ion-content> <ion-list> <button ion-item *ngFor="let p of pages" (click)="openPage(p)"> {{p.title}} </button> </ion-list> </ion-content> </ion-menu> <ion-nav [root]="rootPage" #content swipeBackEnabled="false"></ion-nav>
咱們不會碰這個文件,咱們將使用它生成的。按鈕有一個* ngFor =「讓p的頁面」指令,這就是angular2執行重複的模板。這僅僅意味着遍歷頁面收集和生成一個集合中的每一項的模板。若是咱們改變頁面屬性的值,咱們改變的內容sidenav(ion-menu)。
< ion-nav >是顯示頁面導航。根屬性綁定到頁面中rootPage類。咱們很快就會看到這個詳細定義。
sidenav添加正確的頁面,咱們將作一些更改src / app / app.component.ts文件。我有刪除兩個導入語句(HelloIonicPage和ListPage)頂部的頁面刪除,併爲咱們建立的頁面添加導入語句。
十一、打開src/app/app.component.ts
UsersPage ReposPage和OrganisationsPage組件類,表明頁面搭建當咱們生成一個單獨的頁面。你能夠檢查他們在src/pages/users/users.ts 、 src/pages/repos/repos.ts 和src/pages/organisations/organisations.ts.
而後咱們將編輯頁面類屬性來匹配咱們的新頁面。
// imports commented out for brevity
export class MyApp { @ViewChild(Nav) nav: Nav; // make UsersPage the root (or first) page rootPage: any = UsersPage; pages: Array<{title: string, component: any}>; constructor(public platform: Platform, public menu: MenuController) { this.initializeApp(); // set our app's pages
this.pages = [ { title: 'Users', component: UsersPage }, { title: 'Repos', component: ReposPage }, { title: 'Organisations', component: OrganisationsPage }, ]; } initializeApp() { this.platform.ready().then(() => { // Okay, so the platform is ready and our plugins are available. // Here you can do any higher level native things you might need. StatusBar.styleDefault(); }); } openPage(page) { // close the menu when clicking a link from the menu this.menu.close(); // navigate to the new page if it is not the current page this.nav.setRoot(page.component); } }
注意,rootPage UsersPage類屬性設置。記住,在視圖中src/app/app.html。html < ion-nav >根屬性綁定到這個rootPage。這意味着UsersPage應用程序加載時將顯示第一個。
openPage方法負責當點擊打開頁面。若是你看回ssrc/app/app.html。咱們能夠看到
綁定到該方法的列表頁面(點擊)=「openPage(p)」。在一個頁面,並打開它。很簡單,是吧?
最後咱們須要作什麼來完成這個設置是咱們頁面告訴角。這是在src / app / app.module完成。ts文件。
導入全部的三個頁面,並將它們添加到聲明和entryComponents @NgModule的屬性。刪除咱們不使用的進口
打開
src/app/app.module.ts
import { NgModule } from '@angular/core'; import { IonicApp, IonicModule } from 'ionic-angular'; import { MyApp } from './app.component'; import { UsersPage } from '../pages/users/users'; import { ReposPage } from '../pages/repos/repos'; import { OrganisationsPage } from '../pages/organisations/organisations'; @NgModule({ declarations: [ MyApp, UsersPage, ReposPage, OrganisationsPage ], imports: [ IonicModule.forRoot(MyApp) ], bootstrap: [IonicApp], entryComponents: [ MyApp, UsersPage, ReposPage, OrganisationsPage ], providers: [] }) export class AppModule {}
運行程序
十一、得到Github用戶
這裏有一個服務是從從https://api.github.com/users得到Github用戶。頁面列出了大約30的github json格式的用戶。
首先,咱們須要建立一個Github的用戶模型。這是一個類,它擁有咱們想要的相關字段github的用戶,從github提供不少細節。
在src文件夾中建立一個文件夾叫models。這就是咱們將把咱們的用戶模型和其餘模型之後咱們可能但願建立。在src / user.ts模型並添加一個文件 user.ts.
src/models/user.ts
// User model based on the structure of github api at // https://api.github.com/users/{username} export interface User { login: string; avatar_url: string; public_repos: number; public_gists: number; followers: number; following: number; }
咱們只包含屬性咱們須要從github的迴應。如今咱們定義了咱們的模型,咱們能夠建立一個github-users提供者來讓咱們把用戶從github。生成一個提供者在終端運行如下
ionic g provider github-users
這將建立一個文件夾叫providers 在src目錄中,和github-users.ts文件。
咱們稍微修改生成的src / providers / github-users.ts文件
import { Injectable } from '@angular/core'; import { Http } from '@angular/http'; import { Observable } from 'rxjs/Rx'; import 'rxjs/add/operator/map'; import { User } from '../models/user'; @Injectable() export class GithubUsers { githubApiUrl = 'https://api.github.com'; constructor(public http: Http) { } // Load all github users load(): Observable<User[]> { return this.http.get(`${this.githubApiUrl}/users`) .map(res => <User[]>res.json()); } }
@Injectable()decorator是angular2聲明它的服務/提供者
Observable
的引入是必要的,由於咱們將返回github API調用的結果做爲一個Observable
。認爲一個Observable
的數據流能夠訂閱。咱們來看看這一點細節。
咱們作的第一件事是要導入的用戶模型導入{User} from '../models/user'
.
負載而後咱們添加一個函數,該函數將返回一個Observable
咱們作一個請求到github api,並解析json響應與res.json(),而後咱們扮演一個數組的用戶與用戶[]> < res.json()。這是做爲一個Observable
返回,咱們會看到用戶訂閱。
使用咱們的服務在整個應用程序,咱們須要將它添加到src / app / app.module.ts文件。
// Imports commnted out for brevity import { GithubUsers } from '../providers/github-users'; @NgModule({ declarations: [ // Declarations commented out for brevity ], imports: [ IonicModule.forRoot(MyApp) ], bootstrap: [IonicApp], entryComponents: [ // Entry Components commented out for brevity ], providers: [GithubUsers] // Add GithubUsers provider }) export class AppModule {}
咱們只是導入GithubUsers並添加NgModule的提供者屬性。
十二、查看Github用戶
如今咱們有咱們的用戶,查看用戶頁面。咱們能夠作這個以前,咱們須要測試咱們是否讓用戶從咱們的provider。
src/pages/users/users.ts 文件,使它看起來跟下面的同樣。
import { Component } from '@angular/core'; import { NavController } from 'ionic-angular'; import { User } from '../../models/user'; import { GithubUsers } from '../../providers/github-users'; @Component({ selector: 'page-users', templateUrl: 'users.html' }) export class UsersPage { users: User[] constructor(public navCtrl: NavController, private githubUsers: GithubUsers) { githubUsers.load().subscribe(users => { console.log(users) }) } } src/pages/users/users.ts // Imports commented out for brevity @Component({ // Commented out for brevity }) export class UsersPage { users: User[] constructor(public navCtrl: NavController, private githubUsers: GithubUsers) { githubUsers.load().subscribe(users => { this.users = users; }) } }
src/pages/users/users.html
<ion-header> <!-- ion-header contents commented out for brevity --> </ion-header> <ion-content padding> <ion-list> <button ion-item *ngFor="let user of users"> <ion-avatar item-left> <img [src]="user.avatar_url"> </ion-avatar> <h2>{{ user.login }}</h2> <ion-icon name="arrow-forward" item-right></ion-icon> </button> </ion-list> </ion-content>
1三、查看用戶詳細信息
接下來,咱們將建立details視圖爲用戶將達到經過點擊列表中的一個特定用戶的用戶。
使用ionic CLI,建立一個新的名爲用戶詳細信息的頁面
ionic g page user-details
用戶詳細信息文件夾內頁建立文件夾,有三個文件,頁面的html,ts和scss樣式。
重命名類在 src/app/pages/user-details/user-details.ts的 UserDetailsPage。這不是必要的,它只是一個偏好。
import { Component } from '@angular/core'; import { NavController } from 'ionic-angular'; @Component({ selector: 'page-user-details', templateUrl: 'user-details.html' }) export class UserDetailsPage { constructor(public navCtrl: NavController) {} ionViewDidLoad() { console.log('Hello UserDetails Page'); } }
咱們作任何事以前要確保經過點擊用戶,此頁面加載。
咱們首先將頁面添加到src / app / app.module.ts文件。
// Other imports import {UserDetailsPage } from '../pages/user-details/user-details'; @NgModule({ declarations: [ // OtherPages, UserDetailsPage // Add UserDetailsPage here ], imports: [ IonicModule.forRoot(MyApp) ], bootstrap: [IonicApp], entryComponents: [ // Other Pages, UserDetailsPage // Add UserDetailsPage here ], providers: [GithubUsers] }) export class AppModule {}
而後讓咱們作一些更改用戶詳細信息頁面模板
src/pages/user-details/user-details.html
<ion-header> <ion-navbar> <ion-title>{{login}}'s details</ion-title> </ion-navbar> </ion-header> <ion-content padding > <h3>User Details view page</h3> </ion-content>
咱們把在{ {login } }視圖標題,由於咱們打算經過用戶視圖。
接下來,咱們將去Users 頁面,添加一個導航用戶詳細信息頁面。
src/pages/users/users.ts
// Other Imports
import { UserDetailsPage } from '../user-details/user-details'; @Component({ selector: 'page-users', templateUrl: 'users.html' }) export class UsersPage { users: User[] constructor(public navCtrl: NavController, private githubUsers: GithubUsers) { // Commented out for brevity } goToDetails(login: string) { this.navCtrl.push(UserDetailsPage, {login}); } }
首先咱們在頂部導入UserDetailsPage與引入{UserDetailsPage} from '../user-details/user-details'
.
而後,咱們添加一個方法處理導航,goToDetails。它接受一個登陸(username)做爲參數。
ionic2把導航堆棧,這意味着頁面上添加對方。這就是爲何你看到this.navCtrl。推,咱們把一個頁面導航堆棧。回去或按後退按鈕就像彈出堆棧中的最後一個元素(後進先出)。第二個參數推的對象咱們但願傳遞到下一個頁面。
{login}是一個es5屬性速記。在es5,裏翻譯{ login: login }。
最後,咱們須要把這個goToDetails視圖中。
src/pages/users/users.html
<!-- ion-header --> <ion-content padding> <ion-list> <button ion-item *ngFor="let user of users" (click)="goToDetails(user.login)"> <!-- ion-item content--> </button> </ion-list> </ion-content>
全部咱們所作的就是添加 (click)="goToDetails(user.login)"
「在directive * ngFor指令。
最後,咱們須要經過用戶詳細信息頁面。
src/pages/user-details/user-details.ts
import { Component } from '@angular/core'; import { NavController, NavParams } from 'ionic-angular'; @Component({ selector: 'page-user-details', templateUrl: 'user-details.html' }) export class UserDetailsPage { login: string; constructor(public navCtrl: NavController, private navParams: NavParams) { this.login = navParams.get('login'); } }
咱們只是把NavParams添加到現有的進口使咱們訪問的導航參數。
而後,宣佈一個login類型爲string的屬性。記住這是用戶名。
咱們注入NavParams NavParams提供者在構造函數中,咱們使用來傳遞的參數的值的前一頁。 this.login = navParams.get('login')
.這應該正確地更新用戶的login/username在咱們的細節視圖。
運行 ionic serve
你會看到
username/login在視圖中點擊應該做爲一個標題。
1四、獲得正確的用戶的細節。
如今咱們已經vew用戶在咱們的細節,咱們須要他的具體細節。要作到這一點,咱們須要編輯GithubUsers提供者來處理請求。請求將https://api.github.com/users/ {login},咱們經過 username/login做爲最後一個參數。
src/providers/github-users.ts
// Imports @Injectable() export class GithubUsers { githubApiUrl = 'https://api.github.com'; constructor(public http: Http) { } // Load all github users load(): Observable<User[]> { // Load useres } // Get github user by providing login(username) loadDetails(login: string): Observable<User> { return this.http.get(`${this.githubApiUrl}/users/${login}`) .map(res => <User>(res.json())) } }
咱們添加了一個幾乎相同的loadDetails initail load()調用的方法()。它接受一個字符串做爲參數並返回一個可觀測的用戶登陸,咱們能夠訂閱請求的結果。它能夠響應用戶模型的<User>res.json()
.
http.get請求發送到${this.githubApiUrl}/users/${login}這是ES6模板字符串,也可用在打印稿。它涉及使用引號的,下面的關鍵escape鍵在鍵盤上,和經過任何值$ { var }語法,並將reolve到一個有效的字符串。
如今,咱們去用戶詳細信息頁面,並獲得正確的用戶詳細信息。
src/pages/user-details/user-details.ts
// Other imports
import { User } from '../../models/user'; import { GithubUsers } from '../../providers/github-users'; @Component({ selector: 'page-user-details', templateUrl: 'user-details.html' }) export class UserDetailsPage { user: User; login: string; constructor(public navCtrl: NavController, private navParams: NavParams, private githubUsers: GithubUsers) { this.login = navParams.get('login'); githubUsers.loadDetails(this.login).subscribe(user => { this.user = user; console.log(user) }) } }
咱們首先引入GithubUsers服務與引入 import {GithubUsers} from '../../providers/github-users';
..
而後咱們引入import {User} from '../../models/user';
.
而後咱們在構造函數中注入githubUsers githubUsers而後調用。loadDetails值從導航檢索params login。咱們分配結果卻「user」類屬性,而後記錄結果,只是爲了debuggin目的。
運行 ionic serve
1五、顯示用戶詳細信息
如今咱們有用戶的詳細信息,咱們應該在視圖中顯示它們。咱們只顯示followers, followers,公共回購和公共依據數字。
由於咱們已經增長了。 this.user = user
,分配結果類的用戶屬性,咱們如今能夠建立一個視圖經過編輯html頁面的模板。
app/pages/user-details/user-details.html
<!-- ion-header --> <ion-content padding > <ion-list> <ion-item> <ion-label>Followers</ion-label> <ion-badge item-right>{{user?.followers}}</ion-badge> </ion-item> <ion-item> <ion-label>Following</ion-label> <ion-badge item-right>{{user?.following}}</ion-badge> </ion-item> <ion-item> <ion-label>Repos</ion-label> <ion-badge item-right>{{user?.public_repos}}</ion-badge> </ion-item> <ion-item> <ion-label>Gists</ion-label> <ion-badge item-right>{{user?.public_gists}}</ion-badge> </ion-item> </ion-list> </ion-content>
而後會看到
1六、搜索用戶
這是最後的特色應用。咱們會經過添加一個搜索框頂部的用戶頁面。ionic2提供了一個自定義searchbar組件,咱們將使用。
src/pages/users/users.html
<!--HTML commented out for brevity-->
<ion-content padding> <ion-searchbar></ion-searchbar> <ion-list> <!--HTML commented out for brevity--> </ion-list> </ion-content>
咱們添加了一個搜索欄< ion-searchbar >,並且應該有一個searchbar頂部的頁面。
搜索背後的邏輯很簡單。既然咱們已經列出,咱們會與咱們的結果更新列表。github api使您能夠搜索如下url結構https://api.github.com/search/users?q = { searchParam }, searchParam。
咱們將首先建立一個提供者方法搜索GithubUsers提供者。該方法也幾乎相似於load()方法。
src/providers/github-users.ts
// Imports
@Injectable() export class GithubUsers { githubApiUrl = 'https://api.github.com'; constructor(public http: Http) { } // Load all github users load(): Observable<User[]> { Load Users } // Get github user by providing login(username) loadDetails(login: string): Observable<User> { // Load Details } // Search for github users searchUsers(searchParam: string): Observable<User[]> { return this.http.get(`${this.githubApiUrl}/search/users?q=${searchParam}`) .map(res => <User[]>(res.json().items)) } }
searchUsers方法須要在搜索參數,它將url傳遞給api。而後咱們返回一個可觀察到的 User[]
(Array of users) 像咱們最初的加載方法。
爲了測試咱們的搜索方法,去用戶頁面。
src/pages/users/users.ts
@Component({ selector: 'page-users', templateUrl: 'users.html' }) export class UsersPage { users: User[] constructor(public navCtrl: NavController, private githubUsers: GithubUsers) { // Load GithubUsers githubUsers .searchUsers('scotch').subscribe(users => { console.log(users) }); } // goToDetails }
1七、簡單檢索
咱們只搜索時三個或更多字符類型。讓咱們抓住searchbar從用戶輸入的值。
src/pages/users/user.html
<!-- HTML commented out for brevity -->
<ion-content padding > <ion-searchbar (input)="search($event)"></ion-searchbar> <ion-list> <!-- HTML commented out for brevity --> </ion-list> </ion-content>
咱們已經添加了一個(input)="search($event)"在ion-searchbar searchbar捕捉輸入事件。經過angular2綁定到事件(event)的語法。
src/pages/users/users.ts
// Imports commented out for brevity
@Component({ selector: 'page-users', templateUrl: 'users.html' }) export class UsersPage { users: User[] originalUsers: User[]; constructor(public navCtrl: NavController, private githubUsers: GithubUsers) { githubUsers.load().subscribe(users => { this.users = users; this.originalUsers = users; }) } goToDetails(login: string) { this.navCtrl.push(UserDetailsPage, {login}); } search(searchEvent) { let term = searchEvent.target.value // We will only perform the search if we have 3 or more characters if (term.trim() === '' || term.trim().length < 3) { // Load cached users this.users = this.originalUsers; } else { // Get the searched users from github this.githubUsers.searchUsers(term).subscribe(users => { this.users = users }); } } }
咱們增長了一個originalUsers類屬性,緩存的原始結果github用戶獲取。
運行
1八、運行應用程序。
Ionic serve
Demo練習就算成功了
若你還未成功 請參考以下
源碼包: https://github.com/owenma/myApp