[TASK] Streamline phpdoc annotations in EXT:fluid
[Packages/TYPO3.CMS.git] / typo3 / sysext / fluid / Classes / ViewHelpers / FlashMessagesViewHelper.php
index ec90d3d..bb106a9 100644 (file)
@@ -13,7 +13,12 @@ namespace TYPO3\CMS\Fluid\ViewHelpers;
  *
  * The TYPO3 project - inspiring people to share!
  */
-use TYPO3\CMS\Fluid\Core\ViewHelper\AbstractTagBasedViewHelper;
+
+use TYPO3\CMS\Core\Messaging\FlashMessageRendererResolver;
+use TYPO3\CMS\Core\Utility\GeneralUtility;
+use TYPO3Fluid\Fluid\Core\Rendering\RenderingContextInterface;
+use TYPO3Fluid\Fluid\Core\ViewHelper\AbstractViewHelper;
+use TYPO3Fluid\Fluid\Core\ViewHelper\Traits\CompileWithRenderStatic;
 
 /**
  * View helper which renders the flash messages (if there are any) as an unsorted list.
@@ -27,16 +32,7 @@ use TYPO3\CMS\Fluid\Core\ViewHelper\AbstractTagBasedViewHelper;
  * <f:flashMessages />
  * </code>
  * <output>
- * An ul-list of flash messages.
- * </output>
- *
- * <code title="Output with custom css class">
- * <f:flashMessages class="specialClass" />
- * </code>
- * <output>
- * <div class="specialClass">
- * ...
- * </ul>
+ * A list of flash messages.
  * </output>
  *
  * <code title="TYPO3 core style">
@@ -80,26 +76,23 @@ use TYPO3\CMS\Fluid\Core\ViewHelper\AbstractTagBasedViewHelper;
  * <code title="Using a specific queue">
  * <f:flashMessages queueIdentifier="myQueue" />
  * </code>
- *
- * @api
  */
-class FlashMessagesViewHelper extends AbstractTagBasedViewHelper
+class FlashMessagesViewHelper extends AbstractViewHelper
 {
+    use CompileWithRenderStatic;
+
     /**
-     * @var string
+     * ViewHelper outputs HTML therefore output escaping has to be disabled
+     *
+     * @var bool
      */
-    protected $tagName = 'div';
+    protected $escapeOutput = false;
 
     /**
      * Initialize arguments
-     *
-     * @return void
-     * @api
      */
     public function initializeArguments()
     {
-        parent::initializeArguments();
-        $this->registerUniversalTagAttributes();
         $this->registerArgument('queueIdentifier', 'string', 'Flash-message queue to use');
         $this->registerArgument('as', 'string', 'The name of the current flashMessage variable for rendering inside');
     }
@@ -110,61 +103,29 @@ class FlashMessagesViewHelper extends AbstractTagBasedViewHelper
      * from being cached.
      *
      * @see \TYPO3\CMS\Frontend\Controller\TypoScriptFrontendController::no_cache
-     * @return string rendered Flash Messages, if there are any.
-     * @api
+     * @param array $arguments
+     * @param \Closure $renderChildrenClosure
+     * @param RenderingContextInterface $renderingContext
+     * @return mixed
      */
-    public function render()
+    public static function renderStatic(array $arguments, \Closure $renderChildrenClosure, RenderingContextInterface $renderingContext)
     {
-        $as = $this->arguments['as'];
-        $queueIdentifier = isset($this->arguments['queueIdentifier']) ? $this->arguments['queueIdentifier'] : null;
-        $flashMessages = $this->renderingContext->getControllerContext()->getFlashMessageQueue($queueIdentifier)->getAllMessagesAndFlush();
+        $as = $arguments['as'];
+        $queueIdentifier = $arguments['queueIdentifier'] ?? null;
+        $flashMessages = $renderingContext->getControllerContext()
+            ->getFlashMessageQueue($queueIdentifier)->getAllMessagesAndFlush();
         if ($flashMessages === null || count($flashMessages) === 0) {
             return '';
         }
 
         if ($as === null) {
-            $content = $this->renderDefault($flashMessages);
-        } else {
-            $content = $this->renderFromTemplate($flashMessages, $as);
-        }
-
-        return $content;
-    }
-
-    /**
-     * Renders the flash messages as unordered list
-     *
-     * @param array $flashMessages \TYPO3\CMS\Core\Messaging\FlashMessage[]
-     * @return string
-     */
-    protected function renderDefault(array $flashMessages)
-    {
-        $flashMessagesClass = $this->hasArgument('class') ? $this->arguments['class'] : 'typo3-messages';
-        $tagContent = '';
-        $this->tag->addAttribute('class', $flashMessagesClass);
-        /** @var $singleFlashMessage \TYPO3\CMS\Core\Messaging\FlashMessage */
-        foreach ($flashMessages as $singleFlashMessage) {
-            $tagContent .= $singleFlashMessage->getMessageAsMarkup();
+            return GeneralUtility::makeInstance(FlashMessageRendererResolver::class)
+                ->resolve()
+                ->render($flashMessages);
         }
-        $this->tag->setContent($tagContent);
-        return $this->tag->render();
-    }
-
-    /**
-     * Renders the flash messages as nested divs
-     * Defer the rendering of Flash Messages to the template. In this case,
-     * the flash messages are stored in the template inside the variable specified
-     * in "as".
-     *
-     * @param array $flashMessages \TYPO3\CMS\Core\Messaging\FlashMessage[]
-     * @param string $as
-     * @return string
-     */
-    protected function renderFromTemplate(array $flashMessages, $as)
-    {
-        $templateVariableContainer = $this->renderingContext->getTemplateVariableContainer();
+        $templateVariableContainer = $renderingContext->getVariableProvider();
         $templateVariableContainer->add($as, $flashMessages);
-        $content = $this->renderChildren();
+        $content = $renderChildrenClosure();
         $templateVariableContainer->remove($as);
 
         return $content;