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

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <!-- EN-Revision: 21825 -->
   3 <!-- Reviewed: no -->
   4 <sect3 id="zend.view.helpers.initial.headlink">
   5     <title>L'aide de vue HeadLink</title>
   6
   7     <para>
   8         L'élément HTML <code>&lt;link&gt;</code> est de plus en plus employé pour lier
   9         différents types de ressources à votre site : feuilles de styles, syndication, icônes,
  10         trackbacks et d'autres. L'aide <code>HeadLink</code> fournit une interface simple pour créer
  11         et agréger ces éléments pour la récupération postérieure et le rendement dans votre script
  12         d'affichage.
  13     </para>
  14
  15     <para>
  16         L'aide <code>HeadLink</code> possède des méthodes pour ajouter des liens de feuilles
  17         de style dans sa pile :
  18     </para>
  19
  20     <itemizedlist>
  21         <listitem>
  22             <para>
  23                 <code>appendStylesheet($href, $media, $conditionalStylesheet,
  24                 $extras)</code>
  25             </para>
  26         </listitem>
  27
  28         <listitem>
  29             <para>
  30                 <code>offsetSetStylesheet($index, $href, $media, $conditionalStylesheet,
  31                 $extras)</code>
  32             </para>
  33         </listitem>
  34
  35         <listitem>
  36             <para>
  37                 <code>prependStylesheet($href, $media, $conditionalStylesheet,
  38                 $extras)</code>
  39             </para>
  40         </listitem>
  41
  42         <listitem>
  43             <para>
  44                 <code>setStylesheet($href, $media, $conditionalStylesheet,
  45                 $extras)</code>
  46             </para>
  47         </listitem>
  48     </itemizedlist>
  49
  50     <para>
  51         La valeur par défaut de <varname>$media</varname> vaut <code>screen</code>, mais peut être
  52         n'importe quelle valeur de média valide. <varname>$conditionalStylesheet</varname> est une chaîne
  53         ou le booléen <constant>FALSE</constant>, et sera utilisé au moment du rendu pour déterminer si des
  54         commentaires spéciaux doivent être inclus pour empêcher le chargement de la feuille de style
  55         sur certaines plate-formes. <varname>$extras</varname> est un tableau de valeurs supplémentaires
  56         que vous voulez ajouter à la balise.
  57     </para>
  58
  59     <para>
  60         De plus, l'aide <code>HeadLink</code> possède des méthodes pour ajouter des liens
  61         alternatifs dans sa pile :
  62     </para>
  63
  64     <itemizedlist>
  65         <listitem>
  66             <para><methodname>appendAlternate($href, $type, $title, $extras)</methodname></para>
  67         </listitem>
  68
  69         <listitem>
  70             <para><methodname>offsetSetAlternate($index, $href, $type, $title, $extras)</methodname></para>
  71         </listitem>
  72
  73         <listitem>
  74             <para><methodname>prependAlternate($href, $type, $title, $extras)</methodname></para>
  75         </listitem>
  76
  77         <listitem>
  78             <para><methodname>setAlternate($href, $type, $title, $extras)</methodname></para>
  79         </listitem>
  80     </itemizedlist>
  81
  82     <para>
  83         La méthode <methodname>headLink()</methodname> de l'aide permet de spécifier tous les attributs
  84         nécessaires à un élément <code>&lt;link&gt;</code>, et vous permet aussi de préciser
  85         l'emplacement - le nouvel élément peut remplacer tous les autres, s'ajouter au début ou à la
  86         fin de la liste.
  87     </para>
  88
  89     <para>
  90         L'aide <code>HeadLink</code> est une implémentation concrète de l'aide <link
  91         linkend="zend.view.helpers.initial.placeholder">Placeholder</link>.
  92     </para>
  93
  94     <example id="zend.view.helpers.initial.headlink.basicusage">
  95         <title>Utilisation basique de l'aide HeadLink</title>
  96
  97         <para>
  98             Vous pouvez spécifier un <code>headLink</code> à n'importe quel moment.
  99             Typiquement, vous pouvez spécifier des liens globaux dans votre script de disposition,
 100             et des liens spécifiques à l'application dans vos scripts de vue. Dans votre script de
 101             disposition, dans la section <code>&lt;head&gt;</code>, vous pourrez ensuite afficher le
 102             résultat de l'aide.
 103         </para>
 104
 105         <programlisting language="php"><![CDATA[
 106 <?php // régler les liens dans votre script de vue :
 107 $this->headLink()->appendStylesheet('/styles/basic.css')
 108                  ->headLink(array('rel' => 'favicon',
 109                                   'href' => '/img/favicon.ico'),
 110                             'PREPEND')
 111                  ->prependStylesheet('/styles/moz.css',
 112                                      'screen',
 113                                      true,
 114                                      array('id' => 'my_stylesheet'));
 115 ?>
 116
 117 <!-- effectuer le rendu -->
 118 <?php echo $this->headLink() ?>
 119 ]]></programlisting>
 120     </example>
 121 </sect3>