CMS & Listen
CMS List Nest
Verschachtle mehr als 100 Items und mehr als 10 verschachtelte Listen auf einer Seite: der Multi-Reference-Workaround für Webflow.
Auf dieser Seite
Skript einbinden
<!-- FlowPowerUser · CMS List Nest -->
<script defer src="https://cdn.jsdelivr.net/npm/@flowpoweruser/attributes@1/list-nest.js"></script>Einmal pro Projekt genügt, auch wenn du die Lösung auf mehreren Seiten nutzt: Project Settings → Custom Code → Head Code.
Das Skript lädt nebenher und hält das Rendern nicht auf; es läuft erst, wenn die Seite steht, und tut nichts, solange kein fpu-Attribut da ist.
Weg wählen
Die Items kommen auf einem von zwei Wegen in den Slot.
Beide lassen sich auf einer Seite mischen, pro Slot gilt einer.
Beispiel
Seite mit der Eltern-Liste
└─ Collection Item
├─ Link Block fpu-nest-element="link" (Current …)
└─ Div Slot fpu-nest-element="target"
fpu-nest-collection="name"
Template-Seite des Eltern-Items
└─ Collection List Wrapper fpu-nest-element="source"
fpu-nest-collection="name"Beispiel
Seite mit der Eltern-Liste
├─ Collection Item
│ └─ Div Slot fpu-nest-element="target"
│ fpu-nest-refs="slug-a,slug-b"
│ fpu-nest-collection="name"
└─ Collection List (versteckt) fpu-nest-element="source"
└─ Collection Item fpu-nest-slug="slug-a"Auf der Seite mit der Eltern-Liste: Jedes Eltern-Item bekommt einen Link auf seine Template-Seite und einen Slot, der die Kopien aufnimmt.
Zeigt auf die Template-Seite des Eltern-Items.
Lege einen Link Block, Text Link oder Button ins Collection Item und stelle ihn in den Link Settings auf „Current …“, also auf die Seite dieses Items. Er darf versteckt sein.
Der Div-Block im Eltern-Item, der die verschachtelten Items aufnimmt.
Gib dem Div-Block diese Attribute, aber kein fpu-nest-refs: Daran erkennt List Nest den Weg über die Template-Seite. collection nennt die Quell-Liste auf der Template-Seite.
Bleibt stehen, wenn es keine Treffer gibt, sonst wird es entfernt.
Lege ein Element in den Ziel-Slot, das angezeigt wird, wenn die Liste auf der Template-Seite leer ist. Bei Treffern entfernt das Script es automatisch.
Auf der Collection-Template-Seite der Eltern-Collection: Lege eine Collection List an, deren Quelle das Multi-Reference-Feld des Eltern-Items ist.
Der Collection List Wrapper, aus dem die Items kopiert werden.
Setze die Attribute auf den Collection List Wrapper, nicht auf die innere Collection List. Gestalte die Items so, wie sie im Slot erscheinen sollen. Ihre Reihenfolge ist die Ausgabe-Reihenfolge.
Tipp Mehr als 100 Items: Nimm auf der Template-Seite die Collection selbst als Quelle, filtere sie über ein Referenzfeld auf das aktuelle Item und schalte die Pagination ein. List Nest lädt alle Folgeseiten mit, bis zu 50.
Auf der Seite, auf der die verschachtelte Liste erscheinen soll, definierst du den Slot, der die Kopien aufnimmt.
Der Div-Block im Ziel-Item, der die verschachtelten Items aufnimmt.
Wähle einen Div-Block im Ziel-Item und gib ihm diese Attribute. target markiert den Slot, refs nennt die zu verschachtelnden Slugs (komma-getrennt, Reihenfolge = Render-Reihenfolge) und collection die Quell-Collection. collection ist optional, wenn nur eine Quelle auf der Seite existiert.
Tipp Binde fpu-nest-refs an ein CMS-Feld (Plain-Text mit den Multi-Reference-Slugs), damit jedes Item seine eigenen Referenzen mitbringt.
Bleibt stehen, wenn es keine Treffer gibt, sonst wird es entfernt.
Lege ein Element in den Ziel-Slot, das angezeigt wird, wenn keine referenzierten Items gefunden werden. Bei Treffern entfernt das Script es automatisch.
Lege irgendwo auf derselben Seite die Quell-Liste an, meist versteckt.
Ihre Items werden geklont und in die Slots eingefügt.
Die Collection List, aus der Items geklont werden.
Wähle die Collection List der Quell-Collection und gib ihr diese Attribute. Nach der Verarbeitung wird die Liste automatisch versteckt (display:none).
Wichtig Der collection-Wert an Quell-Liste und Ziel-Slot muss exakt übereinstimmen, sonst findet das Script die Quelle nicht.
Jedes Item der Quell-Liste trägt seinen Slug.
Gib dem Collection Item den Slug, über den es in fpu-nest-refs referenziert wird, per CMS-Feld an das Slug-Feld binden.
Veröffentlichen und auf der Live-Seite prüfen
Attributes-Lösungen laufen nicht im Designer-, Edit- oder Vorschau-Modus.
Veröffentliche dein Projekt und teste das Ergebnis auf der publizierten Seite, nach jeder Änderung neu.
Optional
Weitere Einstellungen
Maximale Anzahl eingefügter Items pro Slot.
Setze dieses Attribut zusätzlich am Ziel-Slot, um die Zahl der eingefügten Items zu begrenzen.
Verhindert das automatische Ausblenden der Quell-Liste.
Standardmäßig wird die Quell-Liste nach der Verarbeitung versteckt. Mit diesem Attribut bleibt sie sichtbar, was beim Aufbauen hilft.
Schreibt eine Init-Zeile in die Konsole.
Gibt beim Initialisieren eine Zeile in der Browser-Konsole aus, was beim Debuggen hilft.
Setzt Defaults für alle Slots per Script.
Definiere in einem <script> nach der Einbindung globale Defaults. Ein Attribut am Element gewinnt immer gegen den globalen Wert. Beispiel: window.fpuListNestConfig = { limit: 6, logging: false, hideSource: true }
Das Prinzip · Warum List Nest
CMS List Nest kopiert Items in Slots deines Eltern-Items, von seiner Template-Seite oder aus einer Quell-Liste auf derselben Seite. Beliebig viele Listen, bis zu fünf Ebenen tief. Komplett über fpu-nest-Attribute.
- QuelleTemplate-Seite oder Quell-Liste, liefert die Items.
- SlotDiv-Block im Eltern-Item, nimmt die Kopien auf.
- ReihenfolgeWie in der Quelle, beim Slug-Weg wie in refs.
Zusätzliche Features
- Programmatische APIÜber window.fpuListNest stehen instances, init(), refresh() und destroyAll() bereit, z. B. um nach eigenem CMS-Nachladen neu zu verschachteln.
- EventsPro befüllter Ziel-Liste wird fpu:items-changed ausgelöst (detail: { solution: 'nest', list }). Umgekehrt reagiert List Nest re-render-tolerant auf Events anderer Lösungen (Load More, Filter) und befüllt neue Slots automatisch nach.
- Mehrstufiges NestingQuell-Items dürfen selbst Slots enthalten; Verschachtelung wird bis Tiefe 5 aufgelöst (schützt zugleich vor zirkulären Referenzen).
- Hinweis: Interactions & IDsQuell-Items werden geklont (cloneNode), da mehrere Ziele dieselbe Quelle nutzen können. Webflow-Interactions (IX2) überleben das Klonen nicht; id-Attribute wandern mit, sodass bei id-basierten Ankern in Quell-Items Duplikate entstehen können.