Ext JS 6學習文檔-第3章-基礎組件


Ext JS 6學習文檔-第3章-基礎組件

基礎組件

在本章中,你將學習到一些 Ext JS 基礎組件的使用。同時我們會結合所學創建一個小項目。這一章我們將學習以下知識點:

  • 熟悉基本的組件 – 按鈕,文本框,日期選擇器等等
  • 表單字段的校驗
  • 菜單和工具欄
  • 設計一個表單
  • 計算器程序– 本章的示例項目

本章的主要目的是創建一個表單設計和一個計算器示例項目。以下圖分別展示了表單設計和計算器設計。

首先,你觀察下列表單設計,你會發現我們使用了大量的控件,例如 label 和文本框。

以下圖展示了表單的設計:

1

 

繼續,設計計算器程序大量的使用了按鈕控件。所以你首要學習的是按鈕和 handler 。隨后在本章最后我們將會構建一個 計算器程序。在這個過程中,你會知道如何使 view(視圖) 和 controller(控制器)進行交互並協同工作。我們還將看到如何綁定 view model(視圖模型) 的屬性到一個 view(視圖) 的字段上。

下圖為計算機的設計展示:

1

熟悉基本組件

Ext JS 有大量的優秀的控件,現在讓我們開始認識這些基礎的組件吧。

Ext.Button

這是一個很常用的控件;handler 是用於處理單擊事件,如以下代碼所示:

前面代碼的輸出:

1

 

我在第二章已經介紹過如何運行樣例代碼,但這里我還想再次重申這一點,此文檔中的大部分樣例代碼都是可以直接運行的。你可以選擇在你本地設備上或者在 Sencha Fiddle 上執行這些示例代碼。你可以訪問 Sencha Fiddle 並將上面的代碼鍵入到 launch 函數中,運行並查看結果。如果你訪問了https://fiddle.sencha.com 將會看到下列代碼:

 

現在粘貼下列的創建按鈕的樣例代碼,運行並查看結果:

 

  • 不是所有的代碼都可以這樣運行,此外並非所有的示例代碼都會有視覺呈現。

你還可以使用 listeners 配置添加更多的事件處理器,如以下代碼所示:

 

以上代碼只是創建了一個簡單的按鈕,你還可以創建很多不同的按鈕,有 link button(連接按鈕),menu button(菜單按鈕),toggle button(開關按鈕) 等等;

來創建一個鏈接按鈕,設置 href 屬性,如以下代碼所示:

上面創建的鏈接按鈕輸出如圖。當點擊它則打開鏈接:

1

 

通過設置 menu 屬性,創建一個菜單按鈕,如以下代碼所示:

輸出如下,當點擊時出現下拉菜單:

1

1

Ext.Button 還有許多屬性,例如 bind, cls, disabledhtmltooltiptpl 等等,你可以根據自己需求使用。

Ext.MessageBox

Ext.window.MessageBox 類提供了 message box 實現。Ext. MessageBox 是一個單例對象。你可以使用 MessageBox 彈出一個警告,信息確認,提示輸入等等。

下列代碼將彈出一個簡單的提示信息。這里解釋一下 Ext.Msg 是 Ext. Messagebox 類的別名:

 

下列代碼將彈出一個消息確認框,button 為選擇的值,取 yes 或 no :

 

你也可以自定義這個 message box 如下:

 

上面代碼輸出如下:

1

表單和表單字段

現在我們看一下都有哪些表單相關的組件。

Ext.form.Panel

這個 form panel (表單面板)繼承自 panel  並添加了表單相關的功能,例如字段管理,校驗,提交等等。form panel 的默認布局是 anchor layout ,但是如果需要你可以改變這個配置。

form panel 有一個很方便的配置為 fieldDefaults,它可以用於指定表單內所有字段的默認類型。

fields (字段/表單域)

Ext JS 提供了很多內置的表單字段。比較常用的一些字段:

 

我們看一下其中的一些字段的應用。

Ext.form.field.Text

這是一個基本的文本框,它具有很多有用的屬性和配置。其中有一個很有用的屬性是 vtype 它是用於校驗的。 例如以下代碼,這個 vtype 屬性為 email 用於驗證輸入內容是否是有效的電子郵箱:

這里 allowBlank 也是一個校驗屬性。通過設置 allowBlank 屬性為 false ,如果這個字段為空白,將會提示校驗不通過。

