Bibliothek fertiger Komponenten
Fertige Komponenten und Seitenvorlagen im Theme der Umgebung ansehen, übernehmen, anpassen und aktuell halten.
Worum es geht
Die Bibliothek enthält fertige Komponenten für Kopfzeilen, Fusszeilen, Einstiege, Merkmale, Preise, Galerien, Teams, Kontaktbereiche und vieles mehr, dazu ganze Seitenvorlagen. Sie ist gross angelegt: 134 Komponenten in 21 Kategorien mit rund 300 Varianten, 36 Seitenvorlagen, 48 Farbwelten und 5 Stilrichtungen. Alle Texte gibt es in acht Sprachen.
Eine Komponente aus der Bibliothek trägt keine festen Farben. Sie verweist nur auf Rollen wie Hauptfarbe, Hintergrund oder Abstand. Beim Übernehmen setzt Ihre Umgebung dafür ihre eigenen Theme-Werte ein. Darum sieht jede Komponente nach dem Übernehmen so aus, als wäre sie für Ihre Website gebaut worden.
Die Bibliothek ist nicht dasselbe wie die Bausteinbibliothek für Entwickler: Dort kopieren Sie Code mit hcms add in ein Projekt. Die Bibliothek hier liefert fertige Komponenten, die Sie in Sites übernehmen und im Komponenten-Builder anpassen.
Ansehen
Öffnen Sie Komponenten und wählen Sie den Reiter Bibliothek. Er braucht keine Freischaltung des Marketplace.
- Suche und Filter: Suchen Sie nach Name oder Begriff und filtern Sie nach Kategorie und Stilrichtung (Klar, Warm, Kräftig, Ruhig, Verspielt). Filter zurücksetzen zeigt wieder alles.
- Vorschau im Theme: Die Karten zeigen jede Komponente im Theme Ihrer Umgebung. Alternativ sehen Sie die Komponente im Original ihrer Stilrichtung oder probehalber in einer Farbwelt.
- Varianten: Viele Komponenten haben Varianten, zum Beispiel eine dunkle oder gedämpfte Fassung. Sie sehen sie in der Vorschau, bevor Sie übernehmen.
Komponenten, die Sie schon übernommen haben, sind als Bereits übernommen markiert.
Übernehmen
Wählen Sie Übernehmen. Dann geschieht Folgendes:
- Sie vergeben einen Namen für Ihre Umgebung und wählen die Sprache der Texte.
- Die Komponente verweist auf Rollen, zum Beispiel Hauptfarbe oder Hintergrund. Für jede Rolle wählen Sie den passenden Theme-Wert Ihrer Umgebung. Die Vorschläge stammen aus Ihrem Theme.
- Fehlt ein Wert, legen Sie ihn direkt mit Theme-Wert hinzufügen an. Er landet im Entwurf Ihres Themes und wird erst mit dem Theme veröffentlicht. Dafür brauchen Sie die Theme-Berechtigung.
- Übernehmen und anpassen legt die Komponente als Entwurf an und öffnet den Komponenten-Builder. Mit Sofort veröffentlichen geht sie stattdessen gleich live.
Die übernommene Komponente gehört Ihnen. Sie können Texte, Stil und Aufbau frei ändern. Dafür brauchen Sie die Berechtigung, Komponenten zu verwalten.
Alle oder eine Kategorie übernehmen
Statt Komponente für Komponente übernehmen Sie mehrere in einem Durchgang. Im Reiter Bibliothek gibt es dafür Alle übernehmen und Kategorie übernehmen:
- Alle übernehmen nimmt jede Komponente, die in dieser Umgebung noch fehlt. Kategorie übernehmen gilt nur für die Kategorie, die Sie im Filter gewählt haben; ohne gewählte Kategorie sagt Scorebase, dass Sie erst eine wählen.
- Die Anzeige nennt vorab, wie viele schon übernommen sind („x von y übernommen“) und wie viele noch fehlen. Neue Komponenten tragen den Hinweis neu. Ist alles da, steht „Alle Komponenten sind schon in dieser Umgebung“.
- Der Lauf zeigt „x von y werden übernommen“ und bleibt offen, bis er fertig ist. Am Ende steht „x hinzugefügt, y übersprungen“.
- Die Theme-Werte setzt Scorebase selbst ein. Fehlt für eine Komponente eine passende Rolle, wird sie übersprungen; Sie übernehmen sie dann einzeln und wählen den Wert selbst.
Ein zweiter Lauf legt nichts doppelt an, und gelöschte Komponenten kommen nicht zurück.
Das Übernehmen im Reiter Bibliothek ist nur ein Weg. Setzen Sie eine Komponente im Seiten-Editor aus der Palette ein, übernimmt Scorebase sie automatisch in die Umgebung. Fehlt dabei für eine Farbrolle der Komponente ein passender Wert im Theme, lehnt Scorebase das Einsetzen ab und verweist auf die Einzelübernahme im Reiter Bibliothek; dort wählen Sie den Wert selbst. Theme-Werte legt das Einsetzen nie an. Gelöschte Komponenten bietet die Palette nicht erneut an.
Brach der Lauf ab, macht Nachholen dort weiter, wo er stand. Dafür brauchen Sie das Recht, Komponenten zu verwalten. Beim Anlegen einer neuen Umgebung geht dasselbe im Bereich Ausstattung (siehe Umgebungen).
Spätere Änderungen der Bibliothek
Eine übernommene Komponente ist eine Kopie. Wird die Bibliothek später verbessert, ändert sich Ihre Kopie nicht von selbst; sie bleibt, wie Sie sie angepasst haben. Wollen Sie eine neuere Fassung nutzen, übernehmen Sie die Komponente noch einmal unter einem neuen Namen und tauschen sie im Layout oder auf der Seite aus.
Ist die Fassung beim Übernehmen veraltet, weil die Bibliothek inzwischen aktualisiert wurde, erscheint der Hinweis „Die Bibliotheksfassung ist veraltet. Bitte laden Sie die Seite neu.“ Laden Sie die Seite neu und übernehmen Sie noch einmal.
Farbwelten
Eine Farbwelt ist eine geprüfte Palette aus Farbrollen. Es gibt 48 davon, 36 helle und 12 dunkle. Jedes Rollenpaar, zum Beispiel Hauptfarbe und Schrift darauf, ist auf ausreichenden Kontrast geprüft.
Farbwelten finden Sie in den Theme-Einstellungen. Sie probieren eine Welt in der Vorschau aus und wenden sie danach an. Beim Anwenden zeigt Scorebase, wie viele Werte sich ändern und wie viele neu entstehen, und schreibt das Ergebnis in den Theme-Entwurf. Veröffentlicht wird erst, wenn Sie das Theme veröffentlichen. Mehr dazu unter Theme und Design-Tokens.
Seitenvorlagen
Seitenvorlagen setzen mehrere Komponenten zu einer ganzen Seite zusammen, zum Beispiel eine Startseite für einen Verein, eine Spendenseite, eine Preisseite oder eine Seite „Über uns“. 27 davon folgen bewährten Seitenmustern, 9 sind eigene Vorlagen für Vereine, Stiftungen und Betriebe.
Beim Übernehmen kopiert Scorebase die Vorlage in Ihre Umgebung. Die Texte in eckigen Klammern, zum Beispiel „[Angebot]“, sind Platzhalter für Ihre eigenen Angaben. Das Verhältnis zu Layouts erklärt Layouts und der Layout-Builder.
Prüfregeln
Jede Komponente der Bibliothek besteht sechs Prüfungen, in jeder Variante, jeder Farbwelt und jeder Stilrichtung:
- ausreichender Kontrast zwischen Schrift und Hintergrund
- Tippziele von mindestens 44 Pixeln
- Alternativtext bei Bildern
- eine sinnvolle Reihenfolge der Überschriften
- keine leeren Links
- Bewegung nur, wenn der Besucher sie nicht abgeschaltet hat
Dieselben Prüfungen zeigen Ihnen beim Bearbeiten Hinweise an. Die Hinweise sind nie blockierend.
Hike-Umgebung
Auch in der Umgebung hike stehen die Komponenten der Bibliothek im Seiten-Editor bereit. Das Hike-Portal zeichnet sie im eigenen Design; Kopf, Fuss und die Hike-Blöcke gestaltet es weiterhin selbst. Das Theme der Umgebung wird dort nie verändert, und Farbwelten gelten in Hike nicht.
Für Entwickler
Die Bibliothek liegt als Dateien unter templates/component-library/cms/bibliothek/. Die Dateien sind generiert; geändert wird nur der Quelltext unter scripts/bibliothek/.
npm run bibliothek:bauenerzeugt Komponenten, Kategorien, Texte und die ÜbersichtKOMPONENTEN.md. Mit-- --strengbricht der Lauf bei jeder fehlenden Übersetzung ab, mit-- --checkprüft er nur, ob die Dateien zum Quelltext passen.npm run bibliothek:pruefenführt die Prüfregeln über alle Komponenten und Seitenvorlagen aus.- Ändert sich der Inhalt einer Komponente, muss ihre Version steigen. Sonst bricht der Lauf mit „Version erhöhen“ ab.
hcms marketplace sync-officiallädt die Bibliothek als offizielle Einträge hoch, in Stapeln. Mit--dry-runsehen Sie vorher die Zahlen je Typ.
KOMPONENTEN.md nennt jede Komponente mit Schlüssel, Eigenschaften und Varianten. Sie eignet sich als Nachschlagewerk für Werkzeuge und KI-Assistenten, die Seiten aus Komponenten zusammenstellen.
Woher die Gestaltungsmuster stammen, steht unter Lizenzen der Bibliothek.
Wenn etwas nicht klappt
| Symptom | Ursache | Lösung |
|---|---|---|
| Der Reiter Bibliothek fehlt | Sie haben keine Berechtigung für Komponenten | Berechtigung Komponenten verwalten bei der Administration anfragen |
| Übernehmen meldet eine fehlende Zuordnung | Für eine Rolle ist noch kein Theme-Wert gewählt | Wert wählen oder mit Theme-Wert hinzufügen anlegen |
| Neue Theme-Werte lassen sich nicht anlegen | Es fehlt die Theme-Berechtigung | Berechtigung anfragen oder einen vorhandenen Wert wählen |
| „Die Bibliotheksfassung ist veraltet“ | Die Bibliothek wurde seit dem Öffnen aktualisiert | Seite neu laden und noch einmal übernehmen |
| Alle übernehmen überspringt einzelne Komponenten | Für eine Rolle der Komponente gibt es keinen passenden Theme-Wert | Die Komponente einzeln übernehmen und den Wert wählen oder anlegen |
| „Die Übernahme ist nicht vollständig“ | Einzelne Komponenten konnten nicht übernommen werden, oder die Verbindung riss ab | Nachholen wählen |
| Die Vorschau sieht anders aus als die Website | Die Vorschau nutzt Ihr Theme, die Website evtl. ein älteres | Theme veröffentlichen |