smarty template engine
Monday, December 01, 2008  
download | documentation | faq | forum | mailing lists | changelog | contribs 


search for in the  


{html_image}

{html_image} является пользовательской функцией, которая создает HTML-тэги для изображений. Высота и ширина автоматически вычислаются из файла изображения, если они не указаны явно.

Имя атрибутаТипОбязателенПо умолчаниюОписание
filestringДаn/aназвание/путь к изображению
heightstringНетреальная высота изображениявысота изображения
widthstringНетреальная ширина изображенияширина изображения
basedirstringНеткорень веб серверапапка, от которой указаны относительные пути
altstringНет""альтернативное описание изображения
hrefstringНетn/aзначение href, куда ссылается картинка
path_prefixstringНет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" />



 

credits 

Smarty Copyright © 2002-2008
New Digital Group, Inc.

All rights reserved.