不要用angular的語法去寫angular2,有人說二者就像Java和JavaScript的區別。
1、 項目所用:angular2+ionic2+typescript
2、 項目結構
3、 Src目錄是我們本地開發的目錄文件,www我ionic2編譯后生成的文件
4、 每個文件夾下面都有三個文件 分別是.Html、.scss、.ts分別代表結構文件、樣式文件、功能文件。也就是HTML+css+js,ionic2+angular2所用的是typescript插件替代js。了解 typescript
5、 注意事項node_modules文件放在本地即可不必提交。
6、 開發准備:
1、 安裝node
Npm install -g node
2、 安裝ionic
Npm install –g ionic
3、 安裝typescript
Npm install –g typescript
7、 開始開發(一個demo並非項目開發)
案例實現的功能:獲取后台數據進行頁面渲染、新增頁面、頁面間跳轉
1、 創建模板
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
3、
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頁面。這個文件的其他部分只是裝載離子構建依賴關系。
4、 簡要描述項目結構。
5、 config.xml -這包含配置應用程序的名稱,和包名,將被用於我們的應用程序安裝到一個實際的設備。
src -這就是我們花費我們大部分的時間建立應用程序。它包含結構化程序的源代碼。
node_modules -包含了npm包
package.json 這些都是包構建ionic應用程序所必需的
platforms -這就是平台的具體構建,構建工具和包/庫存儲。你會發現一個文件夾你正在構建的平台。例如,添加一個平台, ionic platform add android,這將文件夾安卓文件夾添加到文件夾中。
plugins -這就是cordova plugins。cordova插件允許你的應用在移動設備本地功能,e。g訪問的媒體存儲設備,甚至藍牙API。
resources -這也包含特定於平台的資源(如圖標和啟動屏幕)
6、 最后,讓我們仔細看看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';
7、
@NgModule({ declarations: [ MyApp, HelloIonicPage, ItemDetailsPage, ListPage ], imports: [ IonicModule.forRoot(MyApp) ], bootstrap: [IonicApp], entryComponents: [ MyApp, HelloIonicPage, ItemDetailsPage, ListPage ], providers: [] }) export class AppModule {}
7、由於我們使用這個angular2模塊結構,我們需要申報前手的所有組件,提供者、指示或管道,我們的應用程序使用。我們會將這些添加到這個文件。您可以看到,這個模板導入所有它需要的頁面,添加的宣言財產@NgModule entryComponents財產。這也是我們導入根組件中定義的地方src / app / app.component.ts
我們的ionic的應用將有3個主要頁面。一個對於github用戶,另一個用於github組織,另一個用於github庫。最后兩頁只是視圖來顯示我們可以與側邊欄導航,他們將沒有任何內容。然而,github用戶頁面將使您能夠查看用戶的詳細信息。
8、在src /頁面中刪除所有文件夾。然后我們將首先快速創建三個主要頁面的幫助下離子CLI。運行這些在你的終端
ionic g page users
ionic g page repos
ionic g page organisations
你會發現src/pages文件下生成了三個頁面
User-details是后面開發所生成並非這次所生成的
9、打開三個文件夾中的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)頂部的頁面刪除,並為我們創建的頁面添加導入語句。
11、打開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 {}
運行程序
11、獲得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的提供者屬性。
12、查看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>
13、查看用戶詳細信息
接下來,我們將創建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在視圖中點擊應該作為一個標題。
14、得到正確的用戶的細節。
現在我們已經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
15、顯示用戶詳細信息
現在我們有用戶的詳細信息,我們應該在視圖中顯示它們。我們只顯示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>
然后會看到
16、搜索用戶
這是最后的特點應用。我們會通過添加一個搜索框頂部的用戶頁面。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 }
17、簡單檢索
我們只搜索時三個或更多字符類型。讓我們抓住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用戶獲取。
運行
18、運行應用程序。
Ionic serve
Demo練習就算成功了
若你還未成功 請參考如下
源碼包: https://github.com/owenma/myApp