在 Yii 的 CActiveForm 中放置一个小部件会丢失 CActiveForm 功能


Placing a widget within Yii's CActiveForm loses CActiveForm functionality

我在很多很多地方都使用CActiveForm::dropdownList()。为了加快开发速度,我想编写一个小部件来封装所有相关工作。我有一些正确显示但丢失了CActiveForm验证功能的东西。

这是我直接创建下拉列表的方法。 $activeModel是指CActiveForm使用的模型(CActiveRecord)。 $allItems 是用于填充下拉列表的CActiveRecord数组。此代码完美运行。

<div class="row">
    <?php echo $form->labelEx($activeModel, 'keyId'); ?>:
    <?php
    $data = array();
    foreach ($allItems as $Item) {
        $data[$Item->keyId] = CHtml::encode($Item->keyName);
    }
    $options = array(
        'prompt' => 'Select an item',
        'options' => array($activeModel->keyId => array('selected' => true)),
    );
    echo $form->dropDownList($activeModel, 'keyId', $data, $options);
    ?>
    <?php echo $form->error($activeModel, 'keyId'); ?>
</div>

从理论上讲,以下是小部件将如何包含在CActiveForm中:

<div class="row">
    <?php echo $form->labelEx($activeModel, 'keyId'); ?>
    <?php $this->widget('path.to.CustomDropdown', array(
        'form' => $form,
        'items' => $allItems,
        'model' => $activeModel,
        'prompt' => 'Select an item',
        'selected' => true,
    )); ?>
    <?php echo $form->error($activeModel, 'keyId'); ?>
</div>

小部件本身如下所示:

<?php
/**
 * Echoes a populated <select> element
 */
class CustomDropdown extends CWidget {
    public $form;
    public $items = array();
    public $model;
    public $prompt;
    public $selected = false;
    /**
     * @var CActiveForm $form
     * @var CActiveRecord[] $items
     * @var CActiveRecord $model
     * @var string $prompt
     * @var bool $selected (optional)
     */
    public function run() {
        $data = array();
        foreach ($this->items as $Item) {
            $data[$Item->{$Item->tableSchema->primaryKey}] = CHtml::encode($Item->getName());
        }
        $options = array(
            'prompt' => CHtml::encode($this->prompt),
            'options' => (
                $this->selected ? array($this->model->{$Item->tableSchema->primaryKey} => array('selected' => true)) : array()
            ),
        );
        echo $this->form->dropDownList($this->model, $this->model->tableSchema->primaryKey, $data, $options);
    }
}
?>

所有这些都有效,但CActiveForm在下拉列表中丢失了验证功能。具体来说,小部件的$form不会映射到 CActiveForm 的验证数组,因此永远不会向用户显示提交错误。

如何将这种类型的小部件与CActiveForm完全集成,以免丢失任何功能?感谢您的帮助。

从您的示例来看,调用小部件会导致编写比$form->dropDownList()调用更多的代码。我建议简化一些代码片段,并继续使用无小部件解决方案。

为什么需要此代码?

$data = array();
foreach ($allItems as $Item) {
    $data[$Item->keyId] = CHtml::encode($Item->keyName);
}
$options = array(
    'prompt' => 'Select an item',
    'options' => array($activeModel->keyId => array('selected' => true)),
);

你只是在重复CHtml::listData()做的事情。您可以简单地创建如下所示的下拉列表:

echo $form->dropDownList(
    $activeModel,
    'keyId',
    CHtml::listData( MyActiveRecordForDropDown::model()->findAll(), 'valueField', 'textField' ),
    array( 'prompt' => 'Select an item' )
);

并且所选项目将通过模型属性值自动选择。