Ext.form.field.Number

number 字段繼承自 spinner 字段,spinner 字段則繼承自 text 字段,進而的 number 等於是繼承了兩者。這個 number 字段提供了幾個選項來處理數值。下列代碼創建了一個數值文本框:

1

你可以移除下拉按鈕,方向鍵,鼠標滾輪監聽,用配置:hideTrigger, keyNavEnabled,和 mouseWheelEnabled 。

Ext.form.field.ComboBox

下列代碼創建了一個月份下拉菜單。這個 combobox 有一個配置為 store。 這個 store 是數據源,為此下拉菜單提供數據。store 是屬於 ExtJS 中數據包部分, 在接下來的章節中我們會詳細介紹的。

combobox 中另一個重要的配置是 queryMode 。這個屬性取值可以是 ‘local’ 或者 ‘remote’。如果你設置為 remote 了,那么這個數據源 store 將在運行加載數據時發送請求從遠程服務器獲取數據:

 

以上代碼的輸出如下:

1

Ext.form.field.HtmlEditor

Ext JS 也有一個非常優秀的 HTML 編輯器,它提供直接在 web 頁面上處理文字的能力,如以下代碼所示:

 

以上代碼輸出如下:

 1

表單字段的校驗

大多數表單都有自己的校驗規則,例如你鍵入了一個非數值的內容到 number 字段,它將顯示一個驗證無效的提示。再有這個 text 字段(文本框) 校驗屬性有  allowBlankminLength,和 maxLength 。 更進一步的,還有 regex 屬性可以使用正則表達式自定義校驗。

form panel 的事件

form panel 支持的部分事件:

  • beforeaction: 任意動作執行前觸發,例如 submit,load,doAction 這些動作執行時
  • actionfailed: 執行一個動作失敗時觸發
  • actioncomplete: 在一個動作執行完成之后觸發This event will be fired after an action is completed
  • validitychange: 表單鍵入的內容有效性發生變化時觸發
  • dirtychange: 表單的dirty狀態改變時觸發

表單字段容器

以下是一些 from panel 里很有用的容器。

Ext.form.CheckboxGroup

CheckboxGroup 繼承自 FieldContainer 用於組織復選框。下列示例中,復選框組的 items 中所有的項都有相同的 name ;這有助於將得到的值作為一個單一的參數傳遞給服務器。

 

以上代碼輸出如下:

1

Ext.form.FieldContainer

FieldContainer 是很有用的,當你想將一組相關字段附加到一個標簽時。

以下代碼的輸出你會發現一個 label 后面綁定了兩個文本框:

 

Ext.form.RadioGroup

RadioGroup 繼承自 CheckboxGroup 用於組織單選按鈕。items 中的項都有相同的 name,另外這是單選的,如以下代碼所示:

 

代碼輸出:

1

提交表單

使用 form 的 submit 方法提交表單。使用 getForm 方法獲取表單並 isValid 方法進行提交前的表單內容校驗。如以下代碼所示:

 

菜單和工具欄

對於你能想到的任何的菜單和工具欄 Ext JS 提供了最完整的支持。Ext.toolbar.Toolbar 用於構建一個工具欄。默認情況下任何子項在Ext.toolbar.Toolbar 都是按鈕,但是你可以添加任意控件進去,例如一個文本框,一個數值框,一個圖標,一個下拉菜單等等。

規范整理你的工具欄中的項,你可以使用 空格(Ext.toolbar.Spacer), 分隔符(Ext.toolbar. Separator),和 使控件右對齊(Ext.toolbar.Fill) 。這里也可以使用快捷方式  ‘ ‘ (空格),’-‘ 和 ‘|’ (都是分隔符,只有很小的差別),和 ‘->‘ (右對齊)。

Ext.menu.Menu 用於構建一個菜單,items 屬性中為 Ext.menu.Item 一個個菜單項。

一個簡單的代碼示例和以下截圖的輸出:

1

 

設計一個(客戶反饋)表單

現在根據之前所學,我們來設計一個表單。

我們將設計如圖所示的表單:

1

以下是這個表單的代碼。這里我維護着一個這個例子的完整的源碼 https://github.com/ananddayalan/extjs-by-example-customer-feedback-form

這里我們所有的組件都在 Viewport 中。 這是一個專用的容器,它代表瀏覽器里應用的視圖區域。

