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 ?>