TYPO3 v15 dev-main snapshot ()

2026-08-10 22:31:00 +02:00
commit f9941541b7
1178 changed files with 135377 additions and 0 deletions
@@ -0,0 +1,73 @@
+<?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\Backend\Form\Behavior;
+
+use TYPO3\CMS\Core\Crypto\HashService;
+use TYPO3\CMS\Core\Utility\GeneralUtility;
+
+trait OnFieldChangeTrait
+{
+    /**
+     * @param OnFieldChangeInterface[] $items `fieldChangeFunc` items
+     * @return array<int, array>
+     */
+    protected function getOnFieldChangeItems(array $items): array
+    {
+        if ($items === []) {
+            return [];
+        }
+        return array_map(
+            static function (OnFieldChangeInterface $item): array {
+                return $item->toArray();
+            },
+            array_values($items)
+        );
+    }
+
+    /**
+     * @param string $event target client event, either `change` or `click`
+     * @param list<OnFieldChangeInterface> $items `fieldChangeFunc` items
+     * @return array<string, string> HTML attrs, not encoded - consumers MUST encode with `htmlspecialchars`
+     */
+    protected function getOnFieldChangeAttrs(string $event, array $items): array
+    {
+        if ($items === []) {
+            return [];
+        }
+        $onFieldChangeItems = $this->getOnFieldChangeItems($items);
+        return [
+            'data-formengine-field-change-event' => $event,
+            'data-formengine-field-change-items' => GeneralUtility::jsonEncodeForHtmlAttribute($onFieldChangeItems, false),
+        ];
+    }
+
+    /**
+     * Forwards URL query params for `LinkBrowserController`
+     * @param list<OnFieldChangeInterface> $items `fieldChangeFunc` items
+     * @return array{fieldChangeFunc: array<int, array>, fieldChangeFuncHash: string} relevant URL query params for `LinkBrowserController`
+     */
+    protected function forwardOnFieldChangeQueryParams(array $items): array
+    {
+        $func = $this->getOnFieldChangeItems($items);
+        $hashService = GeneralUtility::makeInstance(HashService::class);
+        return [
+            'fieldChangeFunc' => $func,
+            'fieldChangeFuncHash' => $hashService->hmac(serialize($func), 'backend-link-browser'),
+        ];
+    }
+}