Zend_View-Helpers-HeadTitle.xml 2.5 KB

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