建立表單

撰寫 login 視圖是很簡單的,我們以一個 form 標記開始,它的 action 屬性應該是前面講述的 login 動作的URL。 然後我們需要為 LoginForm 類別中宣告的屬性插入標籤和表單。最後, 我們插入一個可由使用者點擊提交此表單的提交按鈕。所有這些都可以用純 HTML 程式碼完成。

Yii 提供了幾個輔助類別簡化視圖撰寫。例如, 要建立一個文本輸入,我們可以調用 CHtml::textField(); 要建立一個下拉清單,則調用 CHtml::dropDownList()

訊息: 你可能想知道使用輔助類別的好處,如果它們所需的程式碼量和直接寫純 HTML的 程式碼量相當的話。 答案就是助手可以提供比 HTML 程式碼更多的功能。例如, 如下程式碼將產生一個文字輸入區域,它可以在使用者修改了其值時觸發表單提交動作。


  
  

不然的話你就需要寫一大堆 JavaScript 。

下面,我們使用 CHtml 建立一個登入表單。我們假設變數 $modelLoginForm 的實體。



上述程式碼產生了一個更加動態的表單,例如, CHtml::activeLabel() 產生一個與指定模型的特性相關的標籤。 如果此特性有一個輸入錯誤,此標籤的 CSS class 將變為 error,通過 CSS 樣式改變了標籤的外觀。 相似的, CHtml::activeTextField() 為指定模型的特性產生一個文字輸入區域,並會在錯誤發生時改變它的 CSS class。

如果我們使用由 yiic 腳本提供的 CSS 樣式文件,產生的表單就會像下面這樣:

登入頁

登入頁

含有錯誤訊息的登入頁

含有錯誤訊息的登入頁

從版本 1.1.1 開始,提供了一個新的小工具 CActiveForm 以簡化表單建立。 這個小工具可同時提供客戶端及伺服器端無縫的、一致的驗證。使用 CActiveForm, 上面的程式碼可重寫為:



$Id$