Lernseite · Fluid-ViewHelper

ViewHelper im Einsatz: Texte, Bilder, Links und Kopfdaten

Stand 15. November 2026 · TYPO3 14.3 LTS · ca. 24 Min. Lesezeit

Mit Fluid allein stehen Daten nur roh im Template. Erst die ViewHelper machen daraus ein lesbares Datum, ein passend skaliertes Foto, einen Link oder einen Meta-Tag. Auf dieser Seite baust du mit Mara die Website einer Musikschule aus und lernst die wichtigsten ViewHelper für Texte, Datum, Bilder, Zuschnitte, Links, Kopfdaten und Assets kennen. Danach weißt du, welcher ViewHelper wofür gedacht ist und wo er Fallen hat.

Das Beispiel: die Musikschule Lindenau

Die Integratorin Mara baut die Website der Musikschule Lindenau. Alles liegt in ihrem Sitepackage lindenau_site, dem Composer-Paket lindenau/site, in einem Composer-Projekt mit TYPO3 14.3. Die Website hat Kursseiten für Instrumente, eine Seite mit den Lehrkräften und einen Konzertkalender. Die Fotos der Lehrkräfte sollen scharf und schnell laden. Jede Kursseite und jedes Konzert soll eigene Meta-Tags haben.

Ein ViewHelper ist ein Fluid-Tag mit Logik dahinter. Der Namensraum f ist überall vorgegeben, du musst ihn nicht importieren. Die meisten ViewHelper kannst du auf zwei Arten aufrufen: als Tag oder inline in geschweiften Klammern. Inline kannst du einen Wert mit einem Pfeil an den ViewHelper weiterreichen.

<f:format.crop maxCharacters="40">{course.title}</f:format.crop>

{course.title -> f:format.crop(maxCharacters: 40)}
Fluid-Beispiel. Zweimal dasselbe: Der Kurstitel wird auf 40 Zeichen gekürzt, einmal als Tag f:format.crop und einmal inline, indem course Punkt title mit einem Pfeil an f:format.crop weitergereicht wird.

Die Grundlagen zu Variablen, Escaping und Bedingungen stehen im Kurs „Fluid-Grundlagen“. Hier geht es um die ViewHelper selbst.

Texte formatieren

Die Gruppe format enthält viele kleine Helfer. Für die Kursbeschreibungen der Musikschule braucht Mara vor allem diese:

  • Der ViewHelper f:format.crop kürzt einen Text auf die Zeichenzahl aus maxCharacters. Wurde gekürzt, hängt er standardmäßig ein Auslassungszeichen an. Dabei schneidet er nicht mitten im Wort ab.
  • Der ViewHelper f:format.nl2br macht aus jedem Zeilenumbruch einen HTML-Zeilenumbruch. Das passt für mehrzeilige Textfelder ohne Editor.
  • Der ViewHelper f:format.currency gibt eine Zahl als Geldbetrag aus, mit Dezimaltrenner und Tausendertrenner. Das Währungszeichen gibst du mit currencySign an. So steht die Kursgebühr als 45,00 € auf der Seite.
  • Der ViewHelper f:format.number formatiert Zahlen ohne Währung.
  • Der ViewHelper f:format.bytes zeigt Dateigrößen lesbar an, etwa für den Download der Anmeldung.
  • Der ViewHelper f:format.trim entfernt Leerzeichen am Rand. Der ViewHelper f:format.padding füllt einen Text auf eine Länge auf. Der ViewHelper f:format.case ändert Groß- und Kleinschreibung.

Rich Text: Text aus dem Rich-Text-Editor gibst du mit dem ViewHelper f:format.html aus. Er schickt den Text durch eine parseFunc, standardmäßig durch lib.parseFunc_RTE. Dabei werden interne TYPO3-Links, die mit t3 beginnen, in echte URLs umgewandelt, und das HTML wird bereinigt.

