Awesome
Willkommen bei KoliBri
KoliBri steht für Komponenten-Bibliothek für die Barrierefreiheit
Vision
Wir machen gemeinsam HTML mittels wiederverwendbaren Web Components barrierefrei, um die Usability und Zugänglichkeit sicherzustellen.
Mission
Der HTML-Webstandard ist an sich sehr "offen" spezifiziert, um möglichst langlebig und robust zu sein. Es kommt daher häufig vor, das HTML-Kompositionen nicht ohne Weiteres barrierefrei, semantisch und valide sind. KoliBri baut direkt auf den Webstandards des W3C auf (Framework-agnostisch), ist dabei eine generische Referenzimplementierung des WCAG-Standards und der BITV 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!
Weiter zur Dokumentation…
Lizenz
KoliBri wird unter der EUROPEAN UNION PUBLIC LICENCE v. 1.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 "Public Money - Public Code".
- 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 der selben oder einer kompatiblen Open Source-Lizenz veröffentlicht werden muss.
Anwendung erstellen
Im folgenden Video sehen Sie, wie Sie ganz einfach eine Webanwendung auf KoliBri-Basis erstellen können.
Befehl: npm init kolibri@latest my-app
Aktuell können Sie eine statische Webseite oder Webanwendungen für die Frameworks React, Preact, Solid, Next.js, Vue, Astro und Angular generieren.
Abgrenzung
KoliBri stellt die Barrierefreiheit auf Ebene der webbasierten Komponenten sicher und bietet die ideale Grundlage zur Realisierung barrierefreier Benutzeroberflächen.
KoliBri ist kein CSS-Framework und auch kein Design System. KoliBri dient jedoch als konkrete Implementierung semantisch korrekter Komponenten für Styleguides und Design Systeme.
KoliBri kombiniert (technisch) die barrierefrei abgestimmten und standardisierten Komponenten mit beliebigen Designs zu jeweils robusten und kundenspezifischen Komponenten für dynamische Webanwendungen und statische Webseiten.
Versionierung
KoliBri folgt den Prinzipien des semantischen Versionierens.
Aufbau einer Version:
<ul> <li> besteht in der Regel aus 3 Teilen (z.B. 1.0.2) <ul> <li> Major, hier die <i>1</i> </li> <li> Minor, hier die <i>0</i> </li> <li> Patch, hier die <i>2</i> </li> </ul> </li> <li> für die Härtungsphase einer Version, kann man zusätzlich Labels verwenden (z.B. 1.0.3-rc.2) <ul> <li> Label, hier die <i>rc.2</i> </li> </ul> </li> </ul>Folgende Hauptprinzipien kommen dabei zur Anwendung:
<ul> <li> <b>Patch</b>: Beinhaltet Änderungen die den aktuellen Funktionsumfang verbessern und in seiner Verwendung nicht ändern. </li> <li> <b>Minor</b>: Beinhaltet Änderungen die den Funktionsumfang erweitern und den bestehenden Funktionsumfang in seiner Verwendung nicht ändern. </li> <li> <b>Major</b>: Beinhaltet Änderungen die eine architektonische Neuausrichtung ermöglichen und den bestehenden Funktionsumfang in seiner Verwendung ändern dürfen. </li> </ul>Ausführliche Version der SemVer finden Sie hier: https://semver.org
Qualitätsziele
In der folgenden Tabelle werden die priorisierten Qualitäten von KoliBri aufgelistet:
| Qualität | Priorität | Erläuterung |
|---|---|---|
| Kompatibilität | AAA | W3C®-Standards, Framework-agnostisch und Open Source |
| Gebrauchstauglichkeit | AAA | BIK BITV- und Usability-Test |
| Wartbarkeit | AAA | DevOps, Technologie-Stack, Modularisierung und Automatisierung |
| Portierbarkeit | AA | Anpassbarkeit an verschiedene Styleguides des Bundes oder anderer |
| Zuverlässigkeit | AA | BIK BITV-, Axe-, Unit-, Snapshot-, E2E-Tests und Developer Experience (EX) |
| Performance | A | KoliBri geht hier einen Kompromiss ein, da es die Entwicklung aktiv bei der Umsetzung barrierefreier Benutzeroberflächen unterstützt. |
| Sicherheit | A | Web Components dienen der Präsentationsschicht und beinhalten selbst keine sensitiven Informationen. |
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, MaxOS, 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 konzequent in die Zukunft.
| Gerät | Betriebsystem | Browser | Screenreader |
|---|---|---|---|
| PC | Windows<br/>Linux<br/>MacOS | Chrome<br/>Firefox<br/>Edge<br/>Opera<br/>Safari (nur MacOS) | NVDA<br/>Jaws<br/>VoiceOver (nur MacOS) |
| Tablet<br/>Mobil | Android<br/>iOS | Chrome<br/>Firefox<br/>Edge<br/>Opera<br/>Safari (nur iOS) | TalkBack (nur Android) |