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

   1 <sect3 id="zend.view.helpers.initial.headlink">
   2     <title>Helper HeadLink</title>
   3
   4     <para>
   5         Element HTML <code>&lt;link&gt;</code> jest używany do dołączania różnego
   6         rodzaju zasobów do dokumentu html: arkuszy stylów, kanałów informacyjnych,
   7         ikon, adresów trackback i wielu innych. Helper <code>HeadLink</code>
   8         zapewnia prosty interfejs służący do tworzenia i łączenia tych
   9         elementów, a następnie do wyświetlenia ich później w skrypcie layoutu.
  10     </para>
  11
  12     <para>
  13         Helper <code>HeadLink</code> posiada specjalne metody do dodawania
  14         arkuszy stylów:
  15     </para>
  16
  17     <itemizedlist>
  18         <listitem><para><code>appendStylesheet($href, $media,
  19                     $conditionalStylesheet)</code></para></listitem>
  20         <listitem><para><code>offsetSetStylesheet($index, $href, $media,
  21                     $conditionalStylesheet)</code></para></listitem>
  22         <listitem><para><code>prependStylesheet($href, $media,
  23                     $conditionalStylesheet)</code></para></listitem>
  24         <listitem><para><code>setStylesheet($href, $media,
  25                     $conditionalStylesheet)</code></para></listitem>
  26     </itemizedlist>
  27
  28     <para>
  29         Domyślną wartością zmiennej <code>$media</code> jest 'screen', jednak
  30         możemy nadać jej inną poprawną wartość. Zmienna
  31         <code>$conditionalStylesheet</code> jest wartością logiczną określającą
  32         czy podczas renderowania powinien zostać dodany specjalny komentarz
  33         zapobiegający ładowaniu arkusza stylów na określonych platformach.
  34     </para>
  35
  36     <para>
  37         Dodatkowo helper <code>HeadLink</code> posiada specjalne metody
  38         do obsługi łącz 'alternate':
  39     </para>
  40
  41     <itemizedlist>
  42         <listitem><para><code>appendAlternate($href, $type,
  43                     $title)</code></para></listitem>
  44         <listitem><para><code>offsetSetAlternate($index, $href, $type,
  45                     $title)</code></para></listitem>
  46         <listitem><para><code>prependAlternate($href, $type,
  47                     $title)</code></para></listitem>
  48         <listitem><para><code>setAlternate($href, $type,
  49                     $title)</code></para></listitem>
  50     </itemizedlist>
  51
  52     <para>
  53         Metoda <code>headLink()</code> helpera pozwala na określenie wszystkich
  54         potrzebnych atrybutów elementu <code>&lt;link&gt;</code>, a także
  55         pozwala określić jego umiejscowienie -- czy nowy element ma zastąpić
  56         wszystkie istniejące, dołączyć go na koniec lub na początek stosu.
  57     </para>
  58
  59     <para>
  60         Helper <code>HeadLink</code> jest implementacją
  61         <link linkend="zend.view.helpers.initial.placeholder">helpera
  62             Placeholder</link>.
  63     </para>
  64
  65     <example id="zend.view.helpers.initial.headlink.basicusage">
  66         <title>Proste użycie helpera HeadLink</title>
  67
  68         <para>
  69             Możesz użyć helpera <code>headLink</code> w dowolnym momencie.
  70             Najczęściej będziesz określał globalne łącza w pliku layoutu,
  71             a łącza specyficzne dla aplikacji w skryptach widoków. W skrypcie
  72             layoutu wyświetlisz na koniec wszystkie łącza w sekcji
  73             &lt;head&gt;.
  74         </para>
  75
  76         <programlisting role="php"><![CDATA[
  77 <?php // ustawianie łącz w skrypcie widoku:
  78 $this->headLink()->appendStylesheet('/styles/basic.css')
  79                  ->headLink(array('rel' => 'favicon',
  80                                   'href' => '/img/favicon.ico'),
  81                                   'PREPEND')
  82                  ->prependStylesheet('/styles/moz.css', 'screen', true);
  83 ?>
  84 <?php // generowaie łącz: ?>
  85 <?= $this->headLink() ?>
  86 ]]>
  87         </programlisting>
  88     </example>
  89 </sect3>