Vorsicht bei zwei ViewHelpern: Fluid maskiert Variablen normalerweise. Der ViewHelper f:format.raw hebt dieses Escaping auf. Der ViewHelper f:format.htmlentitiesDecode macht maskierte Zeichen wieder zu echtem HTML. Beide können zu Cross-Site-Scripting führen, wenn Eingaben von Besuchern hindurchlaufen. Die ViewHelper f:format.htmlspecialchars und f:format.stripTags machen die Ausgabe dagegen sicherer. Der erste maskiert, der zweite entfernt Tags.

Datum und Uhrzeit

Die Konzerttermine gibt Mara mit dem ViewHelper f:format.date aus. Er nimmt ein Objekt mit DateTimeInterface oder einen Text, den PHP als Datum versteht. Das kann ein Zeitstempel sein oder eine relative Angabe wie „plus eine Woche“.

Zwei Wege zum Format:

  • Das Argument format nimmt die PHP-Datumszeichen. Der Buchstabe d steht für den Tag, m für den Monat und das große Y für das vierstellige Jahr. Mit Punkten dazwischen ergibt das 31.12.2026.
  • Das Argument pattern nimmt die ICU-Schreibweise wie zwei kleine d, Punkt, vier große M, Leerzeichen, vier kleine y. Zusammen mit dem Argument locale, etwa de-DE, entstehen übersetzte Monatsnamen wie „31. Dezember 2026“.
<f:format.date format="d.m.Y">{concert.date}</f:format.date>
<f:format.date pattern="dd. MMMM yyyy" locale="de-DE">{concert.date}</f:format.date>
<f:format.date pattern="FULLDATE" locale="de-DE">{concert.date}</f:format.date>
<f:format.date format="d.m.Y" base="{concert.date}">+1 week</f:format.date>
<f:format.date format="H:i" timezone="Europe/Berlin">{concert.date}</f:format.date>
Fluid-Beispiele. Die erste Zeile gibt das Konzertdatum mit format d Punkt m Punkt Y aus. Die zweite nutzt pattern dd Punkt MMMM yyyy mit locale de-DE. Die dritte nutzt die Vorgabe FULLDATE mit locale de-DE. Die vierte gibt das Datum eine Woche nach dem Konzert aus, mit der relativen Angabe plus eine Woche und dem Konzertdatum als base. Die letzte rechnet die Zeit nach Europe Berlin um.
Welches Format nimmt f:format.date? pattern gesetzt? ja ICU-Muster + locale 31. Dezember 2026 gewinnt auch gegen format nein format gesetzt? ja PHP-Zeichen, ohne locale d.m.Y → 31.12.2026 nein SYS ddmmyy (Standard) Y-m-d → 2026-12-31 timezone rechnet um, base ist der Bezug für +1 week. FULL · LONG · MEDIUM · SHORT · FULLDATE
Welches Format f:format.date verwendet.

Die wichtigsten Regeln dazu:

  • Sind format und pattern gesetzt, hat pattern Vorrang. So steht es in der Beschreibung des Arguments.
  • Ist keines von beiden gesetzt, nimmt der ViewHelper die Einstellung ddmmyy unter SYS in den globalen TYPO3-Einstellungen. Standard ist Y-m-d, also zum Beispiel 2026-12-31.
  • Das Argument locale wirkt nur zusammen mit pattern. Mit format bekommst du die PHP-Zeichen ohne Übersetzung.
  • Für ein voll lokalisiertes Datum ohne eigenes Muster kennt pattern die Vorgaben FULL, LONG, MEDIUM und SHORT. Dazu gibt es Varianten wie FULLDATE nur für das Datum und FULLTIME nur für die Uhrzeit. FULLDATE mit de-DE ergibt etwa „Donnerstag, 31. Dezember 2026“.
  • Das Argument timezone rechnet das Datum vor der Ausgabe in eine Zeitzone um. Ein in UTC gespeichertes Konzert erscheint mit Europe Berlin in Berliner Zeit.
  • Das Argument base ist der Bezugspunkt für relative Angaben wie plus eine Woche oder minus ein Jahr. Ohne base gilt die aktuelle Zeit.

