当表单是基于一个模型时，这种表单在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, 结果如下所示：
