smarty/docs/ru/designers/language-custom-functions/language-function-html-image.xml

<?xml version="1.0" encoding="UTF-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 0 Maintainer: freespace Status: ready -->
<sect1 id="language.function.html.image">
 <title>{html_image}</title>
 <para>
  {html_image} является
  <link linkend="language.custom.functions">пользовательской функцией</link>,
  которая создает HTML-тэги для изображений. Высота и ширина автоматически
  вычислаются из файла изображения, если они не указаны явно.
 </para>
 
 <informaltable frame="all">
  <tgroup cols="5">
  <colspec colname="param" align="center" />
  <colspec colname="type" align="center" />
  <colspec colname="required" align="center" />
  <colspec colname="default" align="center" />
  <colspec colname="desc" />
  <thead>
   <row>
    <entry>Имя атрибута</entry>
    <entry>Тип</entry>
    <entry>Обязателен</entry>
    <entry>По умолчанию</entry>
    <entry>Описание</entry>
   </row>
  </thead>
  <tbody>
   <row>
    <entry>file</entry>
    <entry>string</entry>
    <entry>Да</entry>
    <entry><emphasis>n/a</emphasis></entry>
    <entry>название/путь к изображению</entry>
   </row>
   <row>
    <entry>height</entry>
    <entry>string</entry>
    <entry>Нет</entry>
    <entry><emphasis>реальная высота изображения</emphasis></entry>
    <entry>высота изображения</entry>
   </row>
   <row>
    <entry>width</entry>
    <entry>string</entry>
    <entry>Нет</entry>
    <entry><emphasis>реальная ширина изображения</emphasis></entry>
    <entry>ширина изображения</entry>
   </row>
   <row>
    <entry>basedir</entry>
    <entry>string</entry>
    <entry>Нет</entry>
    <entry><emphasis>корень веб сервера</emphasis></entry>
    <entry>папка, от которой указаны относительные пути</entry>
   </row>
   <row>
    <entry>alt</entry>
    <entry>string</entry>
    <entry>Нет</entry>
    <entry><emphasis>""</emphasis></entry>
    <entry>альтернативное описание изображения</entry>
   </row>
   <row>
    <entry>href</entry>
    <entry>string</entry>
    <entry>Нет</entry>
    <entry><emphasis>n/a</emphasis></entry>
    <entry>значение href, куда ссылается картинка</entry>
   </row>
   <row>
    <entry>path_prefix</entry>
    <entry>string</entry>
    <entry>Нет</entry>
    <entry><emphasis>n/a</emphasis></entry>
    <entry>префикс пути результата</entry>
   </row>
  </tbody>
  </tgroup>
 </informaltable>

 <para>
  basedir - базовая папка для относительных путей. Если не указана,
  то используется корень веб сервер
  (<link linkend="language.variables.smarty">переменная окружения</link> DOCUMENT_ROOT).
  Если <link linkend="variable.security">$security</link> включено, то путь к
  файлу изображения должен быть в пределах безопасной директории.
 </para>
 <para>
  Атрибут link указывает, куда ссылается изображение. Атрибут
  link устанавливает значение атрибута href тэга А. Если указан
  атрибут link, то изображение окружается выражениями &lt;a
  href="LINKVALUE"&gt; и &lt;a&gt;.
 </para>
 <para>
  <parameter>path_prefix</parameter> - это необязательный префикс, который
  вы можете добавить к пути результата
  Это удобно в случае, если вы хотите передать другое серверное имя для
  изображения.
 </para>
 <para>
  Все параметры, которые не указаны в списке, выводятся в виде
  пар name/value в каждом созданном тэге &lt;input&gt;.
 </para>
 <note>
  <title>Техническое Замечание</title>
  <para>
   {html_image} требует обращение к диску для чтения изображения
   и вычисления его размеров. Если не используется
   <link linkend="caching">кэширование</link> шаблонов,
   то тэг {html_image} лучше не использовать, а вставлять статичные тэги
   изображений для достижения оптимального быстродействия.
  </para>
 </note>
 <example>
  <title>Пример работы html_image</title>
  <programlisting>
<![CDATA[
index.tpl:
-------------------
{html_image file='pumpkin.jpg'}
{html_image file='/path/from/docroot/pumpkin.jpg'}
{html_image file='../path/relative/to/currdir/pumpkin.jpg'}
]]>
  </programlisting>
  <para>
    Возможный результат обработки шаблона:
  </para>
  <screen>
<![CDATA[
<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" />
]]>
  </screen>
 </example>
</sect1>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->