theme_image
- Versions
- 4.6
theme_image($path, $alt = '', $title = '',$attr= '', $getsize = true)- 4.7 – 6
theme_image($path,$alt= '',$title= '',$attributes= NULL,$getsize= TRUE)- 7
theme_image($variables)
Return a themed image.
Parameters
$path Either the path of the image file (relative to base_path()) or a full URL.
$alt The alternative text for text-based browsers.
$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.
$getsize If set to TRUE, the image's dimension are fetched and added as width/height attributes.
Return value
A string containing the image tag.
Related topics
Code
includes/theme.inc, line 1211
<?php
function theme_image($path, $alt = '', $title = '', $attributes = NULL, $getsize = TRUE) {
if (!$getsize || (is_file($path) && (list($width, $height, $type, $image_attributes) = @getimagesize($path)))) {
$attributes = drupal_attributes($attributes);
$url = (url($path) == $path) ? $path : (base_path() . $path);
return '<img src="'. check_url($url) .'" alt="'. check_plain($alt) .'" title="'. check_plain($title) .'" '. (isset($image_attributes) ? $image_attributes : '') . $attributes .' />';
}
}
?>
Set $getsize to FALSE on URLs
If you're using theme_image() on a URL instead of a path set $getsize = FALSE or this function won't have a return value.