Render a select box input given a set of data. Supported keys
are:
- name - Set the input name.
- options - An array of options.
- disabled - Either true or an array of options to disable.
When true, the select element will be disabled.
- val - Either a string or an array of options to mark as selected.
- empty - Set to true to add an empty option at the top of the
option elements. Set to a string to define the display text of the
empty option. If an array is used the key will set the value of the empty
option while, the value will set the display text.
- escape - Set to false to disable HTML escaping.
### Options format
The options option can take a variety of data format depending on
the complexity of HTML you want generated.
You can generate simple options using a basic associative array:
'options' => ['elk' => 'Elk', 'beaver' => 'Beaver']
If you need to define additional attributes on your option elements
you can use the complex form for options:
'options' => [
['value' => 'elk', 'text' => 'Elk', 'data-foo' => 'bar'],
]
This form **requires** that both the value and text keys be defined.
If either is not set options will not be generated correctly.
If you need to define option groups you can do those using nested arrays:
'options' => [
'Mammals' => [
'elk' => 'Elk',
'beaver' => 'Beaver'
]
]
And finally, if you need to put attributes on your optgroup elements you
can do that with a more complex nested array form:
'options' => [
[
'text' => 'Mammals',
'data-id' => 1,
'options' => [
'elk' => 'Elk',
'beaver' => 'Beaver'
]
],
]
You are free to mix each of the forms in the same option set, and
nest complex types as required.
