{html_images}
属性名 | 型? | 必須 | デフォルト | 概要 |
file | string? | Yes | n/a | 画像のパス・ファイル名 |
border | string? | No | 0 | 画像の周りの枠のサイズ |
height | string? | No | 実際の画像の高さ | 画像を表示する高さ |
width | string? | No | 実際の画像の幅 | 画像を表示する幅 |
basedir | string? | No | webサーバのドキュメントルート | 相対パスの基準となるディレクトリ |
alt | string? | No | "" | イメージの代替の記述(ALT属性) |
href | string? | No | n/a | 画像にリンクするhrefの値 |
html_imageは、画像のhtmlタグを生成するカスタム関数です。
height属性とwidth属性が与えられない場合は、イメージファイルから 自動的に計測されます。
height属性とwidth属性が与えられない場合は、イメージファイルから 自動的に計測されます。
basedir属性は、画像の相対パスの基準となるベースディレクトリです。
この属性が与えられない場合、webサーバのドキュメントルート(環境変数? DOCUMENT_ROOT?)がベースとして使用されます。
もしsecurityが有効なら、 画像のパスはセキュアディレクトリ内である必要があります。
この属性が与えられない場合、webサーバのドキュメントルート(環境変数? DOCUMENT_ROOT?)がベースとして使用されます。
もしsecurityが有効なら、 画像のパスはセキュアディレクトリ内である必要があります。
href 属性は画像にリンクされたhrefの値です。この属性が与えられると、<a href="LINKVALUE"></a> タグが画像タグの周りに置かれます。
テクニカルノート: html_imageは、画像を読み込んでheightとwidthを計測するための ディスクへのアクセスが必要です。キャッシュを使用しない場合は、 html_imageは避けてイメージタグを静的に用いるのが一般的には 最適なパフォーマンスのためのより良い手段です。
例 8-7. html_image の例
<?php
require('Smarty.class.php');
$smarty = new Smarty;
$smarty->display('index.tpl');
?>
index.tplの一部:
{html_image file="pumpkin.jpg"}
{html_image file="/path/from/docroot/pumpkin.jpg"}
{html_image file="../path/relative/to/currdir/pumpkin.jpg"}
出力:
<img src="pumpkin.jpg" alt="" border="0" width="44" height="68" /> <img src="/path/from/docroot/pumpkin.jpg" alt="" border="0" width="44" height="68" /> <img src="../path/relative/to/currdir/pumpkin.jpg" alt="" border="0" width="44" height="68" />