Textfelder mit f:render.text

Für Textfelder von Datensätzen gibt es seit TYPO3 14.2 den ViewHelper f:render.text. Er liest die TCA-Konfiguration des Felds und wählt selbst die passende Ausgabe. Damit ersetzt er drei frühere Wege:

  • Bei einem einfachen Eingabefeld ersetzt er die direkte Ausgabe der Variable. Der Text wird maskiert.
  • Bei einem mehrzeiligen Textfeld ersetzt er den ViewHelper f:format.nl2br. Zeilenumbrüche werden zu HTML-Umbrüchen.
  • Bei einem Rich-Text-Feld ersetzt er den ViewHelper f:format.html.

Übersetzungen aus XLIFF-Dateien und Bilder sind keine Textfelder. Dafür bleiben eigene ViewHelper zuständig.

Das Argument field ist Pflicht. Es nennt das Datenbankfeld. Den Datensatz übergibst du mit dem Argument record oder als Inhalt des ViewHelpers.

{record -> f:render.text(field: 'header')}
<f:render.text record="{record}" field="bodytext" />
<f:render.text record="{teacher}" field="sub_title" optional="true" />
Fluid-Beispiele. Erstens wird record inline an f:render.text mit dem Feld header weitergereicht. Zweitens gibt f:render.text das Feld bodytext des Datensatzes aus. Drittens bekommt ein Extbase-Model teacher das Feld sub_title mit Unterstrich, also den Namen aus der Datenbank, und optional true.

Voraussetzung im Inhaltselement: Damit die Variable record im Template ein Record-Objekt mit TCA-Informationen ist, braucht das Inhaltselement den Data Processor record-transformation. Ohne ihn liegen nur Rohdaten vor, und der ViewHelper kann das Feld nicht einordnen.

Extbase-Models kann der ViewHelper auch verarbeiten. Er erwartet aber den Feldnamen aus der Datenbank, nicht den Namen der Eigenschaft. Hat das Model der Lehrkraft die Eigenschaft subTitle aus dem Feld sub_title, schreibst du sub_title. Fehlt das Feld, gibt es einen Fehler. Mit optional auf true bekommst du stattdessen null. Das gilt auch für Record-Objekte. Das Model muss außerdem alle Felder abbilden, die du ausgibst, und auch das Typ-Feld, wenn die TCA eines kennt.

Bilder mit f:image

Der ViewHelper f:image skaliert, beschneidet oder wandelt ein Bild bei Bedarf um. Am Ende gibt er ein fertiges img-Tag aus. Brauchst du nur die URL des bearbeiteten Bilds, nimmst du den ViewHelper f:uri.image.

Es gibt zwei Wege, das Bild zu übergeben:

  • Das Argument image erwartet ein Objekt aus der Dateiverwaltung FAL, also ein File oder eine FileReference. So kommen die Fotos der Lehrkräfte ins Template.
  • Das Argument src nimmt einen Pfad mit EXT:, einen FAL-Bezeichner oder eine UID. So bindet Mara das Logo aus dem Sitepackage ein.

Externe URLs verarbeitet der ViewHelper nicht. Ein Bild von einer fremden Adresse wird weder heruntergeladen noch skaliert.

<f:image image="{teacher.photo}" width="800c" cropVariant="default" loading="lazy" alt="{teacher.name}" />
<f:image src="EXT:lindenau_site/Resources/Public/Images/logo.png" width="200" fileExtension="webp" />
<f:image src="EXT:lindenau_site/Resources/Public/Images/logo.png" width="200" base64="true" />
Fluid-Beispiel. f:image bekommt das Foto der Lehrkraft, die Breite 800c, die Zuschnitt-Variante default und das Attribut loading lazy. Ein zweites f:image gibt das Logo aus dem Sitepackage als WebP aus. Ein drittes bettet das Logo für eine E-Mail mit base64 true ein.

