このマニュアルはSmartyのものです。セキュリティなどの問題でRCMSでは利用できないものもありますので、ご注意ください。
{html_image}
{html_image} は、HTML の <img> タグを作成する カスタム関数 です。 height 属性と width 属性を省略した場合は、画像ファイルから自動的に算出します。
属性名 | 型 | 必須 | デフォルト | 概要 |
---|---|---|---|---|
file | string | Yes | n/a | 画像のパス・ファイル名 |
height | string | No | 実際の画像の高さ | 画像を表示する高さ |
width | string | No | 実際の画像の幅 | 画像を表示する幅 |
basedir | string | no | web サーバのドキュメントルート | 相対パスの基準となるディレクトリ |
alt | string | no | "" | 画像の代替テキスト |
href | string | no | n/a | 画像にリンクする href の値 |
path_prefix | string | no | n/a | 出力パスのプレフィックス |
basedir 属性は、画像の相対パスの基準となるベースディレクトリです。 指定しなかった場合は、web サーバのドキュメントルートである $_ENV['DOCUMENT_ROOT'] を使用します。 $security が有効な場合は、画像のパスは セキュアディレクトリ 内になければなりません。
href は画像にリンクされた href の値です。 これを指定すると、image タグの周りに <a href="LINKVALUE"><a> タグを配置します。
path_prefix には、任意で 出力パスを指定できます。これは、画像を違うサーバに配置したい場合に有効です。
前述の属性リストにないパラメータが与えられた場合は、作成された各 <img> タグの内側に 名前/値 のペアで表されます。
テクニカルノート: {html_image} は、画像を読み込んで幅と高さを取得するため、 ディスクへのアクセスが必要です。テンプレートの キャッシュ を使用しない場合は、{html_image} ではなく静的に image タグを使用するほうがパフォーマンス的にお勧めです。