Deutsch
Über dieses Handbuch

Dieses Handbuch gehört zum Quartz-Plugin quartz-navigations. Und es ist mit ihm gebaut: das Menü darüber und „Zurück / Weiter“ unter jedem Text kommen von dort.

  • Einstieg — die erste Navigation in fünf Minuten
  • Varianten — alle zehn im Vergleich
  • Rezepte — fertige Kombinationen zum Abschauen
  • Nachschlagen — alle Optionen auf einer Seite

Wie die Einträge dafür aussehen, steht in 8.1.

5.1 – Ordnerzeilen

folderClick — klappen oder verlinken

Die ganze Zeile eines aufklappbaren Ordners ist Klickfläche. Was sie tut, entscheidet folderClick:

options:
  folderClick: toggle   # toggle (Vorgabe) | link

toggle — ein Klick irgendwo auf die Zeile öffnet oder schließt den Ordner. Die Ordnerseite ist aus dieser Navigation dann nur über einen zusätzlichen Eintrag erreichbar: indexEntry: first stellt „Übersicht“ als erstes Kind in den Ordner (3.2).

link — die Zeile ist ein Link zur Ordnerseite, und am rechten Rand sitzt ein eigener Aufklapp-Button mit dem Pfeil. Das ist die übliche Wahl zusammen mit trigger: hover: Das Menü öffnet beim Überfahren, der Klick folgt dem Link (5.2).

togglelink
Klick auf den Titelklapptöffnet die Ordnerseite
PfeilHinweis, kein eigener Buttoneigener Button, immer sichtbar
Ordnerseite erreichbar überindexEntry: firstden Titel
Für Screenreaderein Bedienelement mit dem Titelein Link und ein Button „… aufklappen“

Ordner, die nur mobil klappen

Mit mobile: accordion klappen Ordner in tree, bar, tabs und columns nur auf dem Smartphone (6.1). Sie verwenden immer Link und Button, egal was folderClick sagt — auf dem Desktop soll ihr Titel ein Link bleiben.

chevrons — der Pfeil

options:
  chevrons: false

Blendet den Pfeil an Ordnern mit folderClick: toggle aus. Bei link bleibt er, weil er dort der Button ist. Welches Symbol der Pfeil ist, regelt iconNames.chevron (7.1).

Offen oder zu

OptionVorgabeWirkung
folderDefaultStatecollapsedopen lässt alle Ordner offen beginnen
expandActivetrueOrdner auf dem Pfad zur aktuellen Seite beginnen offen

Beide gelten für accordion. Die Menüs von dropdown und mega und die Panels von flyout beginnen immer geschlossen — ein Menü, das beim Laden schon offen steht, verdeckt die Seite.

exclusive — ein Ordner je Ebene

options:
  variant: accordion
  exclusive: true

Öffnet man einen Ordner, schließt sich der offene daneben. Das erledigt der Browser selbst über das name-Attribut von <details> — ohne Skript, in aktuellen Browsern. Ältere lassen mehrere offen.

persistState — das Gedächtnis

options:
  variant: accordion
  persistState: true
  id: seitenleiste

Welche Ordner jemand geöffnet oder geschlossen hat, merkt sich der Browser im localStorage und stellt es auf der nächsten Seite wieder her. Der Pfad zur aktuellen Seite bleibt trotzdem offen, solange expandActive gilt — ein gemerktes „zu“ gewinnt nicht gegen die Seite, auf der man steht.

Mit persistState immer eine id

Gespeichert wird unter der ID der Navigation. Ohne id ist das ein Prüfwert aus allen Optionen — ändert man später irgendeine davon, ist das Gedächtnis weg. Eine feste id hält es über Änderungen hinweg (7.3).

Menüs und Panels (dropdown, mega, flyout) werden nie gemerkt.