來扯點ionic3[1] 創建一個新頁面

上一章: 來扯點ionic3[0] 吹完牛再入門也不遲

目錄

創建一個頁面組件
簡單了解裝飾器
在AppModule中注冊頁面
第一次展現
使用獨立的模板文件

一個APP中最基本的元素可謂是頁面了,所以當我們創建了一個新的APP后,就應該了解一下如何創建一個新頁面。

創建一個頁面組件

在 ionic 中,頁面是以組件(component)的形式存在的,每個頁面都是一個獨立的組件。我們現在需要建一個名為test的頁面,我們現在pages文件夾下新建一個文件夾,并創建一以 .ts 結尾的同名文件。

在 test.ts 中添加第一部分代碼

import { Component } from '@angular/core'

@Component({
    selector: 'page-test',
    template: `<h1>Hello World!</h1>`
})
export class TestPage {}

在這幾行代碼中,我們只做了一件事情,就是聲明了TestPage頁面類:

  • export關鍵詞:將類暴露出去,以便其它的文件可以import到它。
  • 類的命名:在ionic3中,頁面類采用頁面名+Page的命名方式,首字母大寫,如HomePage, ContactPage等。

簡單了解裝飾器

我們發現在類的聲明語句之前,有一串看似不明所以的代碼。它就是Component裝飾器,裝飾器(decorator)在ES6中是以@開頭的特殊的函數,可以動態地給類添加一些功能,在這里Component裝飾器就會根據傳入的配置對象,為頁面類賦予創建頁面視圖的功能。

而這里Component并非憑空出現的,而是文件的第一行,通過import語句將其導入進來的。

import { Component } from '@angular/core'

@angular/core是一個npm的模塊,定義了angular的核心功能,你可以在node_modules目錄下找到它。

我們在裝飾器中配置了兩個東西,selector和template:

  • selector:為頁面指定選擇器的名稱,可以在css為組件使用特定的樣式,在ionic 3.x中規范為 page- 開頭,為了不造成混亂,需要保持每個頁面selector的唯一性。
<h1>Hello World!</h1>
  • template : 模板的字符串,里面其實就是html代碼,它是最終展示在頁面上的內容;這兒的字符串是用 ` 符號包裹的(就是esc下面那個),一來你可以自由地換行,二來不會有引號轉義的問題,當然在ES6中它有更重要的作用(參見末尾資料中的“模板字符串”)

在AppModule中注冊頁面

APPModule位于 src/app 目錄下的 app.module.ts中,APPModule是整個應用的根模塊,它是一個大工廠,負責把所有我們要用的東西組裝在一起。我們要把新添加的頁面注冊到根模塊當中,這只需要簡單的兩步:
1.引入TestPage頁面類,我們在文件的開頭部分,加上相關的語句,如果你是個對代碼整潔度有要求的人,你肯定是會加在已有的幾個頁面引入語句附近的:

import { AboutPage } from '../pages/about/about';
import { ContactPage } from '../pages/contact/contact';
import { HomePage } from '../pages/home/home';
import { TabsPage } from '../pages/tabs/tabs';
import { TestPage } from '../pages/test/test';

主意from后面的地址是不需要加 .ts 擴展名的,如果在編輯器或IDE中安裝了自動填充路徑的插件,很容易誤加后綴。

2.將TestPage分別加入declarations和entryComponents數組中:

@NgModule({
  declarations: [
    ...
    TabsPage,
    TestPage
  ],
  ...
  entryComponents: [
    ...
    TabsPage,
    TestPage
  ],
 ...

以說明TestPage是APP中需要用到的組件,而且是一個動態組件。

展現

我們尚不知道如何從已有的頁面中把test頁打開,我們用一個笨辦法來觀察我們剛剛創建的頁面,打開 pages/tabs/tabs.ts ,導入TestPage,并把 tab1Root 替換掉,讓應用的首屏變成test頁面。

...
import { TestPage } from '../test/test';
...
export class TabsPage {

  tab1Root = TestPage;
  ...

運行serve命令,打開本地服務器,得到了這樣的界面

使用獨立的模板文件

我們得到的顯然不是一個典型的APP頁面,現在我們再test文件夾下新建test.html

<ion-header>
  <ion-navbar>
    <ion-title>
      Test
    </ion-title>
  </ion-navbar>
</ion-header>
<ion-content>
  <h1>Hello World!</h1>
</ion-content>

這一段HTML代碼就是一個標準的ionic頁面結構,很多標簽都是ionic定制的,頁面分為頭部(ion-header)和主體(ionic-content)兩個部分,頭部包含了導航欄(ion-navbar)及標題(ion-title),而主體部分,就是我們自定義的內容。

回到test.ts,把剛才裝飾器嵌入的模板代碼

template: `<h1>Hello World!</h1>`

替換為引入獨立模板文件的代碼

templateUrl:'./test.html'

注意這里包裹路徑的符號變成了單引號。

在發生改動之后,瀏覽器會自動刷新頁面,此時我們看到了現在的頁面:


總結

至此我們完成了一個頁面的創建,看似步驟有點多,但是熟練了以后這是一個非常快速的過程,總的說來一共就三步:

1.創建組件文件 .ts
2.在AppModule中注冊組件
3.創建模板文件 .html

第二步和第三步實際上是可以順序互換的。

下一章將會介紹頁面之間的跳轉,以及頁面棧原理。

參考資料

1.修飾器(ECMAScript6 入門)
2.模板字符串(ECMAScript6 入門)

下一章: 來扯點ionic3[2] 頁面一線牽 珍惜這段緣

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。

推薦閱讀更多精彩內容