- drupal
- 5
- 6
- 7
- 8
Returns HTML for an image.
Parameters
$variables
An associative array containing:
- path: Either the path of the image file (relative to base_path()) or a
full URL.
- width: The width of the image (if known).
- height: The height of the image (if known).
- alt: The alternative text for text-based browsers. HTML 4 and XHTML 1.0
always require an alt attribute. The HTML 5 draft allows the alt
attribute to be omitted in some cases. Therefore, this variable defaults
to an empty string, but can be set to NULL for the attribute to be
omitted. Usually, neither omission nor an empty string satisfies
accessibility requirements, so it is strongly encouraged for code calling
theme('image') to pass a meaningful value for this variable.
- title: The title text is displayed when the image is hovered in some
popular browsers.
- attributes: Associative array of attributes to be placed in the img tag.
Related topics
- Default theme implementations
- Functions and templates for the user interface to be implemented by themes.
Code
includes/theme.inc, line 1521
<?php
function theme_image($variables) {
$attributes = $variables['attributes'];
$attributes['src'] = file_create_url($variables['path']);
foreach (array('width', 'height', 'alt', 'title') as $key) {
if (isset($variables[$key])) {
$attributes[$key] = $variables[$key];
}
}
return '<img' . drupal_attributes($attributes) . ' />';
}
?>