API@RTK0.NET

1. drupal
   1. 4.7
   2. 5 form.inc
   3. 6 form.inc
   4. 7 form.inc

Return a themed form element.

Parameters

$title the form element's title

$value the form element's data

$description the form element's description or explanation

$id the form element's ID used by the <label> tag

$required a boolean to indicate whether this is a required field or not

$error a string with an error message filed against this form element

Return value

a string representing the form element

Related topics

Themeable functions

Functions that display HTML, and which can be customized by themes.

Code

includes/theme.inc, line 622

<?php
function theme_form_element($title, $value, $description = NULL, $id = NULL, $required = FALSE, $error = FALSE) {

  $output  = '<div class="form-item">' . "\n";
  $required = $required ? '<span class="form-required" title="' . t('This field is required.') . '">*</span>' : '';

  if ($title) {
    if ($id) {
      $output .= ' <label for="' . form_clean_id($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 ($description) {
    $output .= ' <div class="description">' . $description . "</div>\n";
  }

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

  return $output;
}
?>