| 5 form.inc | theme_select($element) |
| 6 form.inc | theme_select( |
| 7 form.inc | theme_select($variables) |
| 8 form.inc | theme_select($variables) |
Returns HTML for a select form element.
It is possible to group options together; to do this, change the format of $options to an associative array in which the keys are group labels, and the values are associative arrays in the normal $options format.
Parameters
$variables: An associative array containing:
- element: An associative array containing the properties of the element. Properties used: #title, #value, #options, #description, #extra, #multiple, #required, #name, #attributes, #size.
Related topics
File
- includes/
form.inc, line 2626 - Functions for form and batch generation and processing.
Code
function theme_select($variables) {
$element = $variables['element'];
element_set_attributes($element, array('id', 'name', 'size'));
_form_set_class($element, array('form-select'));
return '<select' . drupal_attributes($element['#attributes']) . '>' . form_select_options($element) . '</select>';
}
Comments
'element' must be set in your array
Notice how the argument
$variablesis an associative array where 'element' equals the array of identifiers.This will not work:
print theme_select(array($array));This will work:
print theme_select(array('element' => $array));In general, you should not be
In general, you should not be executing this function directly.
Instead use the theme() function.
<?phpprint theme('select', array('element' => $array));
?>
or use
#type => 'select'within a renderable array.