TYPO3 v15 dev-main snapshot ()

2026-08-10 22:31:24 +02:00
commit aad9daaefd
1506 changed files with 94005 additions and 0 deletions
@@ -0,0 +1,93 @@
+<?php
+
+declare(strict_types=1);
+
+/*
+ * This file is part of the TYPO3 CMS project.
+ *
+ * It is free software; you can redistribute it and/or modify it under
+ * the terms of the GNU General Public License, either version 2
+ * of the License, or any later version.
+ *
+ * For the full copyright and license information, please read the
+ * LICENSE.txt file that was distributed with this source code.
+ *
+ * The TYPO3 project - inspiring people to share!
+ */
+
+namespace TYPO3\CMS\Form\ViewHelpers;
+
+use TYPO3\CMS\Form\Domain\Model\Renderable\RootRenderableInterface;
+use TYPO3\CMS\Form\Domain\Runtime\FormRuntime;
+use TYPO3\CMS\Form\Service\TranslationService;
+use TYPO3Fluid\Fluid\Core\ViewHelper\AbstractViewHelper;
+use TYPO3Fluid\Fluid\Core\ViewHelper\InvalidArgumentValueException;
+
+/**
+ * Translate form element properties.
+ *
+ * Scope: frontend / backend
+ *
+ * @see https://docs.typo3.org/permalink/t3viewhelper:typo3-form-translateelementproperty
+ */
+final class TranslateElementPropertyViewHelper extends AbstractViewHelper
+{
+    public function __construct(
+        private readonly TranslationService $translationService
+    ) {}
+
+    public function initializeArguments(): void
+    {
+        $this->registerArgument('element', RootRenderableInterface::class, 'Form Element to translate', true);
+        $this->registerArgument('property', 'mixed', 'Property to translate');
+        $this->registerArgument('renderingOptionProperty', 'mixed', 'Property to translate');
+        $this->registerArgument('languageKey', 'string', 'Language key ("da" for example) or "default" to use. Also a Locale object is possible. If empty, use current locale from the request.');
+    }
+
+    /**
+     * Return array element by key.
+     */
+    public function render(): array|string|null
+    {
+        self::assertArgumentTypes($this->arguments);
+        $element = $this->arguments['element'];
+        $property = null;
+        if (!empty($this->arguments['property'])) {
+            $property = $this->arguments['property'];
+        } elseif (!empty($this->arguments['renderingOptionProperty'])) {
+            $property = $this->arguments['renderingOptionProperty'];
+        }
+        if (empty($property)) {
+            $propertyParts = [];
+        } elseif (is_array($property)) {
+            $propertyParts = $property;
+        } else {
+            $propertyParts = [$property];
+        }
+        /** @var FormRuntime $formRuntime */
+        $formRuntime = $this->renderingContext
+            ->getViewHelperVariableContainer()
+            ->get(RenderRenderableViewHelper::class, 'formRuntime');
+        return $this->translationService->translateFormElementValue($element, $propertyParts, $formRuntime, $this->arguments['languageKey']);
+    }
+
+    private static function assertArgumentTypes(array $arguments): void
+    {
+        foreach (['property', 'renderingOptionProperty'] as $argumentName) {
+            if (
+                !isset($arguments[$argumentName])
+                || is_string($arguments[$argumentName])
+                || is_array($arguments[$argumentName])
+            ) {
+                continue;
+            }
+            throw new InvalidArgumentValueException(
+                sprintf(
+                    'Arguments "%s" either must be string or array',
+                    $argumentName
+                ),
+                1504871830
+            );
+        }
+    }
+}