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

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

基礎組件html

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

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

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

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

如下圖展現了表單的設計:web

1

 

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

下圖爲計算機的設計展現:瀏覽器

1

熟悉基本組件

Ext JS 有大量的優秀的控件,如今讓咱們開始認識這些基礎的組件吧。服務器

Ext.Button

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

前面代碼的輸出:編輯器

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 。這個用來綁定到計算器顯示的值上。這裏咱們不會分別用一組字段建立模型,此外咱們還將會硬編碼數據。

 

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

總結

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

相關文章
相關標籤/搜索