Yii HTML表單處理


當表單是基於一個模型時,這種表單在Yii中的常見方式是通過 yii\widgets\ActiveForm 類來建立。在大多數情況下,一個表單具有用於資料驗證對應的一個模型。 如果模型代表資料庫中的資料,那麼模型應該從Active Record類派生。如果模型捕捉任意輸入,它應該從 yii\base\Model 類派生。
現在我們建立一個註冊登記表單。
第1步 - 在 models 檔案夾中,建立一個 RegistrationForm.php 檔案並用下面的程式碼。
<?php
   namespace app\models;
   use Yii;
   use yii\base\Model;
   class RegistrationForm extends Model {
      public $username;
      public $password;
      public $email;
      public $subscriptions;
      public $photos;
      /**
      * @return array customized attribute labels
      */
      public function attributeLabels() {
         return [
            'username' => 'Username',
            'password' => 'Password',
            'email' => 'Email',
            'subscriptions' => 'Subscriptions',
            'photos' => 'Photos',
         ];
      }
   }
?>
這裡我們已經宣告註冊登記表單模型有五個屬性 - username, password, email, subscriptions 和 photos。
第2步 - 要顯示此表單,將 actionRegistration 方法新增到 SiteController。
public function actionRegistration() {
   $mRegistration = new RegistrationForm();
   return $this->render('registration', ['model' => $mRegistration]);
} 

我們建立 RegistrationForm 的一個範例,並把它傳遞到registration 檢視。現在,是時候建立一個檢視。

第3步 - 在 views/site 檔案夾中,新增一個 registration.php 檔案並使用下面的程式碼。
<?php
   use yii\bootstrap\ActiveForm;
   use yii\bootstrap\Html;
?>
<div class = "row">
   <div class = "col-lg-5">
      <?php $form = ActiveForm::begin(['id' => 'registration-form']); ?>
      <?= $form->field($model, 'username') ?>
      <?= $form->field($model, 'password')->passwordInput() ?>
      <?= $form->field($model, 'email')->input('email') ?>
      <?= $form->field($model, 'photos[]')->fileInput(['multiple'=>'multiple']) ?>
      <?= $form->field($model, 'subscriptions[]')->checkboxList(['a' => 'Item A',
         'b' => 'Item B', 'c' => 'Item C']) ?>
      <div class = "form-group">
         <?= Html::submitButton('提交', ['class' => 'btn btn-primary',
            'name' => 'registration-button']) ?>
      </div>
      <?php ActiveForm::end(); ?>
   </div>
</div>
我們遵守以下 -
  • ActiveForm::begin() 函式標記表單的開始。所有程式碼都在 ActiveForm::begin() 和 ActiveForm::end() 函式之間包裹著。

  • 要在表單中建立一個欄位,應該呼叫ActiveForm::field()方法。它建立所有的輸入和標籤標籤。輸入名稱會自動決定。

  • 例如,password 屬性將是 RegistrationForm[password]. 如果想要屬性取值為一個陣列,應該追加 [] 到屬性名稱。

第4步 - 如果打Web瀏覽器並在位址列輸入URL=> http://localhost:8080/index.php?r=site/registration, 結果如下所示:

Yii HTML表單處理