5.1 – Titel und Aufklappen

Überschrift

options:
  title: Über dieses Handbuch

Daraus wird ein h3 mit der Klasse layout-box-title — dieselbe Ebene, die auch Explorer und Inhaltsverzeichnis für ihre Überschriften nehmen, damit die Gliederung der Seite stimmt.

Platzhalter funktionieren auch hier: title: "Über {{siteTitle}}".

Aufklappen

options:
  title: Über dieses Handbuch
  collapsible: true
  collapsed: false

collapsible macht aus der Box ein details-Element, dessen Klickzeile der Titel ist. collapsed entscheidet, ob sie zugeklappt beginnt. Die Box unten links auf dieser Website ist genau so gebaut — nur mit collapsed: true, sie beginnt also zugeklappt.

collapsible ohne title geht nicht

Ein details ohne Zeile zum Klicken wäre nicht zu öffnen. Das Plugin sagt es beim Bauen — „collapsible requires a title; rendering non-collapsible“ — und rendert die Box normal.

Die Meldung kommt nur, wenn collapsible aus der Konfiguration stammt, aus den Grundoptionen oder aus byLang. Aus dem Frontmatter einer Seite bleibt sie aus: Dort wird die Box ebenfalls nicht aufklappbar, aber ohne ein Wort.

Ohne JavaScript, mit den Folgen

Das Auf- und Zuklappen ist das eingebaute Verhalten von details. Kein Skript, keine Ladezeit, funktioniert auch, wenn JavaScript abgeschaltet ist.

Der Preis: Der Zustand überlebt keinen Seitenwechsel. Wer die Box aufklappt und weiterklickt, findet sie auf der nächsten Seite wieder so vor, wie collapsed es sagt. Etwas anderes ginge nur mit Skript und Speicher im Browser — und dann wäre es kein Plugin mehr, das nichts ausliefert.

Zugeklappt beginnen, wenn die Box lang ist

In einer schmalen Spalte schiebt eine offene Box alles darunter aus dem Bild. collapsed: true ist dort meist die freundlichere Wahl — der Titel sagt ja, was drin steht.