Attention

TYPO3 v10 has reached end-of-life as of April 30th 2023 and is no longer being maintained. Use the version switcher on the top left of this page to select documentation for a supported version of TYPO3.

Need more time before upgrading? You can purchase Extended Long Term Support (ELTS) for TYPO3 v10 here: TYPO3 ELTS.

switch

Switch view helper which can be used to render content depending on a value or expression. Implements what a basic switch()-PHP-method does.

An optional default case can be specified which is rendered if none of the "f:case" conditions matches.

= Examples =

<code title="Simple Switch statement"> <f:switch expression="{person.gender}">

<f:case value="male">Mr.</f:case> <f:case value="female">Mrs.</f:case> <f:defaultCase>Mr. / Mrs.</f:defaultCase>

</f:switch> </code> <output> "Mr.", "Mrs." or "Mr. / Mrs." (depending on the value of {person.gender}) </output>

Note: Using this view helper can be a sign of weak architecture. If you end up using it extensively you might want to consider restructuring your controllers/actions and/or use partials and sections. E.g. the above example could be achieved with <f:render partial="title.{person.gender}" /> and the partials "title.male.html", "title.female.html", ... Depending on the scenario this can be easier to extend and possibly contains less duplication.

Arguments

expression

DataType

mixed

Required

true

Description

Expression to switch