Generates a drop-down list.
public static dropDownList ( string $name, string | array | null $selection = null, array $items = [], array $options = [] ) : string | ||
$name | string | the input name |
$selection | string | array | null | the selected value(s). String for single or array for multiple selection(s). |
$items | array | the option data items. The array keys are option values, and the array values are the corresponding option labels. The array can also be nested (i.e. some array values are arrays too). For each sub-array, an option group will be generated whose label is the key associated with the sub-array. If you have a list of data models, you may convert them into the format described above using [[\yii\helpers\ArrayHelper::map()]]. Note, the values and labels will be automatically HTML-encoded by this method, and the blank spaces in the labels will also be HTML-encoded. |
$options | array | the tag options in terms of name-value pairs. The following options are specially handled: - prompt: string, a prompt text to be displayed as the first option. Since version 2.0.11 you can use an array to override the value and to set other tag attributes: ```php ['text' => 'Please select', 'options' => ['value' => 'none', 'class' => 'prompt', 'label' => 'Select']], ``` - options: array, the attributes for the select option tags. The array keys must be valid option values, and the array values are the extra attributes for the corresponding option tags. For example, ```php [ 'value1' => ['disabled' => true], 'value2' => ['label' => 'value 2'], ]; ``` - groups: array, the attributes for the optgroup tags. The structure of this is similar to that of 'options', except that the array keys represent the optgroup labels specified in $items. - encodeSpaces: bool, whether to encode spaces in option prompt and option value with ` ` character. Defaults to false. - encode: bool, whether to encode option prompt and option value characters. Defaults to `true`. This option is available since 2.0.3. The rest of the options will be rendered as the attributes of the resulting tag. The values will be HTML-encoded using [[encode()]]. If a value is null, the corresponding attribute will not be rendered. See [[renderTagAttributes()]] for details on how attributes are being rendered. |
Résultat | string | the generated drop-down list tag |
public function actionGetTypeValues($param, $link_category = false) { if ($link_category) { $params = \app\models\GoodsParams::find()->where('goods_params_name_id=:goods_params_name_id AND link_category=:link_category', [':goods_params_name_id' => $param, ':link_category' => $link_category])->orderBy('sort ASC')->all(); } else { $params = \app\models\GoodsParams::find()->where('goods_params_name_id=:goods_params_name_id', [':goods_params_name_id' => $param])->orderBy('sort ASC')->all(); } $arParams = ['' => ' - Выбрать значение - ']; foreach ($params as $param) { $arParams[$param->id] = $param->value; } print \yii\helpers\BaseHtml::dropDownList('listValues', '', $arParams); }
/** * @inheritdoc */ public static function dropDownList($name, $selection = null, $items = [], $options = []) { Select2Asset::register(\Yii::$app->view); self::addCssClass($options, self::CLASS_SELECT2ME); self::addData($options, 'placeholder', '-'); return parent::dropDownList($name, $selection, $items, $options); }
/** * @inheritdoc */ public static function dropDownList($name, $selection = null, $items = [], $options = []) { if (array_key_exists('select2me', $options) && $options['select2me'] == false) { unset($options['select2me']); } else { Select2Asset::register(\Yii::$app->view); self::addCssClass($options, self::CLASS_SELECT2ME); } self::addData($options, 'placeholder', '-'); return parent::dropDownList($name, $selection, $items, $options); }