Die wichtigen Argumente:

  • Bei width und height gibst du Pixel an. Der Zusatz c schneidet zu. Breite 800c ergibt ein Bild, das auf genau 800 Pixel Breite zugeschnitten ist. Mit dem Zusatz m ist der Wert eine Obergrenze. Das Bild wird proportional skaliert und wird höchstens so groß.
  • Mit cropVariant wählst du einen gespeicherten Zuschnitt, zum Beispiel mobile. Standard ist default.
  • crop auf false hebt den gespeicherten Zuschnitt auf. Dann wird das ganze Bild verwendet.
  • fileExtension legt das Zielformat fest, etwa webp. Das Bild wird bei Bedarf umgewandelt. Das funktioniert unabhängig davon, ob du image oder src benutzt.
  • base64 auf true schreibt die Bilddaten als data-URI direkt in das src-Attribut. Das ist für HTML-E-Mails gedacht, etwa in Templates für FluidEmail.
  • Weitere Attribute wie loading mit dem Wert lazy oder alt übernimmt der tagbasierte ViewHelper einfach in das img-Tag.

Standard-Zielformate: Welches Format beim Umwandeln entsteht, regelt die Einstellung imageFileConversionFormats unter GFX in den globalen TYPO3-Einstellungen. Web-Formate wie jpg, png, gif, svg und webp bleiben standardmäßig erhalten. Alles andere wird zu png. Besteht die Einstellung nur aus dem Schlüssel default mit dem Wert webp, wandelt TYPO3 alles nach WebP um. Bleiben die Einträge für jpg und png stehen, werden diese Formate weiter durchgereicht.

Responsive Bilder mit f:image.srcset

Die Fotos der Lehrkräfte sollen auf dem Handy klein und auf dem großen Bildschirm scharf sein. Dafür braucht das img- oder source-Tag ein srcset-Attribut mit mehreren Bildgrößen. Früher schrieb man dafür viele Aufrufe von f:uri.image von Hand. Seit TYPO3 14.2 gibt es den ViewHelper f:image.srcset.

Er erzeugt aus einer Angabe alle Bildvarianten und liefert die fertige Liste aus URLs und Deskriptoren. Es gibt zwei Arten von Deskriptoren:

  • Breiten wie 400w und 800w beziehen sich auf die Breite der Bilddatei.
  • Pixeldichten wie 1x und 2x beziehen sich auf die Pixeldichte des Bildschirms.

Beide Arten darfst du nicht mischen. TYPO3 bricht bei einer Mischung mit einem Fehler ab. Bei Pixeldichten braucht TYPO3 eine Basisbreite für 1x, aus der es 2x und 3x berechnet. Diese gibst du mit referenceWidth an. Für Breiten-Deskriptoren hat referenceWidth keine Bedeutung.

Welches Bild der Browser am Ende nimmt, steuerst du weiter mit den HTML-Attributen sizes und media. Die macht der ViewHelper nicht überflüssig.

Picture mit Zuschnitten: Auf dem Desktop soll das Foto breit sein, auf dem Handy quadratisch. Dafür bekommt jedes source-Element im picture-Element über media seinen Bildschirmbereich und über cropVariant seinen eigenen Zuschnitt. Das img darin ist der Rückfall für alte Browser.

<picture>
  <source media="(min-width: 1000px)" sizes="100vw"
    srcset="{f:image.srcset(image: teacher.photo, srcset: '1000w, 1400w', cropVariant: 'desktop')}" />
  <source
    srcset="{f:image.srcset(image: teacher.photo, srcset: '1x, 2x', referenceWidth: 400, cropVariant: 'mobile')}" />
  <f:image image="{teacher.photo}" width="400" cropVariant="mobile" alt="{teacher.name}" />
