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

Format a file upload field.

Parameters

$title: The label for the file upload field.

$name: The internal name used to refer to the field.

$size: A measure of the visible size of the field (passed directly to HTML).

$description: Explanatory text to display after the form item.

$required: Whether the user must upload a file to the field.

Return value

A themed HTML string representing the field.

For assistance with handling the uploaded file correctly, see the API provided by file.inc.

Related topics

File

includes/form.inc, line 1154

Code

function theme_file($element) {
  _form_set_class($element, array(
    'form-file',
  ));
  return theme('form_element', $element['#title'], '<input type="file" name="' . $element['#name'] . '"' . ($element['#attributes'] ? ' ' . drupal_attributes($element['#attributes']) : '') . ' id="' . form_clean_id($element['#id']) . '" size="' . $element['#size'] . "\" />\n", $element['#description'], $element['#id'], $element['#required'], form_get_error($element));
}