Yii框架官方指南系列19—使用表單：建立表單

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

Yii 提供了幾個助手（helper）類別簡化視圖編寫。例如， 要建立一個文字輸入域，我們可以呼叫 CHtml::textField()；要建立一個下拉列表，則呼叫 CHtml::dropDownList()。

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

CHtml::textField($name,$value,array('submit'=>''));

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

下面，我們使用 CHtml 建立一個登入表單。我們假設變數 $model 是 LoginForm 的實例。

<p>
<?php  echo CHtml::beginForm(); ?>

    <?php  echo CHtml::errorSummary($model); ?>

    </p><p>
        <?php  echo CHtml::activeLabel($model,&#39;username&#39;); ?>
        <?php  echo CHtml::activeTextField($model,&#39;username&#39;) ?>
    </p>

    <p>
        <?php  echo CHtml::activeLabel($model,&#39;password&#39;); ?>
        <?php  echo CHtml::activePasswordField($model,&#39;password&#39;) ?>
    </p>

    <p>
        <?php  echo CHtml::activeCheckBox($model,&#39;rememberMe&#39;); ?>
        <?php  echo CHtml::activeLabel($model,&#39;rememberMe&#39;); ?>
    </p>

    <p>
        <?php  echo CHtml::submitButton(&#39;Login&#39;); ?>
    </p>

<?php  echo CHtml::endForm(); ?>
<!-- form -->

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

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

從版本 1.1.1 開始，提供了一個新的小物件 CActiveForm CActiveForm 。 這個小物件可同時提供客戶端及伺服器端無縫的、一致的驗證。使用 CActiveForm, 上面的程式碼可重寫為：

<p class="form">
<?php $form=$this->beginWidget(&#39;CActiveForm&#39;); ?>

    <?php echo $form->errorSummary($model); ?>

    <p class="row">
        <?php echo $form->label($model,&#39;username&#39;); ?>
        <?php echo $form->textField($model,&#39;username&#39;) ?>
    </p>

    <p class="row">
        <?php echo $form->label($model,&#39;password&#39;); ?>
        <?php echo $form->passwordField($model,&#39;password&#39;) ?>
    </p>

    <p class="row rememberMe">
        <?php echo $form->checkBox($model,&#39;rememberMe&#39;); ?>
        <?php echo $form->label($model,&#39;rememberMe&#39;); ?>
    </p>

    <p class="row submit">
        <?php echo CHtml::submitButton(&#39;Login&#39;); ?>
    </p>

<?php $this->endWidget(); ?>
</p><!-- form -->

以上就是Yii框架官方指南系列19——使用表單：創建表單的內容，更多相關內容請關注PHPcn網絡（www.php. ）！