von Sebastian Kurfürst, 01.03.2009

Neue Template-Eingine für FLOW3 und TYPO3 4.x: Fluid – Templating leicht gemacht

Aus dem
t3n Magazin Nr. 16

Jetzt kaufen

typo3 logo

Mit Fluid steht TYPO3-Entwicklern ab Version 4.3 eine neue Template-Engine zur Verfügung, die auch Bestandteil von FLOW3 ist. Sie ist leicht zu lernen, sehr flexibel und extrem erweiterbar. Der folgende Artikel erläutert Grundlagen und stellt die Konzepte hinter Fluid vor.

TYPO3-Entwickler setzen beim Thema Templating meist auf die populäre markerbasierte Variante, die schon sehr lange fester Bestandteil von ist. Andere haben bereits mit Smarty, PHPTAL oder anderen Template-Engines gearbeitet und fragen sich nun womöglich, weshalb es noch einer weiteren Template-Engine bedarf. Ein Beispiel zur Ausgabe einer Liste von Blogposts soll verdeutlichen, woran es bislang hakt:

Klassisches Templating

// Im Template

###CONTENTS###
<ul>
###SUBELEMENT###
    <li>###TITLE###</li>
###SUBELEMENT###
</ul>
###CONTENTS###

// in PHP

$subEl = getSubpart(“SUBELEMENT“);
$out = ‘‘; foreach ($recordList as $record) {
    $out .= substituteMarker($subEl, ‘TITLE‘, $record[‘title‘]);
}
return substituteSubpart($template, ‘SUBELEMENT‘, $out);

Listing 1

Wie man sieht, ist sehr viel Code für eine einfache Aufgabe wie die Ausgabe einer Liste notwendig – außerdem existiert keine saubere Trennung zwischen Präsentations- und Anwendungslogik.

Nachdem klar war, dass TYPO3 in Zukunft eine neue Templating-Lösung benötigt, hat das Kernentwickler-Team viele verschiedene Template-Engines unter die Lupe genommen – alle hatten jedoch gemeinsame Nachteile:

  • nicht komplett objektorientiert programmiert (PHP 4)
  • komplizierte oder unlogische Syntax
  • PHP im Template erlaubt
  • mangelhafte und unsaubere Erweiterbarkeit

Hier setzt Fluid [1] an: Die Template-Engine besitzt eine neue, intuitive Syntax, die extrem flexibel und erweiterbar ist, aber trotzdem leicht erlernt werden kann. Das folgende Beispiel soll anhand eines Blogs verdeutlichen, wie effizient Entwickler mit Fluid arbeiten können.

Objekte traversieren leicht gemacht

Im Controller können Variablen mit Hilfe von „$this->view->assign('blogTitle', 'Mein erster Blog');“ zugewiesen werden. Um den Inhalt einer Variablen im Template auszugeben, ist die {...}-Syntax vorhanden: {blogTitle}.

Einfache Variablenausgabe

// Im Controller:
$this->view->assign('blogTitle', 'Mein erster Blog');
// Im Template:
<h1>{blogTitle}</h1>

Listing 2

Darüber hinaus ist es möglich, sich „durch Objekte durchzuhangeln“, indem man einen Punkt verwendet: „{blog.title}“ führt zu einem Aufruf von „$blog->getTitle()“, „{post.author.name}“ analog zu „$post->getAuthor()->getName()“.

Objekte traversieren

// Im Controller:
$this->view->assign('blog', $blog);
// Im Template:
<h1>{blog.title}</h1>

Listing 3

Standard-ViewHelper nutzen

Nun wollen wir das obige Beispiel erweitern und eine Liste von Blogpostings ausgeben. Dafür greift man in Fluid auf so genannte „ViewHelper“ zurück. Im Template werden diese mit Hilfe von speziellen Tags aufgerufen. Das folgende Listing gibt alle Beiträge eines Blogs aus:

ViewHelper aufrufen

<f:for each="{blog.posts}" as="post">
	<h2>{post.title}</h2>
	<p>{post.teaser}
		<f:actionlink action="show" arguments="{post : post.uid}">mehr...</f:actionlink>
	</p>
</f:for>

Listing 4

Das spezielle Tag „<f:for>“ ist ein solcher ViewHelper. Mit ihm kann über Arrays iteriert werden, um die einzelnen Elemente auszugeben. Im obigen Beispiel gibt es noch einen zweiten ViewHelper namens „<f:actionlink>“, der verwendet wird, um einen Link auf die Detailansicht auszugeben.

Häufig benötigte ViewHelper wie Schleifen, Links, Formulare oder Localization [2] liefert Fluid mit. Jede Extension kann allerdings ihre eigenen ViewHelper definieren und nutzen.

Seite:  1 2

8 Antworten

  1. von Mirco 30.11.2009 (19:42Uhr) 1.

    GENAIL! Danke für den Artikel. Das Prinzip dieser Templates, den ViewHelperl etc. kenne ich bereits vom ZendFramework, wo es grandios funktioniert. Ich hoffe doch stark, das auch der Rest vom T3-Core mit den nächsten Versionen auf MVC umgebaut wird (das soll ja mit FLOW kommen soweit ich weiß). Bleibt am Ball, danke :-)

  2. von Steffen Müller 24.12.2009 (01:18Uhr) 2.

    Die API scheint sich ein wenig verändert zu haben:

    Statt
    class Tx_Blog_ViewHelpers_GravatarViewHelper extends Tx_Fluid_Core_AbstractViewHelper {
    muss es heißen:
    class Tx_Blog_ViewHelpers_GravatarViewHelper extends Tx_Fluid_Core_ViewHelper_AbstractViewHelper {

  3. von Sebastian Kurfürst 11.01.2010 (13:54Uhr) 3.

    Hallo Steffen,

    vielen Dank für die Korrektur, es wurden da noch ViewHelper in andere Positionen geschoben, da der Artikel weit vor Fluid 1.0 erschienen ist.
    Jetzt, mit Fluid 1.0, erachten wir die öffentliche API als stabil an.

    Viele Grüße,
    Sebastian

  4. von TYPO3: Meine ersten Erfahrungen mit Extb… 14.03.2010 (16:01Uhr) 4.

    [...] holte ich mir in den Fachartikeln der t3n: Die Zukunft der Extensionentwicklung, von Jochen Rau Fluid: Templating leicht gemacht, von Sebastian Kurfürst Extension-Entwicklung mit Extbase und Fluid, von Patrick Lobacher und [...]

  5. von cialis 22.06.2010 (11:09Uhr) 5.

    Hallo und danke für den nützlichen Artikel. Genau das habe ich gesucht.

  6. von TYPO3: Fluid – Templating Engine |… 03.09.2010 (21:43Uhr) 6.

    [...] Artikel_t3n_Kurfürst [...]

  7. von Die wahre Macht der neuen Template-Engin… 17.11.2010 (15:31Uhr) 7.

    [...] t3n 16 [2] finden Sie einen ausführlichen Artikel zu Fluid, im Folgenden wird nur kurz auf die Syntax von [...]

  8. von me@foo.bar 21.10.2011 (11:53Uhr) 8.

    Das ist aber nicht richtig durchdacht, oder? Da habe ich ne Syntax für Variablen {} und dann noch "View-Helper", die sich an XML anlehnen. Woher weiß denn die Variablen-Syntax, in welchem Kontext sie angewendet wird? (Also [CDATA] oder Attribut).

    Schon mal nen Blick auf TAL/Metal geworfen, wie man sowas richtig macht?

    http://de.wikipedia.org/wiki/Zope_Page_Templates

Deine Meinung


(wird nicht veröffentlicht)