Melding
Een bericht dat de pagina aankondigt zonder dat de focus verplaatst: een status (beleefd) of een alert (dringend, focusbaar). Het live-gebied is het element zelf.
Demo: Alert
Het formulier heeft twee fouten.
Eigenschappen bewerken
Wijzig een waarde en pas die toe; de demo wordt met de nieuwe waarden getoond. Een geweigerde waarde wordt bij het veld gemeld en de demo houdt de beginwaarde.
Eigenschappen
| Eigenschap | Type | Standaard | Toegestane waarden | Omschrijving |
|---|---|---|---|---|
kind | string | status | status, alert | status: role=status met aria-live=polite; alert: role=alert, focusbaar. |
text | string | verplicht | Eén of twee zinnen, in de taal van de pagina. | |
id | string | geen | Optioneel, voor een script of een link die de focus erop zet. |
Gebeurtenissen
Dit component verstuurt geen gebeurtenissen.
Toetsenbord
Dit component heeft geen eigen toetsenbordgedrag.
Toegankelijkheid
- De tekst wordt aangekondigd wanneer hij verschijnt of verandert; verder beweegt er niets.
- De balk aan het begin (accent voor een status, danger voor een alert) is een tweede aanwijzing naast de rol, nooit de enige.
Waarom zo
Wat Speech in de UI-kit aankondigt zonder focusverplaatsing, op het web: een live-gebied. De soort is de rol en een modifierklasse, zodat de kleur van de balk aan het begin niets anders kan zeggen dan de rol. Een alert krijgt tabindex="-1" zodat een formulier de focus naar zijn foutsamenvatting kan verplaatsen.
Verwijzingen
- Accessibility/Speech.cs
- forms-pipeline.md section 7
Gebruikt
Dit component gebruikt geen ander component.
Gebruikt door
Nog geen gebruik vastgelegd.
README
notice
A message the page announces without focus moving: a status (polite live region: a form's answer) or an alert
(assertive, focusable with tabindex="-1": an error summary). The kind is the role and a modifier class.
- Callers: a site's hooks (the catalogue page of
examples/site); the form's answer and error summary when the form component lands (docs/architecture/forms-pipeline.md, section 7).
Change log
- 2026-10-14:
component.json(the manifest: the props now live there) anddemo.php(the demos the inspector and the catalogue page show) added; see docs/architecture/inspector.md. - 2026-10-14: new.