documentation/manual/ru/module_specs/Zend_View-Helpers-HeadLink.xml

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <!-- Reviewed: no -->
   3 <sect3 id="zend.view.helpers.initial.headlink">
   4     <title>Помощник HeadLink</title>
   5
   6     <para>
   7         HTML-элемент <code>&lt;link&gt;</code> все чаще используется для
   8         создания связей с различными ресурсами - таблицами стилей,
   9         лентами новостей, пиктограммами (favicon), обратными ссылками (trackback)
  10         и многим другим.
  11         Помощник <code>HeadLink</code> предоставляет простой интерфейс
  12         для создания и агрегирования этих элементов с целью последующего
  13         извлечения и вывода в вашем скрипте макета (layout script).
  14     </para>
  15
  16     <para>
  17         Помощник <code>HeadLink</code> имеет специальные методы для добавления
  18         таблиц стилей в его стек:
  19     </para>
  20
  21     <itemizedlist>
  22         <listitem><para><code>appendStylesheet($href, $media,
  23                     $conditionalStylesheet, $extras)</code></para></listitem>
  24         <listitem><para><code>offsetSetStylesheet($index, $href, $media,
  25                     $conditionalStylesheet, $extras)</code></para></listitem>
  26         <listitem><para><code>prependStylesheet($href, $media,
  27                     $conditionalStylesheet, $extras)</code></para></listitem>
  28         <listitem><para><code>setStylesheet($href, $media,
  29                     $conditionalStylesheet, $extras)</code></para></listitem>
  30     </itemizedlist>
  31
  32     <para>
  33         По умолчанию аргумент <varname>$media</varname> имеет значение 'screen',
  34         но через него могут передаваться и другие допустимые значения атрибута
  35         media. <varname>$conditionalStylesheet</varname> может быть либо
  36         строкой, либо иметь булево значение false, он используется
  37         для определения того, требуется ли использовать специальные
  38         комментарии для предотвращения загрузки данной таблицы стилей на
  39         определенных платформах.
  40         <varname>$extras</varname> является массивом дополнительных атрибутов,
  41         которые вы хотите добавить в элемент.
  42     </para>
  43
  44     <para>
  45         Помощник <code>HeadLink</code> также имеет специальные методы
  46         для добавления альтернативных связей в его стек:
  47     </para>
  48
  49     <itemizedlist>
  50         <listitem><para><code>appendAlternate($href, $type,
  51                     $title, $extras)</code></para></listitem>
  52         <listitem><para><code>offsetSetAlternate($index, $href, $type,
  53                     $title, $extras)</code></para></listitem>
  54         <listitem><para><code>prependAlternate($href, $type,
  55                     $title, $extras)</code></para></listitem>
  56         <listitem><para><code>setAlternate($href, $type,
  57                     $title, $extras)</code></para></listitem>
  58     </itemizedlist>
  59
  60     <para>
  61         Метод <code>headLink()</code> позволяет указывать все
  62         атрибуты, необходимые для элемента <code>&lt;link&gt;</code>,
  63         он также позволяет указывать место размещения -
  64         новый элемент либо замещает все остальные элементы, либо добавляется в
  65         начало/конец стека.
  66     </para>
  67
  68     <para>
  69         Помощник <code>HeadLink</code> является частной реализацией
  70         <link linkend="zend.view.helpers.initial.placeholder">помощника
  71             Placeholder</link>.
  72     </para>
  73
  74     <example id="zend.view.helpers.initial.headlink.basicusage">
  75         <title>Использование помощника HeadLink</title>
  76
  77         <para>
  78             Вы можете указывать <code>headLink</code> в любой момент времени.
  79             Глобальные ссылки обычно указываются в скрипте макета,
  80             а специальные (для отдельных страниц) - в скриптах вида.
  81             В вашем скрипте макета, в разделе &lt;head&gt;, вы "выводите"
  82             помощника, при этом будут выведены ссылки, которые вы добавили
  83             ранее.
  84         </para>
  85
  86         <programlisting language="php"><![CDATA[
  87 <?php // установка ссылок в скрипте вида:
  88 $this->headLink()->appendStylesheet('/styles/basic.css')
  89                  ->headLink(array('rel' => 'favicon',
  90                                   'href' => '/img/favicon.ico'),
  91                                   'PREPEND')
  92                  ->prependStylesheet('/styles/moz.css',
  93                                      'screen',
  94                                      true,
  95                                      array('id' => 'my_stylesheet'));
  96 ?>
  97 <?php // вывод ссылок: ?>
  98 <?php echo $this->headLink() ?>
  99 ]]></programlisting>
 100     </example>
 101 </sect3>
 102 <!--
 103 vim:se ts=4 sw=4 et:
 104 -->