Semantics en testtags

Compose bouwt naast de visuele boom ook een semantics tree. Deze beschrijft wat elk element betekent en is precies wat zowel tests als schermlezers uitlezen.

Als een node in de boom geen betekenis heeft, kunnen finders deze niet bereiken en kan TalkBack deze niet aankondigen. Goede semantics maken je app zowel testbaar als toegankelijk. ♿

Pictogrammen en afbeeldingen bevatten geen tekst, dus geef ze een contentDescription. Deze wordt opgenomen in de semantiekboom, zodat tests ze kunnen vinden en schermlezers ze kunnen beschrijven.

Soms hebben meerdere nodes dezelfde tekst en raakt een text finder in de war. Je hebt dan een stabiele ingang nodig die niet afhankelijk is van het zichtbare label.

Een testTag is een onzichtbare identifier die je met een Modifier toevoegt. Hiermee krijgt een node een unieke naam voor tests, zonder dat het uiterlijk verandert.

Als de tag is toegevoegd, zoek je de node met onNodeWithTag. Dit blijft zeer betrouwbaar, ook wanneer tekst tussen talen of statussen verandert.

Houd ze gescheiden: contentDescription is bedoeld voor echte gebruikers, terwijl testTag alleen voor tests bestaat. Gebruik de ene niet voor de taak van de andere.

Voor volledige controle kun je met de semantics-modifier aangepaste eigenschappen instellen, bijvoorbeeld om een node voor toegankelijkheidshulpmiddelen als kop te markeren.

Compose kan een ouder en zijn kinderen met mergeDescendants samenvoegen tot één node. Zo wordt een hele rij als één duidelijke, gebruiksvriendelijke eenheid aangekondigd.

Kun je een ontbrekende node niet vinden? Roep printToLog aan op de root om de volledige semantiekboom af te drukken. Daarna kun je precies lezen wat er beschikbaar is om op te zoeken.

Als je tijdens het bouwen duidelijke beschrijvingen en tags toevoegt, schrijven je tests zichzelf bijna. Toegankelijke en testbare apps groeien uit dezelfde gewoonten.

De semantiekboom ondersteunt zowel testen als toegankelijkheid. Gebruik contentDescription voor gebruikers en testTag voor tests, zodat je UI eenvoudig te controleren blijft. 🌳