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

<?xml version="1.0" encoding="UTF-8"?>
<!-- EN-Revision: 21825 -->
<!-- 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 = 'APPEND')</methodname>; standardmäßig, wird der
        Wert dem Stack angefügt (Anhäufen von Title Segmenten), aber es kann auch 'PREPEND'
        (Platzierung am Anfang des Stacks) oder 'SET' (Stack überschreiben) spezifiziert werden.
    </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:
-->