Home › API reference › form.inc

theme_form_element

  1. drupal
    1. 4.7 theme.inc
    2. 5
    3. 6 form.inc
    4. 7 form.inc
Versions
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($variables)

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

Form generation
Functions to enable the processing and display of HTML forms.

Code

includes/form.inc, line 1552

<?php
function theme_form_element($element, $value) {
  $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;
}
?>