不要用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