Semantics og testtags

Compose bygger et semantiktræ ved siden af det visuelle træ. Det beskriver, hvad hvert element betyder, og det er præcis det, som både tests og skærmlæsere læser.

Hvis en node ikke har nogen betydning i træet, kan findere ikke nå den, og TalkBack kan ikke annoncere den. God semantik gør din app både testbar og tilgængelig. ♿

Ikoner og billeder indeholder ingen tekst, så giv dem en contentDescription. Den føjer oplysninger til semantiktræet, så tests kan finde dem, og skærmlæsere kan beskrive dem.

Nogle gange deler mange noder den samme tekst, så en tekstfinder bliver forvirret. Du har brug for et stabilt håndtag, der ikke afhænger af den synlige etiket.

Et testTag er en usynlig identifikator, som du tilknytter med en Modifier. Det giver en node et entydigt navn til tests uden at påvirke dens udseende.

Når noden er mærket, finder du den med onNodeWithTag. Det fungerer stabilt, selv når teksten ændres mellem sprog eller tilstande.

Hold dem adskilt: contentDescription er til rigtige brugere, mens testTag kun findes til tests. Brug ikke den ene til at udføre den andens opgave.

Hvis du vil have fuld kontrol, lader semantics-modifikatoren dig angive tilpassede egenskaber, f.eks. at markere en node som en overskrift for tilgængelighedsværktøjer.

Compose kan sammenflette en forælder og dens børn til én node med mergeDescendants. Så bliver en hel række annonceret som én samlet og letforståelig enhed.

Sidder du fast på grund af en manglende node? Kald printToLog på roden for at udskrive hele semantiktræet, og se derefter præcis, hvad du kan matche.

Når du tilføjer tydelige beskrivelser og tags under opbygningen, skriver dine tests næsten sig selv. Tilgængelige og testbare apps vokser ud af de samme vaner.

Semantiktræet understøtter både test og tilgængelighed. Brug contentDescription til brugere og testTag til tests, så din brugerflade er nem at kontrollere. 🌳