{html_image}

{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} лучше не использовать, а вставлять статичные тэги изображений для достижения оптимального быстродействия.

Example 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" />