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

<?xml version="1.0" encoding="UTF-8"?>
<!-- EN-Revision: 19438 -->
<!-- Reviewed: no -->
<sect3 id="zend.view.helpers.initial.headlink">
    <title>HeadLink Helfer</title>

    <para>
        Das HTML <emphasis>&lt;link&gt;</emphasis> Element wird immer mehr für das Verlinken einer
        Vielzahl von Ressourcen der eigenen Site verwendet: Stylesheets, Feeds, FavIcons,
        Trackbacks, und andere. Der <classname>HeadLink</classname> Helfer bietet ein einfaches
        Interface für die Erstellung und das Anhäufen dieser Elemente für das spätere Empfangen und
        deren Ausgabe im eigenen Layout Skript.
    </para>

    <para>
        Der <classname>HeadLink</classname> Helfer hat spezielle Methode für das hinzufügen von
        Stylesheet Links zu seinem Stack:
    </para>

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

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

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

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

    <para>
        Der <varname>$media</varname> Wert ist standardmäßig 'screen', kann aber jeder gültige Media
        Wert sein. <varname>$conditionalStylesheet</varname> ist ein String oder boolsches false und
        wird verwendet um wärend der Darstellung zu erkennen ob spezielle Kommentare inkludiert
        werden sollen um das Laden dieser Stylesheets auf diversen Plattformen zu verhindern.
        <varname>$extras</varname> ist ein Array von extra Werten die man dem Tag hinzufügen will.
    </para>

    <para>
        Zusätzlich hat der <classname>HeadLink</classname> Helfer eine spezielle Methode für das
        Hinzufügen von 'alternativen' (alternate) Links zu seinem Stack:
    </para>

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

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

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

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

    <para>
        Die <methodname>headLink()</methodname> Helfer Methode erlaubt das Spezifizieren aller
        Attribute die für ein <emphasis>&lt;link&gt;</emphasis> Element notwendig sind, und erlaubt
        auch die Spezifizfikation der Platzierung --- entweder ersetzt das neue Element alle
        anderen, wird vorangestellt (an den Beginn des Stacks) , oder angefügt (an das Ende des
        Stacks).
    </para>

    <para>
        Der <classname>HeadLink</classname> Helfer ist eine konkrete Implementation des
        <link linkend="zend.view.helpers.initial.placeholder">Platzhalter Helfers</link>.
    </para>

    <example id="zend.view.helpers.initial.headlink.basicusage">
        <title>Grundsätzliche Verwendung des HeadLink Helfers</title>

        <para>
            <emphasis>headLink</emphasis> kann jederzeit spezifiziert werden. Typischerweise wird
            ein globaler Link im eigenen Layout Skript spezifiziert, und anwendungsspezifische Links
            in den View Skripten der Anwendung. Im Layoutskript, in der &lt;head&gt; Sektion, muß
            das der Helfer ausgegeben werden.
        </para>

        <programlisting language="php"><![CDATA[
<?php // Links in einem View Skript setzen:
$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'));
?>
<?php // Darstellen der Links: ?>
<?php echo $this->headLink() ?>
]]></programlisting>
    </example>
</sect3>
<!--
vim:se ts=4 sw=4 et:
-->