Willkommen

KoliBri steht für "Komponentenbibliothek für die Barrierefreiheit"

Vision

Wir machen gemeinsam HTML mittels wiederverwendbaren Web Components semantisch barrierefrei, um die Usability und Zugänglichkeit sicherzustellen.

Mission

Der ist an sich sehr "offen" spezifiziert, um möglichst langlebig und robust zu sein. Es kommt daher häufig vor, dass HTML-Kompositionen nicht ohne Weiteres barrierefrei, semantisch und valide sind. KoliBri baut direkt auf den des auf (Framework-agnostisch), ist dabei eine generische Referenzimplementierung des und der für die Barrierefreiheit und als eine Multi-Theming-fähige Präsentationsschicht umgesetzt. Es gibt keinerlei fachlichen Bezug und keine Datenübertragungsfunktionalitäten. Damit ist KoliBri für die Realisierung statischer Webseiten als auch dynamischer Webanwendungen unterschiedlicher Corporate Designs und Styleguides gleichermaßen wiederverwendbar und somit für Open Source sehr interessant.

Kollaboration und Kooperation

Der Fokus von KoliBri liegt auf kleinen (atomaren), sehr flexiblen und gut wiederverwendbaren HTML-Kompositionen (z.B. Button). Wir bieten eine barrierefreie, semantische und valide Standard-Implementierung solcher Komponenten an, die für jede höherwertige HTML-Struktur oder Komponente (Molekül, Organismus oder Template) wiederverwendet werden können.

Bei diesen atomaren Komponenten sollten wir kollaborieren und kooperieren, um unsere Fähigkeiten und unser Wissen zu bündeln. Durch die Synergieeffekte an den Basis-Komponenten kann der eigene Fokus mehr auf fachspezifische Inhalte gelegt werden.

Lasst uns dazu gemeinsam KoliBri besser und bunter machen!

Lizenz

KoliBri wird unter der EUROPEAN UNION PUBLIC LICENCE v1.2 Open Source freigegeben. Folgende Aspekte sind insbesondere dadurch berücksichtigt:

• Zugänglichmachung: Die Artefakte und der Quellcode können von jedem frei und kostenlos wiederverwendet werden. Hierdurch leistet der ITZBund einen Beitrag im Sinne von .

• Gewährleistungs- und Haftungsausschluss: Mit der Wiederverwendung gehen keinerlei Gewährleistung und Haftungsansprüche einher.

• „Copyleft“-Klausel: Copyleft besagt, dass jede Kopie von KoliBri (Fork) wieder unter derselben oder einer kompatiblen Open-Source-Lizenz veröffentlicht werden muss.

Abgrenzung

Um KoliBri richtig einzusetzen, ist es wichtig zu wissen, wo es seine Potenziale entfaltet. KoliBri ist vielseitig wiederverwendbar, weil das Styling vollkommen entkoppelt wurde und das Rendering Client- aber auch Server-seitig möglich ist.

Styling

KoliBri ist kein CSS-Framework und auch kein Design-System, sondern eine Bibliothek aus häufig verwendeten Komponenten, die Anforderungen an die Barrierefreiheit und Benutzerfreundlichkeit haben. Um diese Anforderungen nicht immer wieder neu betrachten zu müssen, schafft KoliBri mittels Web Components hier einen übergreifenden einheitlichen Standard für alle Styleguides.

Je mehr relevante Komponenten gefunden und umsetzten werden, desto wertschöpfender wird der Nutzen für alle webbasierten Projekte. KoliBri zielt jedoch nicht darauf ab, Komponenten ohne Anforderungen an Barrierefreiheit und Benutzerfreundlichkeit umzusetzen. Dazu kann Standard HTML und CSS oder alternative CSS-Frameworks verwendet werden.

KoliBri-Komponenten lassen sich nahtlos in vorhandene Webseiten oder Webanwendungen integrieren und bringen ihren Style (-guide) selbst mit und kapseln diesen nahezu vollständig von Außen ab.

Rendering

Web Components können technologisch sowohl Client-seitig (CSR), prerendered (SSG), als auch Server-seitig (SSR) gerendert werden. Das Rendering ist dabei von den jeweils technischen Rahmenbedingungen abhängig (, ).

💡 Es ist zu beachten, dass Web Components ein auf JavaScript basierender Webstandard ist. Das Server-Side-Rendering ermöglicht das Prerendern der Web Component für eine optimale Anzeigegeschwindigkeit auf dem Client. Wenn Client-seitiges JavaScript erlaubt ist, steht die vollständige Dynamik der Web Component auch Client-seitig zur Verfügung. Möchte man jedoch Client-seitig kein JavaScript einsetzen, wird die Web Component geprerendert angezeigt, aber die Dynamik geht dadurch verloren.

🧪 Das Server-Side-Rendering von Web Components ist eine neue spannende Funktionalität, wo noch Anpassungen an den Prerenderer notwendig sein werden und wird daher unsererseits als experimentell eingestuft ().

Versionierung

KoliBri folgt den Prinzipien der semantischen Versionierung.

Aufbau einer Version:

• Sie besteht in der Regel aus 3 Teilen (z. B. 1.0.2)

  • Major, hier die 1

  • Minor, hier die 0

  • Patch, hier die 2

• Für die Releasephase einer Version kann man zusätzlich Labels verwenden (z. B. 1.0.3-rc.2)

  • Label, hier die rc.2

Folgende Hauptprinzipien kommen dabei zur Anwendung:

• Patch: Beinhaltet Änderungen, die den aktuellen Funktionsumfang verbessern und in seiner Verwendung nicht ändern.

• Minor: Beinhaltet Änderungen, die den Funktionsumfang erweitern und den bestehenden Funktionsumfang in seiner Verwendung nicht ändern.

• Major: Beinhaltet Änderungen, die eine architektonische Neuausrichtung ermöglichen und den bestehenden Funktionsumfang in seiner Verwendung ändern dürfen.

Die komplette Beschreibung der SemVer finden Sie hier:

Qualitätsziele

In der folgenden Tabelle werden die priorisierten Qualitäten von KoliBri aufgelistet:

Geräte-, Betriebssystem-, Browser- und Screenreader-Anforderungen

KoliBri ist für die Umsetzung beliebiger webbasierter Benutzeroberflächen vorgesehen und soll auf allen modernen Geräten (PC, Tablet, Mobil), Betriebssystemen (Windows, Linux, MacOS, Android, iOS) und standardkonformen Browsern eingesetzt werden können.

Der Microsoft Internet Explorer wird explizit nicht unterstützt, um das Projekt und die Entwicklung nicht durch Altlasten zu schwächen. KoliBri investiert stattdessen konsequent in die Zukunft.