This is a section. {foo}
*
*
* Output::
*
* the content of the section "someSection". The content of the variable {someVariable} will be available in the partial as {foo}
*
* Rendering recursive sections
* ----------------------------
*
* ::
*
*
*
*
* -
* {menuItem.text}
*
*
*
*
*
*
*
*
*
* Output::
*
*
* - menu1
*
*
* [...]
* (depending on the value of {menu})
*
* @api
* @see https://docs.typo3.org/permalink/fluid:typo3fluid-fluid-section
*/
class SectionViewHelper extends AbstractViewHelper implements ViewHelperNodeInitializedEventInterface
{
/**
* @var bool
*/
protected $escapeOutput = false;
/**
* Initialize the arguments.
*
* @api
*/
public function initializeArguments()
{
$this->registerArgument('name', 'string', 'Name of the section', true);
}
/**
* Rendering directly returns all child nodes.
*
* @return string HTML String of all child nodes.
* @api
*/
public function render()
{
$content = '';
if ($this->viewHelperVariableContainer->exists(SectionViewHelper::class, 'isCurrentlyRenderingSection')) {
$this->viewHelperVariableContainer->remove(SectionViewHelper::class, 'isCurrentlyRenderingSection');
$content = $this->renderChildren();
}
return $content;
}
/**
* This VH does not ever output anything as such: Sections are
* handled differently in the compiler / parser and the f:render
* VH invokes section body execution.
* We optimize compilation to always return an empty here.
*/
final public function convert(TemplateCompiler $templateCompiler): array
{
return [
'initialization' => '',
'execution' => '\'\'',
];
}
/**
* Save the associated ViewHelper node in a static public class variable.
* called directly after the ViewHelper was built.
*
* @param array $arguments Unevaluated ViewHelper arguments
*/
public static function nodeInitializedEvent(ViewHelperNode $node, array $arguments, ParsingState $parsingState): void
{
$variableContainer = $parsingState->getVariableContainer();
$nameArgument = $arguments['name'];
$sectionName = $nameArgument->evaluate(new RenderingContext());
$sections = $variableContainer[TemplateCompiler::SECTIONS_VARIABLE] ? $variableContainer[TemplateCompiler::SECTIONS_VARIABLE] : [];
$sections[$sectionName] = $node;
$variableContainer[TemplateCompiler::SECTIONS_VARIABLE] = $sections;
}
}