Same name and namespace in other branches
  1. 4.7.x includes/form.inc \theme_file()
  2. 5.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 2304

Code

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