淺談angular2+ionic2
前言：
不要用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
a) Npm install -g node
2、 安裝ionic
a) Npm install –g ionic
3、 安裝typescript
a) 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練習就算成功了
若你還未成功 請參考如下
源碼包：