Konventionen

Die Regeln, nach denen alle 99 Komponenten gebaut sind — Hülle, Autoring, Vokabular, Theme.

Grundlage

Wie die Bibliothek gebaut ist

Diese Demo rendert ausschließlich Markdown. Jedes Beispiel im Katalog ist eine .md-Datei unter playground/content/ — kein Beispiel ist in Vue geschrieben.

Der Katalog umfasst 99 Komponenten in fünfzehn Kategorien. Diese Seite erklärt die Regeln, nach denen sie alle gebaut sind.

Konventionen

Was hier festgezurrt wird

Diese fünf Regeln gelten für jede der 99 Komponenten.

Konvention 1

Die Abschnittshülle sitzt außen

LmsSection trägt Eyebrow, Titel, Beschreibung und Fußnote
Bausteine selbst sind überschriftsfrei
Mehrere Bausteine können unter einer Überschrift stehen

Konvention 2

YAML für Struktur, Slot für Fließtext

Wiederholte Kinder stehen als items in YAML. Der eine Fließtext einer Komponente ist der Default-Slot. Container akzeptieren beides — der gefüllte Slot gewinnt.

Konvention 3

Inline, was kurz ist — Frontmatter, was es verlangt

Listen, Zahlen, false und ausgezeichneter Text müssen ins Frontmatter: inline kennt MDC nur Zeichenketten. Kurze einzeilige Werte stehen in { … } — und ein Block darf beides mischen.

Deshalb steht bei einem Baustein mal das eine, mal das andere. Es entscheidet der Wert, nicht der Baustein.

Konvention 4

Inline-Markdown in Prop-Strings

Auszeichnung wie fett, kursiv, code und Links funktioniert direkt in Textfeldern — gerendert von LmsMarkdown.

Kein vollständiger Parser. Wer echtes Markdown braucht, nimmt die verschachtelte Form.

Konvention 5

Themeneutral

Keine feste Markenfarbe. Jede Komponente hat color mit den semantischen Rollen aus Nuxt UI. Oben rechts kannst du zwischen hell und dunkel wechseln.