theme_form_element

• Drupal 4.6
• Drupal 4.7
• Drupal 5
• Drupal 6
• Drupal 7

includes/form.inc, line 2190

Versions

4.6 – 4.7

theme_form_element($title, $value, $description = NULL, $id = NULL, $required = FALSE, $error = FALSE)

5 – 6

theme_form_element($element, $value)

7

theme_form_element($element)

Return a themed form element.

Parameters

element An associative array containing the properties of the element. Properties used: title, description, id, required

$value The form element's data.

Return value

A string representing the form element.

Related topics

Default theme implementations

Functions and templates that present output to the user, and can be implemented by themes.

Form generation

Functions to enable the processing and display of HTML forms.

Code

<?php
function theme_form_element($element, $value) {
  // This is also used in the installer, pre-database setup.
  $t = get_t();

  $output = '<div class="form-item"';
  if (!empty($element['#id'])) {
    $output .= ' id="'. $element['#id'] .'-wrapper"';
  }
  $output .= ">\n";
  $required = !empty($element['#required']) ? '<span class="form-required" title="'. $t('This field is required.') .'">*</span>' : '';

  if (!empty($element['#title'])) {
    $title = $element['#title'];
    if (!empty($element['#id'])) {
      $output .= ' <label for="'. $element['#id'] .'">'. $t('!title: !required', array('!title' => filter_xss_admin($title), '!required' => $required)) ."</label>\n";
    }
    else {
      $output .= ' <label>'. $t('!title: !required', array('!title' => filter_xss_admin($title), '!required' => $required)) ."</label>\n";
    }
  }

  $output .= " $value\n";

  if (!empty($element['#description'])) {
    $output .= ' <div class="description">'. $element['#description'] ."</div>\n";
  }

  $output .= "</div>\n";

  return $output;
}
?>