From f442c2ad3d5f66f34d34e40c9feae1205245a462 Mon Sep 17 00:00:00 2001 From: Thomas Skerbis Date: Thu, 21 May 2026 22:00:57 +0200 Subject: [PATCH 01/18] Feature: ID-freie Tabs mit optional modernem und vertikalem Layout (9.1.0, #401) --- CHANGELOG.md | 20 ++- assets/css/mform.css | 132 ++++++++++++++++++ assets/mform.js | 47 ++++++- assets/repeater.js | 47 ++++++- docs/05_wrapper.md | 31 ++++ docs/07_repeater.md | 6 +- docs/13_api_reference.md | 6 + fragments/mform/mform_wrapper.php | 4 +- .../MFormFlexRepeaterRenderer.php | 27 ++-- lib/MForm/MFormElements.php | 10 ++ lib/MForm/Parser/MFormParser.php | 12 ++ package.yml | 2 +- 12 files changed, 313 insertions(+), 31 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 8c7ef332..b7f8fa60 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,6 +1,22 @@ # MForm - REDAXO Addon für Modul-Input-Formulare -# -# Version 9.0.1 + +## Version 9.1.0 + +### Neu + +- **Tabs als ID-freie Implementierung** – `addTabElement()` funktioniert jetzt stabil in verschachtelten und dynamischen Kontexten (z. B. FlexRepeater, Fieldset, Collapse, Modal), ohne Bootstrap-ID-Verkabelung und ohne Kollisionen zwischen geklonten Instanzen. +- **Optionale Tab-Modernisierung** – Tab-Navigation kann optional als modernisierte Variante gerendert werden über `tab-style => 'modern'` bzw. `data-group-tab-style => 'modern'`. +- **Optionale vertikale Tab-Navigation** – Tabs können optional links neben dem Inhalt dargestellt werden über `tab-layout => 'vertical'` bzw. `data-group-tab-layout => 'vertical'` (inkl. Mobile-Fallback auf gestapelte Ansicht). +- **Font-Awesome-Icons je Tab** – Icon-Unterstützung über `tab-icon` bleibt erhalten und funktioniert weiterhin in den neuen Tab-Varianten. + +### Kompatibilität + +- Standardverhalten bleibt unverändert: Ohne neue Attribute bleiben Tabs visuell und funktional wie bisher. +- Bestehende Module mit `addTabElement()` bleiben kompatibel. + +--- + +## Version 9.0.1 ### Behoben diff --git a/assets/css/mform.css b/assets/css/mform.css index 774b8ad9..9a2b792b 100755 --- a/assets/css/mform.css +++ b/assets/css/mform.css @@ -29,6 +29,116 @@ background: #fff; } +.mform .mform-tabs { + --mform-tab-nav-bg: #f7f9fc; + --mform-tab-nav-border: #dfe5ee; + --mform-tab-content-bg: #ffffff; + --mform-tab-content-border: #dfe5ee; + --mform-tab-link-color: #48586b; + --mform-tab-link-active-bg: #ffffff; + --mform-tab-link-active-color: #1d2e40; + --mform-tab-link-hover-bg: #eef3f8; +} + +.mform .mform-tabs.mform-tabs--modern > .nav-tabs { + border-bottom: 1px solid var(--mform-tab-nav-border); + background: var(--mform-tab-nav-bg); + padding: 6px 6px 0; +} + +.mform .mform-tabs.mform-tabs--modern > .nav-tabs > li > a { + border-radius: 8px 8px 0 0; + border: 1px solid transparent; + color: var(--mform-tab-link-color); + transition: background-color .2s ease, color .2s ease, border-color .2s ease; +} + +.mform .mform-tabs.mform-tabs--modern > .nav-tabs > li > a:hover, +.mform .mform-tabs.mform-tabs--modern > .nav-tabs > li > a:focus { + background: var(--mform-tab-link-hover-bg); + color: var(--mform-tab-link-active-color); +} + +.mform .mform-tabs.mform-tabs--modern > .nav-tabs > li.active > a, +.mform .mform-tabs.mform-tabs--modern > .nav-tabs > li.active > a:hover, +.mform .mform-tabs.mform-tabs--modern > .nav-tabs > li.active > a:focus { + background: var(--mform-tab-link-active-bg); + border-color: var(--mform-tab-content-border) var(--mform-tab-content-border) var(--mform-tab-link-active-bg); + color: var(--mform-tab-link-active-color); +} + +.mform .mform-tabs.mform-tabs--modern > .tab-content { + border: 1px solid var(--mform-tab-content-border); + border-top: 0; + background: var(--mform-tab-content-bg); +} + +.mform .mform-tabs.mform-tabs--vertical { + display: flex; + align-items: stretch; +} + +.mform .mform-tabs.mform-tabs--vertical > .nav-tabs { + width: 240px; + min-width: 240px; + border-bottom: 0; + border-right: 1px solid var(--mform-tab-nav-border); + background: var(--mform-tab-nav-bg); + padding: 8px; +} + +.mform .mform-tabs.mform-tabs--vertical > .nav-tabs > li { + float: none; + width: 100%; + margin-bottom: 4px; +} + +.mform .mform-tabs.mform-tabs--vertical > .nav-tabs > li > a { + margin-right: 0; + border-radius: 6px; + border: 1px solid transparent; + color: var(--mform-tab-link-color); +} + +.mform .mform-tabs.mform-tabs--vertical > .nav-tabs > li > a:hover, +.mform .mform-tabs.mform-tabs--vertical > .nav-tabs > li > a:focus { + background: var(--mform-tab-link-hover-bg); + color: var(--mform-tab-link-active-color); +} + +.mform .mform-tabs.mform-tabs--vertical > .nav-tabs > li.active > a, +.mform .mform-tabs.mform-tabs--vertical > .nav-tabs > li.active > a:hover, +.mform .mform-tabs.mform-tabs--vertical > .nav-tabs > li.active > a:focus { + background: var(--mform-tab-link-active-bg); + border-color: var(--mform-tab-content-border); + color: var(--mform-tab-link-active-color); +} + +.mform .mform-tabs.mform-tabs--vertical > .tab-content { + flex: 1; + border: 1px solid var(--mform-tab-content-border); + border-left: 0; + background: var(--mform-tab-content-bg); +} + +@media (max-width: 767px) { + .mform .mform-tabs.mform-tabs--vertical { + display: block; + } + + .mform .mform-tabs.mform-tabs--vertical > .nav-tabs { + width: auto; + min-width: 0; + border-right: 0; + border-bottom: 1px solid var(--mform-tab-nav-border); + } + + .mform .mform-tabs.mform-tabs--vertical > .tab-content { + border-left: 1px solid var(--mform-tab-content-border); + border-top: 0; + } +} + .mform .mform-tabs.rex-page-nav:last-child { margin-bottom: 0; } @@ -169,6 +279,17 @@ body.rex-theme-dark .mform .mform-tabs .nav-tabs { /*background-color: rgba(0, 0, 0, 0.15);*/ } +body.rex-theme-dark .mform .mform-tabs { + --mform-tab-nav-bg: #19222d; + --mform-tab-nav-border: #304050; + --mform-tab-content-bg: #202b35; + --mform-tab-content-border: #304050; + --mform-tab-link-color: #b9c7d6; + --mform-tab-link-active-bg: #202b35; + --mform-tab-link-active-color: #eef4fb; + --mform-tab-link-hover-bg: #243342; +} + body.rex-theme-dark .mform .mform-tabs .tab-content { background-color: #202b35; } @@ -309,6 +430,17 @@ body.rex-theme-dark .mform .custom-link.input-group.is-empty input.form-control[ } @media (prefers-color-scheme: dark) { + body.rex-has-theme:not(.rex-theme-light) .mform .mform-tabs { + --mform-tab-nav-bg: #19222d; + --mform-tab-nav-border: #304050; + --mform-tab-content-bg: #202b35; + --mform-tab-content-border: #304050; + --mform-tab-link-color: #b9c7d6; + --mform-tab-link-active-bg: #202b35; + --mform-tab-link-active-color: #eef4fb; + --mform-tab-link-hover-bg: #243342; + } + body.rex-has-theme:not(.rex-theme-light) .mform .mform-tabs .nav-tabs { /*background-color: rgba(0, 0, 0, 0.15);*/ } diff --git a/assets/mform.js b/assets/mform.js index 8477135a..e735d1f3 100644 --- a/assets/mform.js +++ b/assets/mform.js @@ -190,14 +190,47 @@ function initMFormSelectPicker(mform) { function initMFormTabs(mform) { mform.find('.mform-tabs').each(function () { - let wrapper = $(this); - $(this).find('ul[role=tablist] a').unbind().bind('click', function () { - let tab = wrapper.find('div[data-tab-group-nav-tab-id=' + $(this).data('tab-item') + ']'), - uid = Math.floor((1 + Math.random()) * 0x10000).toString(16).substring(1); - tab.attr('id', uid); - $(this).attr('href', '#' + uid); - $('#' + uid).tab("show"); + let wrapper = $(this), + nav = wrapper.children('ul[role=tablist]').first(), + panes = wrapper.children('.tab-content').first().children('.tab-pane'); + + if (!nav.length || !panes.length) { + return; + } + + function activateTab(tabId) { + let links = nav.find('[data-mform-tab-toggle]'), + targetLink = links.filter(function () { + return String($(this).data('tab-item')) === String(tabId); + }).first(); + + if (!targetLink.length) { + targetLink = links.first(); + tabId = String(targetLink.data('tab-item')); + } + + nav.find('li[role=presentation]').removeClass('active'); + links.attr('aria-selected', 'false'); + targetLink.closest('li[role=presentation]').addClass('active'); + targetLink.attr('aria-selected', 'true'); + + panes.removeClass('active'); + panes.filter(function () { + return String($(this).attr('data-tab-group-nav-tab-id')) === String(tabId); + }).first().addClass('active'); + } + + wrapper.off('click.mformTabs').on('click.mformTabs', '[data-mform-tab-toggle]', function (e) { + e.preventDefault(); + activateTab($(this).data('tab-item')); }); + + let activeLink = nav.find('li.active [data-mform-tab-toggle]').first(); + if (activeLink.length) { + activateTab(activeLink.data('tab-item')); + } else { + activateTab(nav.find('[data-mform-tab-toggle]').first().data('tab-item')); + } }); } diff --git a/assets/repeater.js b/assets/repeater.js index 0a279833..02379c9c 100644 --- a/assets/repeater.js +++ b/assets/repeater.js @@ -66,14 +66,47 @@ window.repeater = () => { let tabs = $(element).find('.mform-tabs'); if (tabs.length > 0) { tabs.each(function() { - let wrapper = $(this); - $(this).find('ul[role=tablist] a').unbind().bind('click', function() { - let tab = wrapper.find('div[data-tab-group-nav-tab-id=' + $(this).data('tab-item') + ']'), - uid = Math.floor((1 + Math.random()) * 0x10000).toString(16).substring(1); - tab.attr('id', uid); - $(this).attr('href', '#' + uid); - $('#' + uid).tab("show"); + let wrapper = $(this), + nav = wrapper.children('ul[role=tablist]').first(), + panes = wrapper.children('.tab-content').first().children('.tab-pane'); + + if (!nav.length || !panes.length) { + return; + } + + function activateTab(tabId) { + let links = nav.find('[data-mform-tab-toggle]'), + targetLink = links.filter(function () { + return String($(this).data('tab-item')) === String(tabId); + }).first(); + + if (!targetLink.length) { + targetLink = links.first(); + tabId = String(targetLink.data('tab-item')); + } + + nav.find('li[role=presentation]').removeClass('active'); + links.attr('aria-selected', 'false'); + targetLink.closest('li[role=presentation]').addClass('active'); + targetLink.attr('aria-selected', 'true'); + + panes.removeClass('active'); + panes.filter(function () { + return String($(this).attr('data-tab-group-nav-tab-id')) === String(tabId); + }).first().addClass('active'); + } + + wrapper.off('click.mformTabs').on('click.mformTabs', '[data-mform-tab-toggle]', function (e) { + e.preventDefault(); + activateTab($(this).data('tab-item')); }); + + let activeLink = nav.find('li.active [data-mform-tab-toggle]').first(); + if (activeLink.length) { + activateTab(activeLink.data('tab-item')); + } else { + activateTab(nav.find('[data-mform-tab-toggle]').first().data('tab-item')); + } }); } }, diff --git a/docs/05_wrapper.md b/docs/05_wrapper.md index 275bfbc9..ae6f1092 100644 --- a/docs/05_wrapper.md +++ b/docs/05_wrapper.md @@ -190,6 +190,8 @@ echo $mform->show(); Stellt Tab-Elemente dar, die bei Klick den dargestellten Inhalt wechseln. +Optional kann die Darstellung modernisiert oder vertikal (Navigation links) ausgegeben werden. + ```php show(); ``` +### Optionale Tab-Varianten + +```php +addTabElement('Inhalt', MForm::factory() + ->addTextField('1.0.1', ['label' => 'Titel']) + , true, false, [ + 'tab-icon' => 'fa-file-text-o', + 'tab-style' => 'modern', + 'tab-layout' => 'vertical', + ]) + ->addTabElement('Einstellungen', MForm::factory() + ->addCheckboxField('1.0.2', ['label' => 'Aktiv']) + , false, false, [ + 'tab-icon' => 'fa-cog', + ]); + +echo $mform->show(); +``` + +Hinweise: + +- `tab-style => 'modern'` ist optional und aktiviert eine modernisierte Optik. +- `tab-layout => 'vertical'` ist optional und zeigt die Tab-Navigation links neben dem Content. +- Alternativ koennen die Roh-Attribute `data-group-tab-style` und `data-group-tab-layout` gesetzt werden. + ## Modal Öffnet ein Bootstrap-Modal mit einem Sub-Formular. Ein Button wird direkt im Formular eingebettet; alle Felder im Modal-Inhalt werden beim Speichern des Moduls normal übernommen – kein separater AJAX-Request erforderlich. diff --git a/docs/07_repeater.md b/docs/07_repeater.md index 4ae88e48..0021e20f 100644 --- a/docs/07_repeater.md +++ b/docs/07_repeater.md @@ -273,11 +273,11 @@ Verfügbare Optionen im Repeater-Array: ## Wrapper im Repeater (Tabs, Collapse, Fieldset, Inline, Columns) -Seit **9.0.0** rendert der FlexRepeater alle gaengigen MForm-Wrapper auch innerhalb eines Repeater-Items. Damit lassen sich komplexe Item-Layouts wie im klassischen MForm-Pfad aufbauen – inkl. Bootstrap-3-Tabs, Collapse-Gruppen, Fieldsets mit Legend, Form-Inline und Spalten-Grids. +Seit **9.0.0** rendert der FlexRepeater alle gaengigen MForm-Wrapper auch innerhalb eines Repeater-Items. Damit lassen sich komplexe Item-Layouts wie im klassischen MForm-Pfad aufbauen – inkl. Tabs, Collapse-Gruppen, Fieldsets mit Legend, Form-Inline und Spalten-Grids. | Wrapper | Methode | Markup im Repeater-Item | |---------|---------|-------------------------| -| Tabs | `addStartGroupTab()` / `addTab()` / `addCloseTab()` / `addCloseGroupTab()` | Bootstrap-3 `nav-tabs` + `tab-content` | +| Tabs | `addStartGroupTab()` / `addTab()` / `addCloseTab()` / `addCloseGroupTab()` | ID-freie `nav-tabs` + `tab-content` (scoped pro Wrapper) | | Collapse (mit Toggle-Button) | `addCollapseElement()` | `` + `.collapse[data-group-collapse-id=…]` | | Collapse-Gruppe (Standalone-Toggle) | `addStartGroupCollapse()` / `addCloseGroupCollapse()` | `.collapse-group[data-group-accordion=0\|1]` | | Fieldset | `addFieldsetArea($legend, …)` | `
……
` | @@ -287,7 +287,7 @@ Seit **9.0.0** rendert der FlexRepeater alle gaengigen MForm-Wrapper auch innerh ### Tabs im Repeater -Tab-Panel-IDs muessen pro Item-Klon eindeutig sein. Der Renderer schreibt deshalb Platzhalter `__MFRTAB___` in die Tab-`href`s, `aria-controls` und Tab-Pane-`id`s. `flex-repeater.js _renderItem()` ersetzt die Platzhalter beim Klonen jedes Items durch eine eindeutige UID (gleiche `n` → gleiche UID, damit Nav-Link und Pane matchen). Aktive Tabs werden ueber `data-group-open-tab => true` markiert (setzt `active` auf `
  • ` und `tab-pane`). +Tabs werden ID-frei gerendert. Die Navigation wird innerhalb des naechstgelegenen `.mform-tabs`-Wrappers gescoped und per `data-tab-item`/`data-tab-group-nav-tab-id` verknuepft. Dadurch funktionieren geklonte Repeater-Items und verschachtelte Tab-Strukturen ohne ID-Kollisionen. Aktive Tabs werden weiterhin ueber `data-group-open-tab => true` markiert. ```php $itemForm = MForm::factory() diff --git a/docs/13_api_reference.md b/docs/13_api_reference.md index 87229885..99a60c3e 100644 --- a/docs/13_api_reference.md +++ b/docs/13_api_reference.md @@ -213,6 +213,12 @@ Tab-Panel. Mehrere Tabs werden automatisch zu einer Tab-Leiste zusammengefasst. | `$openTab` | `bool` | `false` | Tab initial geöffnet | | `$pullNaviItemRight` | `bool` | `false` | Tab-Item nach rechts schieben | +Optionale `$attributes` fuer Tabs: + +- `tab-icon` (z. B. `fa-cog`): Icon im Tab-Label. +- `tab-style => 'modern'` oder `data-group-tab-style => 'modern'`: modernisierte Tab-Optik. +- `tab-layout => 'vertical'` oder `data-group-tab-layout => 'vertical'`: vertikale Navigation links neben dem Tab-Content. + --- ```php diff --git a/fragments/mform/mform_wrapper.php b/fragments/mform/mform_wrapper.php index 566bec13..ca2f87bf 100644 --- a/fragments/mform/mform_wrapper.php +++ b/fragments/mform/mform_wrapper.php @@ -42,13 +42,13 @@ // TAB case 'tabnavli': - echo '
  • '; + echo ''; break; case 'tab': echo '
    getVar('attributes') . '>'; break; case 'start-group-tab': - echo '