diff --git a/CHANGELOG.md b/CHANGELOG.md index 197c8429..298126ae 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -12,6 +12,10 @@ ### Verbesserungen +- **Repeater-Decode mit Slot-ID** – `MFormRepeaterHelper::decode()` akzeptiert jetzt neben String-Payloads auch direkt numerische Value-Slots (z. B. `decode(1)`). +- **Klare API für Slot-basierten Zugriff** – neue Methode `MFormRepeaterHelper::decodeById(int $valueId)` für die direkte Auflösung über den REDAXO-Value-Slot. +- **Form Builder Output aktualisiert** – generierter Repeater-Output nutzt nun bevorzugt `MFormRepeaterHelper::decode()` statt `decode('REX_VALUE[...]')`. +- **Doku und Demo-Beispiele vereinheitlicht** – Repeater-Beispiele wurden auf die bevorzugte Slot-ID-Variante umgestellt, die alte String-Nutzung bleibt kompatibel. - **ColorSwatch-UX im Form Builder** – zusätzliche Hilfe im Eigenschaften-Panel, Beispiel-Palette per Klick und erweiterte Options-Syntax für CSS-Klassen-Swatches mit optionaler Preview-Farbe (z. B. `.text-primary=Primaer CSS|#2f77bc`). - **Palette-Suche im Form Builder** – Live-Filter über Feld- und Wrapper-Typen inkl. Alias-Suche (z. B. `color`, `alert`, `link`) und Leerzustand-Hinweis bei keinen Treffern. - **Schneller Fokus auf die Suche** – `/` fokussiert direkt das Suchfeld in der Palette. diff --git a/assets/js/flex-repeater.js b/assets/js/flex-repeater.js index 0be69667..d0248c50 100644 --- a/assets/js/flex-repeater.js +++ b/assets/js/flex-repeater.js @@ -259,16 +259,35 @@ const tag = field.tagName.toLowerCase(); if (tag === 'input') { if (field.type === 'checkbox') { - const normalized = typeof value === 'string' ? value.trim().toLowerCase() : value; - field.checked = !( - normalized === '' || - normalized === false || - normalized === 0 || - normalized === '0' || - normalized === 'false' || - normalized === 'off' || - normalized === 'no' - ); + if (typeof value === 'boolean') { + field.checked = value; + return; + } + + // Multi-Checkbox-Werte werden kommasepariert gespeichert (z. B. "1,2"). + let selectedValues = []; + if (Array.isArray(value)) { + selectedValues = value.map(function (v) { return String(v); }); + } else if (typeof value === 'string') { + const normalized = value.trim().toLowerCase(); + if ( + normalized !== '' && + normalized !== '0' && + normalized !== 'false' && + normalized !== 'off' && + normalized !== 'no' + ) { + selectedValues = value + .split(',') + .map(function (v) { return v.trim(); }) + .filter(function (v) { return v !== ''; }); + } + } else if (value !== 0 && value !== false && value !== '') { + selectedValues = [String(value)]; + } + + const currentValue = String(field.value || '1'); + field.checked = selectedValues.includes(currentValue); return; } if (field.type === 'radio') { @@ -299,12 +318,24 @@ */ function collectItemData(itemEl) { const data = {}; + const checkboxValues = {}; itemEl.querySelectorAll('[data-mfr-field]').forEach(function (field) { // Felder in nested Repeatern überspringen if (field.closest('.mfr-nested-repeater')) return; const key = field.dataset.mfrField; + + if (field.tagName.toLowerCase() === 'input' && field.type === 'checkbox') { + if (!Array.isArray(checkboxValues[key])) { + checkboxValues[key] = []; + } + if (field.checked) { + checkboxValues[key].push(String(field.value || '1')); + } + return; + } + const val = getFieldValue(field); if (val === null) { @@ -315,6 +346,10 @@ data[key] = val; }); + Object.keys(checkboxValues).forEach(function (key) { + data[key] = checkboxValues[key].join(','); + }); + // Nested Repeater itemEl.querySelectorAll(':scope .mfr-nested-repeater').forEach(function (nested) { if (nested.closest('.mfr-item') !== itemEl) return; // nur direkte Kind-Nested @@ -335,8 +370,20 @@ if (!list) return items; list.querySelectorAll(':scope > .mfr-nested-item').forEach(function (nestedItem) { const itemData = {}; + const checkboxValues = {}; nestedItem.querySelectorAll('[data-mfr-field]').forEach(function (field) { const key = field.dataset.mfrField; + + if (field.tagName.toLowerCase() === 'input' && field.type === 'checkbox') { + if (!Array.isArray(checkboxValues[key])) { + checkboxValues[key] = []; + } + if (field.checked) { + checkboxValues[key].push(String(field.value || '1')); + } + return; + } + const val = getFieldValue(field); if (val === null) { if (itemData[key] === undefined) itemData[key] = ''; @@ -344,6 +391,11 @@ } itemData[key] = val; }); + + Object.keys(checkboxValues).forEach(function (key) { + itemData[key] = checkboxValues[key].join(','); + }); + items.push(itemData); }); return items; diff --git a/assets/js/formbuilder.js b/assets/js/formbuilder.js index bf7acd9f..bbcef5b4 100644 --- a/assets/js/formbuilder.js +++ b/assets/js/formbuilder.js @@ -126,6 +126,7 @@ var state = []; var nextId = 1; + var STORAGE_KEY = 'mform.formbuilder.state.v1'; // Klassische REDAXO-Module haben pro Slot-Typ ein Limit von 20 (REX_VALUE / REX_MEDIA / REX_LINK / ...). // Der Builder vergibt fortlaufende IDs; ueber 20 hinaus werden Werte ggf. nicht mehr persistiert. var MAX_FIELD_ID = 20; @@ -256,6 +257,91 @@ return null; } + function isContainerType(type) { + return type === 'repeater' || type === 'tab' || type === 'fieldset' || type === 'modal'; + } + + function sanitizeItem(raw) { + if (!raw || !raw.type || !TYPES[raw.type]) { + return null; + } + + var item = JSON.parse(JSON.stringify(raw)); + item.uid = (typeof item.uid === 'string' && item.uid !== '') + ? item.uid + : ('fb-' + (Math.random().toString(36).slice(2, 8))); + + var parsedId = parseInt(item.id, 10); + item.id = Number.isFinite(parsedId) && parsedId > 0 ? parsedId : 1; + + if (isContainerType(item.type)) { + var children = Array.isArray(item.children) ? item.children : []; + item.children = children + .map(sanitizeItem) + .filter(function (child) { return child !== null; }); + } else { + item.children = null; + } + + return item; + } + + function collectMaxIdFromState(list) { + var max = 0; + (list || []).forEach(function (item) { + if (typeof item.id === 'number' && item.id > max) { + max = item.id; + } + if (Array.isArray(item.children)) { + var childMax = collectMaxIdFromState(item.children); + if (childMax > max) { + max = childMax; + } + } + }); + return max; + } + + function persistBuilderState() { + try { + window.localStorage.setItem(STORAGE_KEY, JSON.stringify({ state: state })); + } catch (_e) { + // ignore storage failures (private mode / blocked storage) + } + } + + function clearPersistedBuilderState() { + try { + window.localStorage.removeItem(STORAGE_KEY); + } catch (_e) { + // ignore storage failures + } + } + + function restoreBuilderState() { + try { + var raw = window.localStorage.getItem(STORAGE_KEY); + if (!raw) { + return; + } + + var parsed = JSON.parse(raw); + if (!parsed || !Array.isArray(parsed.state)) { + return; + } + + var restored = parsed.state + .map(sanitizeItem) + .filter(function (item) { return item !== null; }); + + state = restored; + nextId = collectMaxIdFromState(state) + 1; + activeItem = null; + } catch (_e) { + // ignore malformed persisted data + } + } + // Tree-aware: depth of the deepest nested repeater chain inside `item`. // Counts only repeater nesting (Tabs/Fieldsets sind UI-Wrapper und // zaehlen nicht als eigene Repeater-Ebene), aber traversiert dadurch). @@ -700,6 +786,7 @@ state = []; nextId = 1; activeItem = null; + clearPersistedBuilderState(); renderProps(); renderCanvas(); emitCode(); @@ -1177,8 +1264,9 @@ function emitCode() { if (state.length === 0) { - setCodeText($code, '// Noch keine Felder hinzugefuegt.'); - setCodeText($output, '// Noch keine Felder hinzugefuegt.'); + setCodeText($code, '_normalized` hinzu $items = MFormOutputHelper::normalizeRepeaterItems($items, ['link', 'cta']); diff --git a/docs/07_repeater.md b/docs/07_repeater.md index 453f450b..6811d614 100644 --- a/docs/07_repeater.md +++ b/docs/07_repeater.md @@ -42,7 +42,7 @@ echo $mform->show(); use FriendsOfRedaxo\MForm\Repeater\MFormRepeaterHelper; // decode() filtert deaktivierte Items und entfernt __disabled automatisch -$items = MFormRepeaterHelper::decode('REX_VALUE[2]'); +$items = MFormRepeaterHelper::decode(2); ?>

