Altinn / Altinn/altinn-components

Innhold, klarspråk og forutsigbarhet (UU)

Open
#1,097 0 comments 0 reactions 0 assignees View on GitHub
wcag
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

Open the contributing 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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.