1. Home
  2. API reference
  3. CLE 7
  4. form.inc
  5. function form_select_options

function form_select_options

×

Error message

User warning: The following module is missing from the file system: theme/theme. For information about how to fix this, see the documentation page. in _drupal_trigger_error_with_delayed_logging() (line 1156 of /var/www/html/elmsln_community/api.elmsln.org/includes/bootstrap.inc).
cis7 form.inc form_select_options($element, $choices = NULL)
cle7 form.inc form_select_options($element, $choices = NULL)
elmsmedia7 form.inc form_select_options($element, $choices = NULL)
icor7 form.inc form_select_options($element, $choices = NULL)
meedjum_blog7 form.inc form_select_options($element, $choices = NULL)
mooc7 form.inc form_select_options($element, $choices = NULL)

Converts a select form element's options array into HTML.

Parameters

$element: An associative array containing the properties of the element.

$choices: Mixed: Either an associative array of items to list as choices, or an object with an 'option' member that is an associative array. This parameter is only used internally and should not be passed.

Return value

An HTML string of options for the select form element.

Related topics

Form generation
Functions to enable the processing and display of HTML forms.
1 call to form_select_options()
theme_select in includes/form.inc
Returns HTML for a select form element.

File

includes/form.inc, line 2715
Functions for form and batch generation and processing.

Code

function form_select_options($element, $choices = NULL) {
  if (!isset($choices)) {
    $choices = $element['#options'];
  }
  // array_key_exists() accommodates the rare event where $element['#value'] is NULL.
  // isset() fails in this situation.
  $value_valid = isset($element['#value']) || array_key_exists('#value', $element);
  $value_is_array = $value_valid && is_array($element['#value']);
  $options = '';
  foreach ($choices as $key => $choice) {
    if (is_array($choice)) {
      $options .= '<optgroup label="' . $key . '">';
      $options .= form_select_options($element, $choice);
      $options .= '</optgroup>';
    }
    elseif (is_object($choice)) {
      $options .= form_select_options($element, $choice->option);
    }
    else {
      $key = (string) $key;
      if ($value_valid && (!$value_is_array && (string) $element['#value'] === $key || ($value_is_array && in_array($key, $element['#value'])))) {
        $selected = ' selected="selected"';
      }
      else {
        $selected = '';
      }
      $options .= '<option value="' . check_plain($key) . '"' . $selected . '>' . check_plain($choice) . '</option>';
    }
  }
  return $options;
}