{html_image} является пользовательской функцией, которая создает HTML-тэги для изображений. Высота и ширина автоматически вычислаются из файла изображения, если они не указаны явно.
| Имя атрибута | Тип | Обязателен | По умолчанию | Описание |
|---|---|---|---|---|
| file | string | Да | n/a | название/путь к изображению |
| height | string | Нет | реальная высота изображения | высота изображения |
| width | string | Нет | реальная ширина изображения | ширина изображения |
| basedir | string | Нет | корень веб сервера | папка, от которой указаны относительные пути |
| alt | string | Нет | "" | альтернативное описание изображения |
| href | string | Нет | n/a | значение href, куда ссылается картинка |
| path_prefix | string | Нет | n/a | префикс пути результата |
basedir - базовая папка для относительных путей. Если не указана, то используется корень веб сервер (переменная окружения DOCUMENT_ROOT). Если $security включено, то путь к файлу изображения должен быть в пределах безопасной директории.
Атрибут link указывает, куда ссылается изображение. Атрибут link устанавливает значение атрибута href тэга А. Если указан атрибут link, то изображение окружается выражениями <a href="LINKVALUE"> и <a>.
path_prefix - это необязательный префикс, который
вы можете добавить к пути результата
Это удобно в случае, если вы хотите передать другое серверное имя для
изображения.
Все параметры, которые не указаны в списке, выводятся в виде пар name/value в каждом созданном тэге <input>.
Техническое Замечание
{html_image} требует обращение к диску для чтения изображения и вычисления его размеров. Если не используется кэширование шаблонов, то тэг {html_image} лучше не использовать, а вставлять статичные тэги изображений для достижения оптимального быстродействия.
Пример 8.11. Пример работы html_image
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="" width="44" height="68" /> <img src="/path/from/docroot/pumpkin.jpg" alt="" width="44" height="68" /> <img src="../path/relative/to/currdir/pumpkin.jpg" alt="" width="44" height="68" />