{html_image} - smarty @Wiki

Smartyリファレンス ＞ デザイナーのためのSmarty ＞ カスタム関数

---

{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属性が与えられない場合は、イメージファイルから 自動的に計測されます。

basedir属性は、画像の相対パスの基準となるベースディレクトリです。
この属性が与えられない場合、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" />