</picture>
Fluid-Beispiel. Ein picture-Element mit zwei source-Elementen. Das erste gilt ab 1000 Pixel Bildschirmbreite, nutzt die Zuschnitt-Variante desktop und die Breiten 1000w und 1400w. Das zweite nutzt die Variante mobile mit den Pixeldichten 1x und 2x und der Basisbreite 400. Zuletzt folgt f:image als Rückfall.
Ein Foto, zwei Zuschnitte picture source · ab 1000 px cropVariant desktop 1000w, 1400w 16:9 source · Mobil cropVariant mobile 1x, 2x (referenceWidth 400) 1:1 img · Rückfall f:image w und x nie in derselben Liste mischen. sizes und media steuern weiter die Auswahl.
Je source eine eigene Zuschnitt-Variante.

Zuschnitte mit Crop Variants

Crop Variants sind mehrere gespeicherte Zuschnitte desselben Bilds, jeder mit eigenem Seitenverhältnis. Die Redakteure der Musikschule schneiden ein Foto im Backend einmal breit für den Desktop und einmal quadratisch für Mobil zu. Im Template wählst du die Variante mit cropVariant aus.

Wo definiert? Die Varianten stehen in der TCA des Felds crop der Tabelle sys_file_reference. Das Feld hat den Typ imageManipulation. Alternativ setzt du sie per TCEFORM im Page TSconfig. Je Variante legst du einen Titel, die erlaubten Seitenverhältnisse mit allowedAspectRatios und drei Bereiche fest:

  • Die cropArea ist der Ausgangszuschnitt.
  • Die focusArea markiert den wichtigen Bildteil, zum Beispiel das Gesicht. Sie hilft bei responsiven Zuschnitten.
  • Die coverAreas zeigen Bereiche, die später verdeckt werden, etwa durch Text über dem Bild.

Alle Bereiche gibst du relativ an, mit Werten zwischen 0 und 1.

$GLOBALS['TCA']['tt_content']['types']['textpic']['columnsOverrides']['image']['config']['overrideChildTca']['columns']['crop']['config']['cropVariants'] = [
    'mobile' => [
        'title' => 'Mobil',
        'allowedAspectRatios' => ['1:1' => ['title' => '1:1', 'value' => 1.0]],
    ],
    'default' => ['disabled' => true],
];
PHP-Beispiel aus der TCA. Im Typ textpic von tt_content bekommt das Feld image über columnsOverrides und overrideChildTca zwei Varianten für das Feld crop. Die Variante mobile hat den Titel Mobil und erlaubt nur das Seitenverhältnis 1 zu 1. Die Variante default wird mit disabled true abgeschaltet.

Nur für einen Inhaltstyp: Mit overrideChildTca am Feld image von tt_content gilt eine Änderung für alle Inhaltstypen. Soll nur der Typ textpic eine zusätzliche Variante bekommen, legst du overrideChildTca in die columnsOverrides dieses Typs.

Varianten abschalten: overrideChildTca wird mit der TCA von sys_file_reference zusammengeführt. Einen Schlüssel einfach wegzulassen, entfernt die Variante darum nicht. Dafür gibt es das Schlüsselwort disabled. Setzt du es bei der Variante default auf true, verschwindet sie für dieses Feld.

Alle auf einmal zuschneiden: Seit TYPO3 14.2 zeigt der Bildeditor ein Häkchen, mit dem Redakteure alle Varianten gleichzeitig zuschneiden. Es erscheint nur, wenn die Varianten bis auf den Titel gleich konfiguriert sind, also mit denselben Seitenverhältnissen. Eine abweichende Variante, etwa für eine Listenansicht, nimmst du mit excludeFromSync davon aus.

Links und URLs

