Generates a check box list for a model attribute.
| public static activeCheckBoxList ( CModel $model, string $attribute, array $data, array $htmlOptions = [] ) : string | ||
| $model | CModel | the data model. |
| $attribute | string | the attribute. |
| $data | array | $data value-label pairs used to generate the check box list. |
| $htmlOptions | array | additional HTML attributes. |
| return | string | the generated list. |
/**
* Renders a checkbox list for a model attribute.
* @param CModel $model the data model.
* @param string $attribute the attribute.
* @param array $data data for generating the list options (value=>display)
* @param array $htmlOptions additional HTML attributes.
* @return string the generated checkbox list.
* @see TbHtml::activeCheckBoxList
*/
public function checkBoxList($model, $attribute, $data, $htmlOptions = array())
{
return TbHtml::activeCheckBoxList($model, $attribute, $data, $htmlOptions);
}
public function testActiveCheckBoxList()
{
// todo: ensure that this test is actually correct.
$I = $this->codeGuy;
$html = TbHtml::activeCheckBoxList(new Dummy(), 'checkboxList', array('Option 1', 'Option 2', 'Option 3'));
$container = $I->createNode($html);
$I->seeNodeChildren($container, array('input[type=hidden]', 'label.checkbox', 'label.checkbox', 'label.checkbox'));
$label = $container->filter('label')->first();
$I->seeNodePattern($label, '/> Option 1$/');
$input = $label->filter('input[type=checkbox]');
$I->seeNodeAttributes($input, array('id' => 'Dummy_checkboxList_0', 'name' => 'Dummy[checkboxList][]', 'value' => '0'));
}
public function testUncheckValueOptionForCheckboxesAndRadioInputs()
{
$I = $this->codeGuy;
$items = array(0);
$model = new Dummy();
$outputsWithHidden = array('checkbox' => TbHtml::checkBox('cb1', false, array('uncheckValue' => 1)), 'checkboxList' => TbHtml::checkBoxList('cb2', 0, $items, array('uncheckValue' => 1)), 'radio' => TbHtml::radioButton('rd1', false, array('uncheckValue' => 1)), 'radioList' => TbHtml::radioButtonList('rd2', 0, $items, array('uncheckValue' => 1)), 'activeCheckbox' => TbHtml::activeCheckBox($model, 'checkboxList'), 'activeCheckboxList' => TbHtml::activeCheckBoxList($model, 'checkboxList', $items), 'activeRadio' => TbHtml::activeRadioButton($model, 'radioList'), 'activeRadioList' => TbHtml::activeRadioButtonList($model, 'radioList', $items));
foreach ($outputsWithHidden as $output) {
$I->seeNodeChildren($I->createNode($output), array('input[type=hidden]'));
}
// comparing against null 'uncheckValue' option
$noHiddenOptions = array('uncheckValue' => null);
$outputsWithoutHidden = array('checkbox' => TbHtml::checkBox('cb1'), 'checkboxList' => TbHtml::checkBoxList('cb2', 0, $items), 'radio' => TbHtml::radioButton('rd1'), 'radioList' => TbHtml::radioButtonList('rd2', 0, $items), 'activeCheckbox' => TbHtml::activeCheckBox($model, 'checkboxList', $noHiddenOptions), 'activeCheckboxList' => TbHtml::activeCheckBoxList($model, 'checkboxList', $items, $noHiddenOptions), 'activeRadio' => TbHtml::activeRadioButton($model, 'radioList', $noHiddenOptions), 'activeRadioList' => TbHtml::activeRadioButtonList($model, 'radioList', $items, $noHiddenOptions));
foreach ($outputsWithoutHidden as $output) {
$I->dontSeeNodeChildren($I->createNode($output), array('input[type=hidden]'));
}
}
