Select

Provides a form element for a drop-down menu or scrolling selection box.

Properties:

• #options: An associative array, where the keys are the values for each option, and the values are the option labels to be shown in the drop-down list. If a value is an array, it will be rendered similarly, but as an optgroup. The key of the sub-array will be used as the label for the optgroup. Nesting optgroups is not allowed.
• #empty_option: The label that will be displayed to denote no selection.
• #empty_value: The value of the option that is used to denote no selection.

Usage example:

$form['example_select'] = [
  '#type' => 'select',
  '#title' => $this->t('Select element'),
  '#options' => [
    '1' => $this->t('One'),
    '2' => [
      '2.1' => $this->t('Two point one'),
      '2.2' => $this->t('Two point two'),
    ],
    '3' => $this->t('Three'),
  ],
];

Plugin annotation

@FormElement("select")

Hierarchy

• class \Drupal\Component\Plugin\PluginBase implements DerivativeInspectionInterface, PluginInspectionInterface
  • class \Drupal\Core\Plugin\PluginBase uses DependencySerializationTrait, StringTranslationTrait
    • class \Drupal\Core\Render\Element\RenderElement implements ElementInterface
      • class \Drupal\Core\Render\Element\FormElement implements FormElementInterface
        • class \Drupal\Core\Render\Element\Select

File

core/lib/Drupal/Core/Render/Element/Select.php, line 38

Namespace

Drupal\Core\Render\Element

Members