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

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <!-- EN-Revision: 21825 -->
   3 <!-- Reviewed: no -->
   4 <sect3 id="zend.view.helpers.initial.headtitle">
   5     <title>HeadTitle Helfer</title>
   6
   7     <para>
   8         Das <acronym>HTML</acronym> <emphasis>&lt;title&gt;</emphasis> Element wird verwendet um
   9         einen Titel für ein <acronym>HTML</acronym> Dokument anzubieten. Der
  10         <classname>HeadTitle</classname> Helfer erlaubt es Titel für späteren Empfang und Ausgabe
  11         programmtechnisch zu Erstellen und zu Speichern.
  12     </para>
  13
  14     <para>
  15         Der <classname>HeadTitle</classname> Helfer ist eine konkrete Implementation des
  16         <link linkend="zend.view.helpers.initial.placeholder">Plaltzhalter Helfer</link>. Er
  17         überschreibt die <methodname>toString()</methodname> Methode um die erstellung des
  18         <emphasis>&lt;title&gt;</emphasis> Elements zu erzwingen, und fügt eine
  19         <methodname>headTitle()</methodname> Methode für das schnelle und einfache Einstellen und
  20         Ändern von Titel Elementen hinzu. Die Signatur dieser Methode ist
  21         <methodname>headTitle($title, $setType = 'APPEND')</methodname>; standardmäßig, wird der
  22         Wert dem Stack angefügt (Anhäufen von Title Segmenten), aber es kann auch 'PREPEND'
  23         (Platzierung am Anfang des Stacks) oder 'SET' (Stack überschreiben) spezifiziert werden.
  24     </para>
  25
  26     <example id="zend.view.helpers.initial.headtitle.basicusage">
  27         <title>Grundsätzliche Verwendung des HeadTitle Helfers</title>
  28
  29         <para>
  30             Es kann jederzeit ein Titel Tag spezifiziert werden. Die typische Verwendung besteht
  31             darin das Titel Segment bei jedem Level an Tiefe in der Anwendung: Site, Controller,
  32             Aktion und potentiell Ressourcen.
  33         </para>
  34
  35         <programlisting language="php"><![CDATA[
  36 // Setzen des Controller und Aktion Namens als Titel Segment:
  37 $request = Zend_Controller_Front::getInstance()->getRequest();
  38 $this->headTitle($request->getActionName())
  39      ->headTitle($request->getControllerName());
  40
  41 // Setzen der Site im Titel; möglicherweise das Layout Skript:
  42 $this->headTitle('Zend Framework');
  43
  44 // Setzen eines Separator Strings für Segmente:
  45 $this->headTitle()->setSeparator(' / ');
  46 ]]></programlisting>
  47
  48         <para>
  49             Wenn man letztendlich damit fertig ist den Titel im Layoutskript darzustellen, muß
  50             dieser einfach ausgegeben werden:
  51         </para>
  52
  53         <programlisting language="php"><![CDATA[
  54 <!-- Darstellung <action> / <controller> / Zend Framework -->
  55 <?php echo $this->headTitle() ?>
  56 ]]></programlisting>
  57     </example>
  58 </sect3>
  59 <!--
  60 vim:se ts=4 sw=4 et:
  61 -->