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] 。如果您希望属性采用一个数组,您应该在属性名称后附加[ ]。
步骤4 - 如果您在Web浏览器的地址栏中输入 http://localhost:8080/index.php?r=site/registration ,您将看到我们的表单。