Yii HTML 表单

当一个表单基于一个模型时，在 Yii 中创建这个表单的常用方式是通过 yii\widgets\ActiveForm 类。在大多数情况下，一个表单有一个相应的模型，用于数据验证。如果模型表示来自数据库的数据，则该模型应该派生自 ActiveRecord 类。如果模型捕获任意输入，则应派生自 yii\base\Model 类。

让我们来创建一个注册表单。

步骤1 - 在 models 文件夹中，创建一个名为 RegistrationForm.php 的文件，内容如下。

<?php
   namespace app\models;
   use Yii;
   use yii\base\Model;
   class RegistrationForm extends Model {
      public username;
      publicpassword;
      public email;
      publicsubscriptions;
      public $photos;
      /**
      * @return array customized attribute labels
      */
      public function attributeLabels() {
         return [
            'username' => 'Username',
            'password' => 'Password',
            'email' => 'Email',
            'subscriptions' => 'Subscriptions',
            'photos' => 'Photos',
         ];
      }
   }
?>

我们已经为我们的注册表单声明了一个模型，包括五个属性 – 用户名、密码、电子邮件、订阅和照片。

步骤2 - 要显示此表单，添加 actionRegistration 方法到 SiteController 中。

public function actionRegistration() {
   mRegistration = new RegistrationForm();
   returnthis->render('registration', ['model' => $mRegistration]);
}

我们创建了一个 RegistrationForm 的实例，并将其传递给注册视图。现在，是时候创建一个视图了。

步骤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('Submit', ['class' => 'btn btn-primary',
            'name' => 'registration-button']) ?>
      </div>
      <?php ActiveForm::end(); ?>
   </div>
</div>

我们观察到以下内容−

ActiveForm::begin() 函数标记表单的起始。在 ActiveForm::begin() 和 ActiveForm::end() 函数之间的所有代码将被包裹在标签中。
要在表单中创建一个字段，您应该调用 ActiveForm::field() 方法。它会创建所有的和标签。输入名称将自动确定。
例如， password 属性将为 RegistrationForm[password] 。如果您希望属性采用一个数组，您应该在属性名称后附加[ ]。