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

<?xml version="1.0" encoding="UTF-8"?>
<!-- EN-Revision: 24717 -->
<!-- Reviewed: no -->
<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 <varname>$media</varname> vaut <code>screen</code>, mais peut être
        n'importe quelle valeur de média valide. <varname>$conditionalStylesheet</varname> est une chaîne
        ou le booléen <constant>FALSE</constant>, 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. <varname>$extras</varname> 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><methodname>appendAlternate($href, $type, $title, $extras)</methodname></para>
        </listitem>

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

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

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

    <para>
        La méthode <methodname>headLink()</methodname> 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 language="php"><![CDATA[
<?php // régler les liens dans votre script de vue :
$this->headLink()->appendStylesheet('/styles/basic.css')
                 ->headLink(array('rel' => 'icon',
                                  '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>