ViewHelper `, * multiple slots can be used in one component. * * If a slot is defined, this ViewHelper will always attempt to return a string, * regardless of the original type of the content. If a slot is not defined, the * ViewHelper will return ``null``. * * Basic Example * ============= * * If the following template ``Text.html``: * * .. code-block:: xml * :emphasize-lines: 6 * * * *
*

{title}

*
* *
*
* * is rendered with the following component call: * * .. code-block:: xml * * *

My first paragraph

*

My second paragraph

* * * it will result in the following output: * * .. code-block:: xml * *
*

My title

*
*

My first paragraph

*

My second paragraph

*
*
* * Escaping Example * ================ * * If the same component is called like this: * * .. code-block:: xml * * *

My first paragraph

*

My second paragraph

* * {htmlString} * * it would result in escaped HTML: * * .. code-block:: xml * *
*

My title

*
* <p>My first paragraph</p> * <p>My second paragraph</p> *
*
* * If you want to avoid escaping in this use case, you need to use ``f:format.raw`` on * the variable when it's passed to the component. Please be aware that depending on * the source of the input, this might have security implications! * * Component Nesting Example * ========================= * * Nesting of multiple components is possible. The following template ``Paragraphs.html``: * * .. code-block:: xml * *

My first paragraph

*

My second paragraph

* * can be called as a component and nested into the text component described above: * * .. code-block:: xml * * * * * * which would lead to unescaped output, since components are always expected to return HTML: * * .. code-block:: xml * *
*

My title

*
*

My first paragraph

*

My second paragraph

*
*
* * Multiple Named Slots * ==================== * * If the following template ``TextMedia.html``: * * .. code-block:: xml * :emphasize-lines: 6,9 * * * *
*

{title}

*
* *
*
* *
*
* * is rendered with the following component call: * * .. code-block:: xml * * * * ... * * *

My first paragraph

*

My second paragraph

* * * * it will result in the following output: * * .. code-block:: xml * *
*

My title

*
* ... *
*
*

My first paragraph

*

My second paragraph

*
*
* * @api * @see https://docs.typo3.org/permalink/fluid:typo3fluid-fluid-slot */ final class SlotViewHelper extends AbstractViewHelper implements ViewHelperNodeInitializedEventInterface { public const DEFAULT_SLOT = 'default'; /** * @var bool */ protected $escapeOutput = false; public function initializeArguments(): void { $this->registerArgument('name', 'string', 'Name of the slot, can be omitted for default slot', false, self::DEFAULT_SLOT); } public function render(): ?string { $variableContainer = $this->renderingContext->getViewHelperVariableContainer(); $slot = $variableContainer->get(self::class, $this->arguments['name']); return is_callable($slot) ? (string)$slot() : null; } public static function nodeInitializedEvent(ViewHelperNode $node, array $arguments, ParsingState $parsingState): void { // Collect available slots of current template in ParsingState // This allows to extract template metadata without triggering a // full rendering of the template $slotName = isset($arguments['name']) && $arguments['name'] instanceof NodeInterface ? (string)$arguments['name']->evaluate(new RenderingContext()) : self::DEFAULT_SLOT; if (!in_array($slotName, $parsingState->getAvailableSlots())) { $parsingState->setAvailableSlots([...$parsingState->getAvailableSlots(), $slotName]); } } }