Altinn / Altinn/altinn-components
Innhold, klarspråk og forutsigbarhet (UU)
- Dominant language
- TypeScript
- Stars
- 0
- Forks
- 1
- Avg merge
- 10h 22m
- Merged PRs (30d)
- 32
Description
**Bakgrunn**
Altinn-components inneholder tekster, labels og beskjeder som formidles til brukere, både visuelt og via hjelpeteknologi. WCAG-prinsipp 3 (forståelig) krever at disse er tydelige, konsistente og gir nok kontekst til at brukeren forstår hva som skjer og hva som forventes. Dette gjelder alt fra aria-labels på knapper til feilmeldinger i skjemaer og roller på statusmeldinger.
**Klarspråk og forutsigbarhet er avgjørende for:**
- Skjermleserbrukere som kun hører teksten, uten visuell kontekst må labels stå på egne ben
- Brukere med kognitive funksjonsnedsettelser som trenger tydelig og konsistent språk
- Alle brukere som forventer forutsigbar oppførsel på tvers av komponenter
**Mål**
- Alle interaktive elementer har beskrivende, kontekstrike tilgjengelige navn (ikke generiske "close" eller "prev icon")
- Roller (role="alert" vs role="status") brukes konsistent basert på innholdets faktiske viktighetsgrad
- Skjemakomponenter støtter tydelige feilmeldinger, obligatorisk-markering og hjelpetekst
- Lignende komponenter oppfører seg likt, konsistent identifikasjon og forutsigbar interaksjon
- Dekorative bilder skjules korrekt, meningsbærende bilder har beskrivende alt-tekst
Contributor guide
Research direction
The issue names no files, tests, or entry points; begin by inventorying the components and their accessible labels, roles, form messages, and image alternatives. Done means the stated WCAG-related goals are applied consistently across the component set and verified for predictable interaction and clear user-facing text.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- react, typescript
- Domain
- accessibility, frontend
- Issue type
- Refactor
- Difficulty
- 5/5
- Estimated time
- Over a week
- Activity status
- Quiet
- Clarity
- Needs clarification
- Newbie friendliness
- 25/100