theme_form_element
- 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($variables)
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
Code
includes/theme.inc, line 621
<?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;
}
?>