简述
当表单基于模型时,在 Yii 中创建此表单的常用方法是通过 yii \widgets\ActiveForm类。在大多数情况下,表单都有一个用于数据验证的相应模型。如果模型表示来自数据库的数据,则该模型应派生自ActiveRecord类。如果模型捕获任意输入,它应该派生自yii\base\Model类。
让我们创建一个注册表单。
第 1 步- 在模型文件夹中,使用以下代码创建一个名为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',
];
}
}
?>
我们已经为我们的注册表单声明了一个模型,它有五个属性——用户名、密码、电子邮件、订阅和照片。
第 2 步 - 要显示此表单,请将actionRegistration方法添加到SiteController。
public function actionRegistration() {
$mRegistration = new RegistrationForm();
return $this->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()方法。它创建所有输入和标签标签。输入名称是自动确定的。
-
例如,密码属性将为RegistrationForm[password]。如果您希望属性采用数组,则应将 [ ] 附加到属性名称。
第 4 步- 如果您转到 Web 浏览器的地址栏并输入http://localhost:8080/index.php?r=site/registration,您将看到我们的表单。