Für Links gibt es zwei Familien. Die ViewHelper der Gruppe link erzeugen das ganze a-Tag. Die ViewHelper der Gruppe uri liefern nur die Adresse, zum Beispiel für ein Attribut. So gibt der ViewHelper f:uri.page nur die URL aus, der ViewHelper f:link.page dagegen einen fertigen Link.

  • Der ViewHelper f:link.page verlinkt eine Seite des Seitenbaums über pageUid. Mit additionalParams hängst du Parameter an. Mit language verlinkst du auf eine andere Sprache. Mit absolute auf true entsteht eine vollständige URL mit Domain.
  • Der ViewHelper f:link.typolink übergibt das Argument parameter an typolink. Damit versteht er die Werte aus Link-Feldern: interne Links, die mit t3 beginnen, und Kurzformen wie „12 _blank“ mit Ziel, Klasse und Titel. Der ViewHelper f:uri.typolink liefert dazu nur die URL.
  • Der ViewHelper f:link.email erzeugt einen mailto-Link. Er kennt die Argumente email, cc, bcc, subject für den Betreff und body. Das Argument title setzt nur das title-Attribut des Links.
  • Der ViewHelper f:link.external ist für fremde Adressen, der ViewHelper f:link.file für Dateien, der ViewHelper f:link.action für Extbase-Actions.
<f:link.page pageUid="12" language="1" absolute="true">Klavierkurs</f:link.page>
<f:link.typolink parameter="{record.link}">Mehr erfahren</f:link.typolink>
<f:link.email email="sekretariat@example.org" subject="Anmeldung">Schreib uns</f:link.email>
<f:link.page pageUid="12" addQueryString="untrusted">Filter behalten</f:link.page>
Fluid-Beispiele. Ein Link auf Seite 12 in der Sprache 1 als absolute URL. Ein typolink mit dem Wert aus einem Link-Feld. Ein E-Mail-Link an das Sekretariat mit dem Betreff Anmeldung. Ein Link auf Seite 12, der alle aktuellen Query-Parameter übernimmt, mit addQueryString untrusted.

Spamschutz: Der ViewHelper f:link.email schützt Adressen nicht von sich aus. Er richtet sich nach der TypoScript-Einstellung spamProtectEmailAddresses.

Aktuelle Parameter übernehmen: Ist addQueryString gesetzt, bleiben die aktuellen Query-Parameter im Link erhalten. Mit dem Wert untrusted werden ausdrücklich alle Parameter übernommen, auch nicht vertrauenswürdige. Laut Beschreibung kann das bei gecachten Links zu Problemen führen.

Kopfbereich und Meta-Tags

Seit TYPO3 14.0 gibt es zwei ViewHelper, die beliebiges Markup in die Seite schreiben. Beide nutzen intern die PageRenderer-API.

  • Der ViewHelper f:page.headerData fügt seinen Inhalt in den head der Seite ein, etwa preload-, preconnect- oder dns-prefetch-Links.
  • Der ViewHelper f:page.footerData schreibt seinen Inhalt direkt vor das schließende body-Tag, etwa ein Tracking-Skript.

Für Stylesheets und Skripte nimmst du besser die Asset-ViewHelper aus dem nächsten Abschnitt. Sie vergeben eine Kennung und verhindern Doppelungen. Die Kopfdaten-ViewHelper sind für anderes Markup gedacht und kennen keine Kennung.

Meta-Tags aus Fluid: Ebenfalls seit TYPO3 14.0 setzt der ViewHelper f:page.meta Meta-Tags direkt im Template. Er nutzt den MetaTagManager, wie TypoScript und PHP auch. Darum gelten dieselben Regeln und Prioritäten. Er funktioniert in jedem Fluid-Kontext: in Extbase-Templates, in Fluid-basierten Inhaltselementen, in Komponenten und im Seiten-Template des Sitepackages.

  • Das Argument property ist das einzige Pflicht-Argument, zum Beispiel description, og:title oder og:type.
  • Mit type erzwingst du name, property oder http-equiv. Ohne type entscheidet der zuständige Manager, bei og-Tags etwa property.
  • Mit subProperties ergänzt du Zusatzangaben wie width, height oder alt. Bei og:image erzeugt der Manager daraus og:image:width und og:image:height.
  • Mit replace auf true überschreibst du einen Meta-Tag, der schon gesetzt ist. Ohne replace bleibt der vorhandene Tag gleicher Eigenschaft bestehen.
