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

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

    <para>
        Das <acronym>HTML</acronym> <emphasis>&lt;title&gt;</emphasis> Element wird verwendet um
        einen Titel für ein <acronym>HTML</acronym> Dokument anzubieten. Der
        <classname>HeadTitle</classname> Helfer erlaubt es Titel für späteren Empfang und Ausgabe
        programmtechnisch zu Erstellen und zu Speichern.
    </para>

    <para>
        Der <classname>HeadTitle</classname> Helfer ist eine konkrete Implementation des
        <link linkend="zend.view.helpers.initial.placeholder">Plaltzhalter Helfer</link>. Er
        überschreibt die <methodname>toString()</methodname> Methode um die Erstellung des
        <emphasis>&lt;title&gt;</emphasis> Elements zu erzwingen, und fügt eine
        <methodname>headTitle()</methodname> Methode für das schnelle und einfache Einstellen und
        Ändern von Titel Elementen hinzu. Die Signatur dieser Methode ist
        <methodname>headTitle($title, $setType = null)</methodname>; standardmäßig, wird der
        Wert dem Stack angefügt (Anhäufen von Title Segmenten) wenn er auf null belassen wird, aber
        es kann auch 'PREPEND' (Platzierung am Anfang des Stacks) oder 'SET' (Stack überschreiben)
        spezifiziert werden.
    </para>

    <para>
        Da das Setzen der weiteren (angehängten) Reihenfolge bei jedem Aufruf von
        <methodname>headTitle</methodname> nervend sein kann, kann man eine standardmäßige
        weitere Reihenfolge setzen indem <methodname>setDefaultAttachOrder()</methodname> aufgerufen
        wird, welche bei allen Aufrufen von <methodname>headTitle()</methodname> angewendet wird
        solange man nicht eine andere Reihenfolge explizit als zweiten Parameter übergibt.
    </para>

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

        <para>
            Es kann jederzeit ein Titel Tag spezifiziert werden. Die typische Verwendung besteht
            darin das Titel Segment bei jedem Level an Tiefe in der Anwendung: Site, Controller,
            Aktion und potentiell Ressourcen.
        </para>

        <programlisting language="php"><![CDATA[
// Setzen des Controller und Aktion Namens als Titel Segment:
$request = Zend_Controller_Front::getInstance()->getRequest();
$this->headTitle($request->getActionName())
     ->headTitle($request->getControllerName());

// Setzen der Site im Titel; möglicherweise das Layout Skript:
$this->headTitle('Zend Framework');

// Setzen eines Separator Strings für Segmente:
$this->headTitle()->setSeparator(' / ');
]]></programlisting>

        <para>
            Wenn man letztendlich damit fertig ist den Titel im Layoutskript darzustellen, muß
            dieser einfach ausgegeben werden:
        </para>

        <programlisting language="php"><![CDATA[
<!-- Darstellung <action> / <controller> / Zend Framework -->
<?php echo $this->headTitle() ?>
]]></programlisting>
    </example>
</sect3>
<!--
vim:se ts=4 sw=4 et:
-->