Placeholder View Helfer wird verwendet um Inhalte zwischen View Skripten
und View Instanzen persistent zu machen. Er bietet auch einige nützliche Features wie
Inhalte zu vereinigen, Inhalte von View Skripten zu erfassen und Vor- sowie Nach-Texte zu
Inhalten hinzuzufügen (und eigene Separatoren für vereinigte Inhalte).
Placeholder Helfers erwartet einen Platzhalter Namen; der Helfer
gibt dann ein Platzhalter Container Objekt zurück das entweder manipuliert oder einfach
ausgegeben werden kann.
Placeholder View Helfer verwendet Container die
ArrayObject erweitern, und ein reichhaltiges Set von Features für die
Manipulation von Arrays bieten. Zusätzlich bietet es eine Anzahl von Methoden für die
Formatierung des Inhalts der im Container gespeichert ist:
setPrefix($prefix) setzt Text der dem Inhalt vorgesetzt wird.
getPrefix() kann verwendet werden um jederzeit festzustellen wie
die aktuellen Einstellungen sind.
setPostfix($prefix) setzt Text der dem Inhalt angehängt wird.
getPostfix() kann verwendet werden um jederzeit festzustellen wie
die aktuellen Einstellungen sind.
setSeparator($prefix) setzt Text mit dem zusammengefügte Inhalte
seperiert werden. getSeparator() kann verwendet werden um jederzeit
festzustellen wie die aktuellen Einstellungen sind.
setIndent($prefix) kann verwendet werden um einen Markierungswert
für den Inhalt zu setzen. Wenn ein Integer übergeben wird, wird diese Anzahl an
Leerzeichen verwendet; wenn ein String übergeben wird, wird dieser String
verwendet. getIndent() kann verwendet werden um jederzeit
festzustellen wie die aktuellen Einstellungen sind.
Placeholder Container Objekte ArrayObject erweitern,
können Inhalte einem speziellen Schlüssel im Container sehr einfach zugeordnet werden,
statt diese einfach an den Container anzufügen. Auf Schlüssel kann entweder als Objekt
Eigenschaften oder als Array Schlüssel zugegriffen werden.
Placeholder View Helfer
erlaubt es willkürliche Inhalte zu erfassen um diese später durch Verwendung der
folgenden API darstellen zu können.
captureStart($type, $key) beginnt die Erfassung der Inhalte.
$type sollte eine der Placeholder Konstanten
APPEND oder SET sein. APPEND fügt
erfasste Inhalte der Liste der aktuellen Inhalte im Placeholder an;
SET verwendet erfasste Inhalte als einzigen Wert für den
Platzhalter (überschreibt potentiell alle vorherigen Inhalte). Standardmäßig ist
$type APPEND.
$key kann verwendet werden um einen speziellen Schlüssel im
Placeholder Container zu spezifizieren an dem der Inhalt erfasst werden soll.
captureStart() sperrt die Erfassung bis captureEnd()
aufgerufen wurde; Erfassungen können nicht mit dem selben Placeholder Container
verschachtelt werden. Das führt zu einer Ausnahme.
captureEnd() stoppt die Erfassung von Inhalten, und platziert Ihn
im Container Objekt anhängig davon wie captureStart() aufgerufen
wurde.
content ?>
content ?>