What is Smarty?
Why use it?
Use Cases and Work Flow
Syntax Comparison
Template Inheritance
Best Practices
Crash Course
You may use the Smarty logo according to the trademark notice.
For sponsorship, advertising, news or other inquiries, contact us at:
{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" />