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

<!-- EN-Revision: 14385 -->
<sect3 id="zend.view.helpers.initial.headlink">
    <title>L'aide de vue HeadLink</title>

    <para>L'élément HTML <code>&lt;link&gt;</code> est de plus en plus employé pour lier différents types de ressources
    à votre site : feuilles de styles, syndication, icônes, trackbacks et d'autres. L'aide <code>HeadLink</code> fournit
    une interface simple pour créer et agréger ces éléments pour la récupération postérieure et le rendement dans votre
    script d'affichage.</para>

    <para>L'aide <code>HeadLink</code> possède des méthodes pour ajouter des liens de feuilles de style dans sa pile
    :</para>

    <itemizedlist>
        <listitem>
            <para><code>appendStylesheet($href, $media, $conditionalStylesheet, $extras)</code></para>
        </listitem>

        <listitem>
            <para><code>offsetSetStylesheet($index, $href, $media, $conditionalStylesheet, $extras)</code></para>
        </listitem>

        <listitem>
            <para><code>prependStylesheet($href, $media, $conditionalStylesheet, $extras)</code></para>
        </listitem>

        <listitem>
            <para><code>setStylesheet($href, $media, $conditionalStylesheet, $extras)</code></para>
        </listitem>
    </itemizedlist>

    <para>La valeur par défaut de <code>$media</code> vaut <code>screen</code>, mais peut être n'importe quelle valeur
    de média valide. <code>$conditionalStylesheet</code> est une chaîne ou le booléen <code>false</code>, et sera
    utilisé au moment du rendu pour déterminer si des commentaires spéciaux doivent être inclus pour empêcher le
    chargement de la feuille de style sur certaines plate-formes. <code>$extras</code> est un tableau de valeurs
    supplémentaires que vous voulez ajouter à la balise.</para>

    <para>De plus, l'aide <code>HeadLink</code> possède des méthodes pour ajouter des liens alternatifs dans sa pile
    :</para>

    <itemizedlist>
        <listitem>
            <para><code>appendAlternate($href, $type, $title, $extras)</code></para>
        </listitem>

        <listitem>
            <para><code>offsetSetAlternate($index, $href, $type, $title, $extras)</code></para>
        </listitem>

        <listitem>
            <para><code>prependAlternate($href, $type, $title, $extras)</code></para>
        </listitem>

        <listitem>
            <para><code>setAlternate($href, $type, $title, $extras)</code></para>
        </listitem>
    </itemizedlist>

    <para>La méthode <code>headLink()</code> de l'aide permet de spécifier tous les attributs nécessaires à un élément
    <code>&lt;link&gt;</code>, et vous permet aussi de préciser l'emplacement - le nouvel élément peut remplacer tous
    les autres, s'ajouter au début ou à la fin de la liste.</para>

    <para>L'aide <code>HeadLink</code> est une implémentation concrète de l'aide <link
    linkend="zend.view.helpers.initial.placeholder">Placeholder</link>.</para>

    <example id="zend.view.helpers.initial.headlink.basicusage">
        <title>Utilisation basique de l'aide HeadLink</title>

        <para>Vous pouvez spécifier un <code>headLink</code> à n'importe quel moment. Typiquement, vous pouvez spécifier
        des liens globaux dans votre script de disposition, et des liens spécifiques à l'application dans vos scripts de
        vue. Dans votre script de disposition, dans la section <code>&lt;head&gt;</code>, vous pourrez ensuite afficher
        le résultat de l'aide.</para>

        <programlisting role="php"><![CDATA[
<?php // régler les liens dans votre script de vue :
$this->headLink()->appendStylesheet('/styles/basic.css')
                 ->headLink(array('rel' => 'favicon',
                                  'href' => '/img/favicon.ico'),
                            'PREPEND')
                 ->prependStylesheet('/styles/moz.css',
                                     'screen',
                                     true,
                                     array('id' => 'my_stylesheet'));
?>

<!-- effectuer le rendu -->
<?php echo $this->headLink() ?>
]]></programlisting>
    </example>
</sect3>