在 Viewport 中我們設置 scrollable 選項將子組件設為滾動的,使用 true 或 false 。也可以取值為 x 或 y 表示只允許水平或垂直滾動:

 

在以上代碼中通過在容器級設置 defaultType 屬性,這樣我們就可以不必在容器的每個子組件里重復的指定 xtype 屬性了。這樣默認情況下,所有子組件在沒有顯式指定 xtype 時默認的類型都是 textfield 。

form panel 上有一個 flex 配置用於填補父容器的寬度,同時通過設置 maxWidth 為 700 限制 form panel 的最大寬度。

字段容器使用 hbox 布局將 first name 和 last name 文本框放在一個 label 標簽下。

 

寫一個計算器應用

現在我們結合目前所學構建一個完整的小項目。這是我們將要構建的計算器的設計:

 1

文件夾結構

這是我們創建的計算器工程的目錄結構。這里我不是用 sencha Cmd 生成的項目,只是從 Ext JS 復制了一些必須的文件到項目文件夾中:

1

完整可用的項目在這里: https://github.com/ananddayalan/extjs-by-example-calculator.

App – app.js

在 app.js 文件里我們簡單的創建了 Main 視圖,作為可移動窗體浮動在瀏覽器:

 

再談 MVC 和 MVVM

第一章的時候,我們已經介紹過 MVC (Model View Controller) 和 MVVM (Model View ViewModel)。 這個示例項目的代碼很好的展示了 視圖,控制器,和視圖模型之間的區別。

Model (模型)

這代表着數據層。model 保存的數據可以包含數據驗證和邏輯。

View (視圖)

這一層是用戶界面。包含有 button,form,和 message box 等等組件。在我們這次寫的計算器應用中 main.js 就是一個很好的視圖例子。

Controller (控制器)

控制器處理 view(視圖)相關的邏輯,例如 view 的 event(事件)處理,還有任何程序相關邏輯都可以寫在這里。

ViewController (視圖控制器) 和 Controller (控制器)

在 Ext JS 5 和 6 中,有兩種類型的控制器:ViewController 和 Controller。 這個 ViewController 自 Ext JS 5 開始引進的。ViewController 是為一個指定的視圖創建的控制器,但是這個控制器也可以交叉其他視圖的邏輯。

ViewController 帶來了一些新的概念,例如 引用和監聽,簡化視圖與控制之間的關系。同時 View 銷毀時 ViewController 也會被銷毀,他們具有相同的生命周期,在這個例子中我們沒有使用 引用和監聽,但是在下一個例子中我們會使用的。

  • 你可以使用 listeners  代替 handler 處理事件

 

View model

view model 封裝了 view(視圖)所需要的展示邏輯,綁定數據到 view 並且每當數據改變時處理更新。

它有別於 model ,view model 主要是為一個指定的視圖而創建的。一個 model 是一個純粹的數據類並可用於整個應用中,但一個 view model 是起到一個 view 和 model 之間的數據粘合劑的作用。看一下 main.js 的 視圖模型綁定。

視圖 — Main.js

這里我為這個計算器應用創建一個視圖為 Main 。這個視圖里包含所有的按鈕,顯示字段等等。相關的事件用 controller 的方法。這個視圖的控制器已經使用 controller 配置指定了。

這個視圖使用 table 布局,配置為 4 列。CSS 類使用 cls 屬性指定。

代碼里有附加的注釋:

 

控制器 — MainController.js

雖然這個控制器的代碼有點長,這是一個非常簡單的代碼。控制器中有很多方法處理按鈕的點擊事件,例如運算符和操作數的點擊處理。控制器使用了一個 model 為 Main :

 

 

視圖模型 — MainViewModel.js

這個 ViewModel 只有一個屬性為 display 。這個用來綁定到計算器顯示的值上。這里我們不會分別用一組字段創建模型,此外我們還將會硬編碼數據。

 

在即將到來的章節中你將學習更多關於 模型,視圖模型,字段,字段類型,校驗 等等。

總結

在本章中,你了解了不同的基本組件,例如 文本框,數字框,按鈕,菜單等等。你已經學會如何使用表單字段設計一個表單和我們之前創建了一個簡單的計算器項目。

 

本人喜交朋友,歡迎掃描博客公告處個人二維碼交流進步


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM