Home › API reference › theme.inc

theme_image

  1. drupal
    1. 4.7
    2. 5
    3. 6 theme.inc
    4. 7 theme.inc
Versions
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

Themeable functions
Functions that display HTML, and which can be customized by themes.

Code

includes/theme.inc, line 518

<?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) . '" ' . $image_attributes . $attributes . ' />';
  }
}
?>