Announcer 1.2.0
Die <velin-announcer>-Komponente stellt eine ARIA-Live-Region fuer hoefliche Screenreader-Updates nach asynchronen Aktionen bereit. Hinzugefuegt in 0.7.5. English: Announcer
Reifegrad: In VelinStyle 1.2.0 als stabil dokumentiert. Design Intelligence (Plan / Review / Agent-Meta) ist separat und, wo angegeben, Beta / Grundlage.
Wann verwenden
- Kuendige kurze Statusmeldungen fuer assistive Technologien ueber
<velin-announcer>an. - Wenn eine andere Komponente (oder dein App-Code) eine polite/assertive Live-Region braucht, ohne sie ad hoc zu bauen.
Wann nicht verwenden
- Visible persistent banners — use Alerts or Toasts.
- Form error summaries after submit — use Form summary.
Beispiel
<velin-announcer></velin-announcer>
<script>
VelinAnnouncer.announceGlobal('Gespeichert');
</script>
JavaScript-API
| API | Beschreibung |
|---|---|
VelinAnnouncer.announceGlobal(message) | Announce via the first velin-announcer on the page |
element.announce(message) | Announce on a specific instance |
Import
Lade das Bundle einmal und nutze dann das Custom Element in deinem Markup:
<script type="module" src="../../dist/velinstyle-components.min.js"></script>
<velin-announcer>…</velin-announcer>
Barrierefreiheit
- Prefer concise messages; avoid flooding the live region with rapid updates.
- Nutze den Announcer fuer Statusaenderungen, die nicht bereits durch fokussierte UI offengelegt werden (siehe Beispiele auf dieser Seite).