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.

v1.1.03,7 kB gzipkostenlos

Live-Demo ansehenCloneable holenTutorial-Video
Auf dieser Seite

Skript einbinden

Head Code · im <head>
<!-- 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.

Item-Link

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.

Ziel-Slot

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.

Empty-State

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.

Quell-Liste

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.

Ziel-Slot

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.

Empty-State

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.

Quell-Liste

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.

Quell-Item

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
Limit

Maximale Anzahl eingefügter Items pro Slot.

Setze dieses Attribut zusätzlich am Ziel-Slot, um die Zahl der eingefügten Items zu begrenzen.

Quelle sichtbar lassen

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.

Logging

Schreibt eine Init-Zeile in die Konsole.

Gibt beim Initialisieren eine Zeile in der Browser-Konsole aus, was beim Debuggen hilft.

Globale Defaults

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
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.

10 × 100Webflow-Limit
∞Mit List Nest
  1. QuelleTemplate-Seite oder Quell-Liste, liefert die Items.
  2. SlotDiv-Block im Eltern-Item, nimmt die Kopien auf.
  3. 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.

Zugang derzeit nur auf Einladung