altchecker/README.md

39 lines
1.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Alt-Text Checker
Barrierefreiheits-Bookmarklet zur Prüfung von Alt-Texten auf beliebigen Webseiten.
## Installation
**Installationsseite mit Drag-&-Drop-Button:** https://saschab.codeberg.page/altchecker/
Falls die Seite nicht erreichbar ist oder Drag & Drop nicht funktioniert, geht es auch manuell:
1. Rechtsklick auf die Lesezeichenleiste deines Browsers → „Seite hinzufügen" o. ä.
2. Als Namen `Alt-Text Checker` eintragen.
3. Als Adresse den kompletten Inhalt von [`dist/bookmarklet.txt`](dist/bookmarklet.txt) einfügen.
4. Speichern.
Ist die Lesezeichenleiste nicht sichtbar? In Chrome/Edge/Firefox: `Strg+Umschalt+B` (Mac: `Cmd+Umschalt+B`).
## Benutzung
- Öffne eine beliebige Website.
- Klicke in der Lesezeichenleiste auf **„Alt-Text Checker"**.
- Jedes Bild bekommt sofort ein kleines Label mit Status.
- Erneuter Klick auf das Bookmarklet aktualisiert die Analyse (z. B. nach dem Scrollen zu neu geladenen Bildern).
## Was bedeuten die Farben?
- **Rot Fehler**: Kein `alt`-Attribut und kein ARIA-Ersatz. Screenreader können das Bild nicht beschreiben.
- **Orange Warnung**: Leeres `alt=""` (dekorativ) oder nur über ARIA benannt statt über `alt`.
- **Grün OK**: Alt-Text ist vorhanden und nicht leer.
- **Grau Ignoriert**: Das Bild wurde manuell von der Prüfung ausgeschlossen (z. B. bewusst dekorativ).
## Bild von Prüfung ausschließen
Klicke direkt auf das kleine Label neben einem Bild. Das Bild wird sofort als „ausgeschlossen" markiert. Erneuter Klick macht das rückgängig. Der Ausschluss wird im `localStorage` des Browsers pro Website-URL gespeichert und bleibt auch nach einem Neuladen der Seite erhalten.
## Datenschutz
Das Bookmarklet führt reines JavaScript im Browser aus. Es werden keine Daten an externe Server gesendet die einzige Speicherung erfolgt lokal im `localStorage` des Browsers.