HeadLink Helfer
Das HTML <link> Element wird immer mehr für
das Verlinken einer Vielzahl von Ressourcen der eigenen Site verwendet: Stylesheets, Feeds,
FavIcons, Trackbacks, und andere. Der HeadLink Helfer bietet ein
einfaches Interface für die Erstellung und das Anhäufen dieser Elemente für das spätere
Empfangen und deren Ausgabe im eigenen Layout Skript.
Der HeadLink Helfer hat spezielle Methode für das hinzufügen von
Stylesheet Links zu seinem Stack:
appendStylesheet($href, $media, $conditionalStylesheet, $extras)offsetSetStylesheet($index, $href, $media, $conditionalStylesheet,
$extras)prependStylesheet($href, $media, $conditionalStylesheet, $extras)setStylesheet($href, $media, $conditionalStylesheet, $extras)
Der $media Wert ist standardmäßig 'screen', kann aber jeder gültige Media
Wert sein. $conditionalStylesheet ist ein String oder boolsches
FALSE und wird verwendet um während der Darstellung zu erkennen ob
spezielle Kommentare inkludiert werden sollen um das Laden dieser Stylesheets auf diversen
Plattformen zu verhindern. $extras ist ein Array von extra Werten die man
dem Tag hinzufügen will.
Zusätzlich hat der HeadLink Helfer eine spezielle Methode für das
Hinzufügen von 'alternativen' (alternate) Links zu seinem Stack:
appendAlternate($href, $type, $title, $extras)offsetSetAlternate($index, $href, $type, $title, $extras)prependAlternate($href, $type, $title, $extras)setAlternate($href, $type, $title, $extras)
Die headLink() Helfer Methode erlaubt das Spezifizieren aller
Attribute die für ein <link> Element notwendig sind, und erlaubt
auch die Spezifizfikation der Platzierung --- entweder ersetzt das neue Element alle
anderen, wird vorangestellt (an den Beginn des Stacks) , oder angefügt (an das Ende des
Stacks).
Der HeadLink Helfer ist eine konkrete Implementation des
Platzhalter Helfers.
Grundsätzliche Verwendung des HeadLink HelfersheadLink kann jederzeit spezifiziert werden. Typischerweise wird
ein globaler Link im eigenen Layout Skript spezifiziert, und anwendungsspezifische Links
in den View Skripten der Anwendung. Im Layoutskript, in der <head> Sektion, muß
das der Helfer ausgegeben werden.
headLink()->appendStylesheet('/styles/basic.css')
->headLink(array('rel' => 'favicon',
'href' => '/img/favicon.ico'),
'PREPEND')
->prependStylesheet('/styles/moz.css',
'screen',
true,
array('id' => 'my_stylesheet'));
?>
headLink() ?>
]]>