REX_VALUE[1]

@@ -64,12 +64,12 @@ Ab Version 9 gibt es eine Kurzform für das Auslesen von Repeater-Werten: | Methode | Verwendung | |---------|-----------| -| `decode(string $rexValue)` | **Empfohlen** – übernimmt JSON-Dekodierung, Entity-Dekodierung und Item-Filterung in einem Schritt. | +| `decode(int\|string $source)` | **Empfohlen** – übernimmt Slot-Auflösung (bei `int`) sowie JSON-/Entity-Dekodierung und Item-Filterung in einem Schritt. | | `prepareItemsForOutput(array $items)` | Wenn der Array bereits dekodiert vorliegt (z. B. aus einer DB-Abfrage). | ```php // Neu (v9): kürzeste Form im Modul-Output -$rows = MFormRepeaterHelper::decode('REX_VALUE[id=1]'); +$rows = MFormRepeaterHelper::decode(1); // Äquivalent mit prepareItemsForOutput (v8-kompatibel) $raw = json_decode(html_entity_decode('REX_VALUE[id=1]', ENT_QUOTES | ENT_HTML5, 'UTF-8'), true) ?? []; @@ -86,7 +86,7 @@ Nach dem Dekodieren stehen weitere Hilfsmethoden für typische Ausgabeszenarien show();

@@ -413,7 +413,7 @@ echo $mform->show(); use FriendsOfRedaxo\MForm\Repeater\MFormRepeaterHelper; use FriendsOfRedaxo\MForm\Utils\MFormOutputHelper; -$items = MFormRepeaterHelper::decode('REX_VALUE[1]'); +$items = MFormRepeaterHelper::decode(1); // Einheitliche Link-Normalisierung fuer Repeater + Nicht-Repeater-Formate $items = MFormOutputHelper::normalizeRepeaterItems($items, ['link']); diff --git a/docs/08_mblock_migration.md b/docs/08_mblock_migration.md index 4243b009..f785085b 100644 --- a/docs/08_mblock_migration.md +++ b/docs/08_mblock_migration.md @@ -62,7 +62,7 @@ echo MForm::factory() ' . rex_escape($item['title'] ?? '') . ''; @@ -85,7 +85,7 @@ Beim Auslesen von Custom-Link-Feldern aus Repeater-Items kann der Wert je nach K use FriendsOfRedaxo\MForm\Repeater\MFormRepeaterHelper; use FriendsOfRedaxo\MForm\Utils\MFormOutputHelper; -$items = MFormRepeaterHelper::decode('REX_VALUE[id=1]'); +$items = MFormRepeaterHelper::decode(1); // Option A: Normalisierung pro Link-Feld direkt bei der Ausgabe foreach ($items as $item) { @@ -519,7 +519,7 @@ echo $main->show(); use FriendsOfRedaxo\MForm\Repeater\MFormRepeaterHelper; use FriendsOfRedaxo\MForm\Utils\MFormOutputHelper; -$cards = MFormRepeaterHelper::decode('REX_VALUE[id=1]'); +$cards = MFormRepeaterHelper::decode(1); foreach ($cards as $card) { $title = (string) ($card['header'] ?? ''); diff --git a/docs/11_tutorial_modul.md b/docs/11_tutorial_modul.md index e2af3da5..ad02983a 100644 --- a/docs/11_tutorial_modul.md +++ b/docs/11_tutorial_modul.md @@ -220,7 +220,7 @@ use FriendsOfRedaxo\MForm\Repeater\MFormRepeaterHelper; // MFormRepeaterHelper::decode() wandelt das gespeicherte JSON in ein PHP-Array um. // Das Ergebnis ist eine Liste von Blöcken – jeder Block ein assoziatives Array. -$blocks = MFormRepeaterHelper::decode('REX_VALUE[id=1]'); +$blocks = MFormRepeaterHelper::decode(1); foreach ($blocks as $block) { $image = (string) ($block['image'] ?? ''); @@ -282,7 +282,7 @@ echo MForm::factory() '; @@ -374,7 +374,7 @@ $title = 'REX_VALUE[id=1]'; $subtitle = 'REX_VALUE[id=2]'; // REX_MEDIALIST liefert eine kommaseparierte Liste von Dateinamen (für mehrere Bilder). $headerImages = array_filter(explode(',', 'REX_MEDIALIST[id=3]')); -$blocks = MFormRepeaterHelper::decode('REX_VALUE[id=4]'); +$blocks = MFormRepeaterHelper::decode(4); $ctaValue = 'REX_VALUE[id=5]'; // ── Seitenkopf ──────────────────────────────────────────────────────────────── diff --git a/docs/13_api_reference.md b/docs/13_api_reference.md index 620d4964..afb46733 100644 --- a/docs/13_api_reference.md +++ b/docs/13_api_reference.md @@ -756,13 +756,13 @@ Statische Hilfsmethoden für die Verarbeitung von Repeater-Daten im Modul-Output ### Methoden ```php -MFormRepeaterHelper::decode(string $rexValue): array +MFormRepeaterHelper::decode(int|string $source): array ``` -**Hauptmethode für die Ausgabe.** Dekodiert einen REX_VALUE-String und gibt bereinigte, aktive Items zurück. Filtert automatisch deaktivierte Items heraus. +**Hauptmethode für die Ausgabe.** Dekodiert Repeater-Daten und gibt bereinigte, aktive Items zurück. Filtert automatisch deaktivierte Items heraus. ```php // Modul-Output: -$rows = MFormRepeaterHelper::decode('REX_VALUE[id=1 output="html"]'); +$rows = MFormRepeaterHelper::decode(1); foreach ($rows as $row) { echo $row['title']; } @@ -911,7 +911,7 @@ Normalisiert Link-Felder in Repeater-Items. Fügt standardmäßig `_norma | `$options['replace']` | `bool` | `true`: Original-Feld überschreiben (default: `false`) | ```php -$rows = MFormRepeaterHelper::decode('REX_VALUE[id=1 output="html"]'); +$rows = MFormRepeaterHelper::decode(1); $rows = MFormOutputHelper::normalizeRepeaterItems($rows, ['link', 'image']); // Jetzt: $row['link_normalized']['customlink_url'] ``` @@ -1169,7 +1169,7 @@ $headline = 'REX_VALUE[id=1]'; $text = 'REX_VALUE[id=2 output="html"]'; $image = 'REX_VALUE[id=3]'; $layout = 'REX_VALUE[id=4]'; -$items = MFormRepeaterHelper::decode('REX_VALUE[id=5 output="html"]'); +$items = MFormRepeaterHelper::decode(5); // Items filtern, sortieren $items = MFormRepeaterHelper::sortByField($items, 'title'); diff --git a/docs/14_fragments_output.md b/docs/14_fragments_output.md index b99187fe..52c0322b 100644 --- a/docs/14_fragments_output.md +++ b/docs/14_fragments_output.md @@ -32,7 +32,7 @@ use FriendsOfRedaxo\MForm\Repeater\MFormRepeaterHelper; use FriendsOfRedaxo\MForm\Utils\MFormOutputHelper; $headline = 'REX_VALUE[id=1]'; -$items = MFormRepeaterHelper::decode('REX_VALUE[id=2 output="html"]'); +$items = MFormRepeaterHelper::decode(2); // Link-Felder in Repeater-Items vereinheitlichen $items = MFormOutputHelper::normalizeRepeaterItems($items, ['link']); @@ -105,7 +105,7 @@ use FriendsOfRedaxo\MFragment; use FriendsOfRedaxo\MFragment\Components\Bootstrap\Card; use FriendsOfRedaxo\MFragment\Components\Default\Figure; -$rows = MFormRepeaterHelper::decode('REX_VALUE[id=2 output="html"]'); +$rows = MFormRepeaterHelper::decode(2); $rows = MFormOutputHelper::normalizeRepeaterItems($rows, ['link']); $grid = MFragment::factory()->addClass('row g-4'); @@ -188,7 +188,7 @@ Modul-Output: use FriendsOfRedaxo\MForm\Repeater\MFormRepeaterHelper; -$rows = MFormRepeaterHelper::decode('REX_VALUE[id=3 output="html"]'); +$rows = MFormRepeaterHelper::decode(3); foreach ($rows as $row) { $item = new rex_fragment(); diff --git a/lib/MForm/Repeater/MFormRepeaterHelper.php b/lib/MForm/Repeater/MFormRepeaterHelper.php index 0485adb7..0b83603e 100644 --- a/lib/MForm/Repeater/MFormRepeaterHelper.php +++ b/lib/MForm/Repeater/MFormRepeaterHelper.php @@ -264,19 +264,24 @@ public static function filterEnabledItems(array $items): array } /** - * Decodes a REX_VALUE JSON string and returns only enabled repeater items. + * Decodes repeater payload and returns only enabled items. * * Use this in module output code instead of rex_var::toArray() to automatically * filter out disabled (offline) items and strip the internal __disabled key. * * Example: - * $rows = MFormRepeaterHelper::decode('REX_VALUE[id=1]'); + * $rows = MFormRepeaterHelper::decode(1); * - * @param string $rexValue The raw REX_VALUE string (already substituted by REDAXO) + * @param int|string $source Either a value-slot id (e.g. 1) or a raw JSON payload * @return array> Filtered and cleaned items */ - public static function decode(string $rexValue): array + public static function decode(int|string $source): array { + if (is_int($source)) { + return self::decodeById($source); + } + + $rexValue = $source; if ('' === $rexValue) { return []; } @@ -294,6 +299,53 @@ public static function decode(string $rexValue): array return self::prepareItemsForOutput($decoded); } + /** + * Decodes repeater data from the current slice by value slot id. + * + * @param int $valueId ID des Value-Slots, dessen Repeater-Daten dekodiert werden sollen. + * @return array> + */ + public static function decodeById(int $valueId): array + { + if ($valueId <= 0 || $valueId > 20 || !class_exists('rex_article_slice')) { + return []; + } + + $slice = self::findCurrentSlice(); + if (!$slice instanceof \rex_article_slice) { + return []; + } + + $raw = $slice->getValue($valueId); + if (!is_string($raw) || '' === $raw) { + return []; + } + + return self::decode($raw); + } + + private static function findCurrentSlice(): ?\rex_article_slice + { + foreach (debug_backtrace(DEBUG_BACKTRACE_PROVIDE_OBJECT) as $frame) { + $object = $frame['object'] ?? null; + if (!is_object($object) || !method_exists($object, 'getCurrentSlice')) { + continue; + } + + try { + $slice = $object->getCurrentSlice(); + } catch (\Throwable) { + continue; + } + + if ($slice instanceof \rex_article_slice) { + return $slice; + } + } + + return null; + } + /** * @param array> $items * @return array> diff --git a/pages/module/base/select/output.inc b/pages/module/base/select/output.inc index 2c117b76..abfcbcc3 100644 --- a/pages/module/base/select/output.inc +++ b/pages/module/base/select/output.inc @@ -1,3 +1,3 @@ '; @@ -38,7 +38,7 @@ if (!empty($items)) { } // --- Einfacher Flex Repeater --- -$simpleItems = MFormRepeaterHelper::decode('REX_VALUE[id=2]'); +$simpleItems = MFormRepeaterHelper::decode(2); if (!empty($simpleItems)) { echo '
    '; diff --git a/pages/module/repeater/nested_repeater/output.inc b/pages/module/repeater/nested_repeater/output.inc index 2c117b76..abfcbcc3 100644 --- a/pages/module/repeater/nested_repeater/output.inc +++ b/pages/module/repeater/nested_repeater/output.inc @@ -1,3 +1,3 @@

    REX_VALUE[1]

    diff --git a/pages/module/repeater/widgets_repeater/output.inc b/pages/module/repeater/widgets_repeater/output.inc index cdeb450d..77330592 100644 --- a/pages/module/repeater/widgets_repeater/output.inc +++ b/pages/module/repeater/widgets_repeater/output.inc @@ -1,2 +1,2 @@