Same name and namespace in other branches
  1. 4.7.x includes/form.inc \_form_set_class()
  2. 5.x includes/form.inc \_form_set_class()
  3. 6.x includes/form.inc \_form_set_class()

Sets a form element's class attribute.

Adds 'required' and 'error' classes as needed.

Parameters

$element: The form element.

$name: Array of new class names to be added.

Related topics

8 calls to _form_set_class()
theme_checkbox in includes/form.inc
Returns HTML for a checkbox form element.
theme_fieldset in includes/form.inc
Returns HTML for a fieldset form element and its children.
theme_file in includes/form.inc
Returns HTML for a file upload form element.
theme_password in includes/form.inc
Returns HTML for a password form element.
theme_radio in includes/form.inc
Returns HTML for a radio button form element.

... See full list

File

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

Code

function _form_set_class(&$element, $class = array()) {
  if (!empty($class)) {
    if (!isset($element['#attributes']['class'])) {
      $element['#attributes']['class'] = array();
    }
    $element['#attributes']['class'] = array_merge($element['#attributes']['class'], $class);
  }

  // This function is invoked from form element theme functions, but the
  // rendered form element may not necessarily have been processed by
  // form_builder().
  if (!empty($element['#required'])) {
    $element['#attributes']['class'][] = 'required';
  }
  if (isset($element['#parents']) && form_get_error($element) !== NULL && !empty($element['#validated'])) {
    $element['#attributes']['class'][] = 'error';
  }
}