<f:page.meta property="description" replace="true">{concert.teaser}</f:page.meta>
<f:page.meta property="og:title">{concert.title}</f:page.meta>
<f:page.meta property="og:image" subProperties="{width: 1200, height: 630}">{imageUrl}</f:page.meta>
Fluid-Beispiel aus der Detailseite eines Konzerts. f:page.meta setzt die description mit replace true, weil TypoScript schon eine gesetzt hat. Dann folgen og:title und ein og:image mit subProperties für Breite 1200 und Höhe 630.

CSS und JavaScript einbinden

Die ViewHelper f:asset.css und f:asset.script melden CSS und JavaScript aus Fluid beim AssetCollector an. TYPO3 gibt alles gesammelt an der richtigen Stelle der Seite aus. Du kannst eine Datei angeben, mit href bei CSS und mit src bei JavaScript, oder Inline-Code als Inhalt.

Die Kennung: Das Argument identifier ist immer Pflicht. Wird ein Asset mit derselben Kennung mehrfach angemeldet, etwa weil der Slider in drei Inhaltselementen steckt, gibt TYPO3 es nur einmal aus. Gleiche Kennung bedeutet dasselbe Asset. Melden zwei Inhaltselemente unter der Kennung slider zwei verschiedene Dateien an, erscheint also nur eine davon, nämlich die zuletzt angemeldete. Jede eigenständige Datei braucht darum eine eindeutige Kennung.

<f:asset.css identifier="lindenau-main" href="EXT:lindenau_site/Resources/Public/Css/main.css" media="screen" />
<f:asset.script identifier="lindenau-slider" src="EXT:lindenau_site/Resources/Public/JavaScript/slider.js" defer="true" />
<div style="{f:asset.styleAttr(value: 'background-color: {instrument.color}')}">…</div>
Fluid-Beispiele. f:asset.css meldet das Stylesheet des Sitepackages mit der Kennung lindenau-main und dem Attribut media screen an. f:asset.script meldet das Slider-Skript mit der Kennung lindenau-slider und defer an. Zuletzt bekommt ein div ein style-Attribut aus f:asset.styleAttr mit der Hintergrundfarbe des Instruments.

Weitere Argumente:

  • priority auf true stellt ein Stylesheet vor die übrigen CSS-Dateien. Eingebundene CSS-Dateien stehen immer im head. Bei einem Skript entscheidet priority, ob es in den head kommt. Ohne priority landen Skripte am Ende des body. Achtung: Inline-CSS ohne priority setzt TYPO3 ebenfalls ans Ende des body, obwohl die Beschreibung des Arguments sagt, CSS stehe immer im head. Das gilt für Code als Inhalt und für Dateien mit inline auf true.
  • inline auf true bettet den Inhalt einer per href oder src angegebenen Datei direkt in die Seite ein.
  • Der ViewHelper f:asset.css kennt HTML-Attribute wie media, integrity und crossorigin.
  • Der ViewHelper f:asset.script kennt async, defer, nomodule und type. Mit defer läuft das Skript erst nach dem Parsen des Dokuments. Mit async wird es parallel geladen und sofort ausgeführt. Mit nomodule läuft es nur in Browsern ohne ES-Module.
  • Seit TYPO3 14.2 heißt das frühere Argument useNonce nun csp. Es steuert, ob für das Asset ein Hash oder eine Nonce für die Content Security Policy erfasst wird.
Wo landet die Ausgabe? head f:asset.css, Datei oder priority f:asset.script mit priority f:page.headerData f:page.meta body Inhalt der Seite direkt vor dem schließenden body-Tag f:asset.script ohne priority f:asset.css inline ohne priority f:page.footerData Nur f:asset.* verhindert Doppelungen per identifier. headerData und footerData: ohne Escaping.
Wo die ViewHelper ihre Ausgabe ablegen.

Werte in style-Attributen: Der ViewHelper f:asset.styleAttr gibt es seit TYPO3 14.2. Er liefert den Wert für ein style-Attribut eines HTML-Tags und erfasst dafür einen Hash für die CSP-Direktive style-src-attr. So bleibt ein einzelner Inline-Style bei strenger Content Security Policy erlaubt. Externe Stylesheets bindest du weiter mit dem ViewHelper f:asset.css ein.

