1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
|
<?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><title></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><title></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:
-->
|