Das Wichtigste in Kürze

  • Die ViewHelper der Gruppe link erzeugen ein a-Tag, die der Gruppe uri nur die URL.
  • Die ViewHelper f:format.raw und f:format.htmlentitiesDecode können zu Cross-Site-Scripting führen. Der ViewHelper f:format.html nutzt lib.parseFunc_RTE.
  • Beim Datum gewinnt pattern vor format. Ohne beide gilt SYS ddmmyy, standardmäßig Y-m-d. Die locale wirkt nur mit pattern.
  • Der ViewHelper f:render.text braucht field mit dem Datenbank-Feldnamen und im Inhaltselement record-transformation.
  • Der ViewHelper f:image nimmt image für FAL-Objekte und src für Pfade, externe URLs verarbeitet er nicht.
  • Der ViewHelper f:image.srcset gibt es seit TYPO3 14.2. Er kennt w oder x, und für x braucht er referenceWidth.
  • Crop Variants stehen in der TCA des Felds crop. Für einen einzelnen Inhaltstyp nutzt du columnsOverrides, zum Abschalten disabled.
  • Die ViewHelper f:page.headerData und f:page.footerData sind neu in TYPO3 14 und geben ungefiltert aus.
  • Der ViewHelper f:page.meta nutzt den MetaTagManager. Bereits gesetzte Tags überschreibt er nur mit replace.
  • Asset-ViewHelper brauchen immer einen identifier. Gleiche Kennung heißt: nur ein Asset.

Begriffe

AssetCollector
Sammelt CSS und JavaScript und gibt jedes Asset je Kennung nur einmal aus.
Crop Variant
Gespeicherter Zuschnitt eines Bilds mit eigenem Seitenverhältnis.
Deskriptor
Angabe hinter jeder Bild-URL im srcset, entweder eine Breite mit w oder eine Pixeldichte mit x.
FAL
File Abstraction Layer, die Dateiverwaltung von TYPO3 mit File- und FileReference-Objekten.
ICU
Bibliothek für lokalisierte Formate, deren Muster das Argument pattern nutzt.
MetaTagManager
API von TYPO3, die Meta-Tags aus TypoScript, PHP und Fluid verwaltet.
PageRenderer
Baut den Rahmen der HTML-Seite und nimmt Kopf- und Fußdaten auf.
record-transformation
Data Processor, der Rohdaten in ein Record-Objekt mit TCA-Wissen verwandelt.

Stand: 15. November 2026 (TYPO3 14.3 LTS)

Quellen:

  • ViewHelper-Referenz TYPO3 14.3 (format, render.text, image, image.srcset, link, uri, page, asset)
  • TYPO3 Explained 14.3, Kapitel Crop Variants und imageManipulation in der TCA-Referenz
  • Changelog TYPO3 14.0 bis 14.3 (f:page.headerData, f:page.footerData, f:page.meta, f:image.srcset, f:render.text, synchrones Zuschneiden, Argument csp, f:asset.styleAttr)
  • Quellcode TYPO3 14.3 (typo3/cms-fluid, typo3/cms-core, typo3/cms-backend) und Fluid 5, geprüft für Datum, render.text, Bilder, Zuschnitte, Links, Meta-Tags und AssetCollector
  • Lernzielkatalog TYPO3 CMS Certified Integrator 14 LTS, Kurs Fluid-ViewHelper

Diese Lernseite ist mit KI erstellt und gegen die Quellen geprüft.

Zertifikate & Prüfungen

Welche Prüfung kommt als Nächstes?

51 Prüfungen kannst du schon üben, über 16 stimmst du gerade ab. Sieh dir alle Zertifikate mit offiziellen Infos an, gib deine Stimme ab oder schlag deine Prüfung vor.

Zur Zertifikatsübersicht