Addaw, joan hasierara Egin dohaintza

4. ikasgaia (10 guztira) · 12 min irakurtzeko · Berrikuspen-data: 26/10/2026

Android: TalkBack, contentDescription, Compose-ren semantika eta Switch Access

Ikasgai ireki bat irakurtzen ari zara. Matrikulatu testak eta ariketak egiteko, zure aurrerapena gordetzeko eta ziurtagiria lortzeko.

Matrikulatu · 6. maila (119 €)

Androiden, irisgarritasuna irisgarritasun-zerbitzutik igarotzen da: TalkBackek, Switch Accessek, Ahots bidezko sarbideak eta beste batzuek frameworkak bistetatik (View sistema) edo semantikatik (Jetpack Compose) abiatuta eraikitzen duen AccessibilityNodeInfo nodo-zuhaitza kontsultatzen dute. Ikasgai honek azaltzen du garatzaileak zer erakutsi behar duen sistema bakoitzean, Kotlin kodearekin, eta nola probatu TalkBack eta Switch Access erabiliz.

TalkBack: ezinbestekoa

Aktibatu TalkBack bolumen-botoi biekin (irisgarritasun-lasterbidea) edo Ezarpenak > Erabilerraztasuna atalean. Keinuak: eskuinera/ezkerrera irristatu hurrengora/aurrekora joateko, ukitu bikoitza aktibatzeko, gora/behera irristatu granulartasuna edo irakurketa-modua aldatzeko, eta TalkBack menua (hiru hatzez ukitu edo behera eta gero eskuinera irristatu) ekintzetarako. TalkBackek nodo bakoitzerako iragartzen ditu: deskribapena edo testua, egoera (markatuta, hautatuta, zabalduta), funtzioa («botoia», «kontrol-laukia»), ekintzak («sakatu birritan aktibatzeko») eta, baldin badaude, ekintza pertsonalizatuak menuan. Aktibatu TalkBack > Garatzaileen ezarpenak atalean «Erakutsi ahots-irteera» aukera, iragartzen dena pantailan ikusteko: ezinbestekoa auditatzeko eta ebidentziak grabatzeko.

View sistema (XML eta Kotlin)

  • android:contentDescription: irudien eta ikono-botoien izen irisgarria. Irudi apaingarrietarako, @null; ImageView informatiboetarako, testu deskribatzailea. Testua duten TextView eta Button elementuetan ez da behar: testua bera da izena.
  • android:importantForAccessibility="no" elementu bat zerbitzutik ezkutatzeko; "noHideDescendants" haren haurrak ere ezkutatzeko (adibidez, elkarrizketa-koadro baten atzeko edukia).
  • android:labelFor EditText bat etiketatzen duen TextView elementuan; bestela, TextInputLayout hint-ekin, etiketa behar bezala kudeatzen baitu.
  • 48dp-ko android:minHeight/minWidth ukipen-eremurako, edo TouchDelegate eremua handitzeko tamaina bisuala aldatu gabe.
  • android:accessibilityHeading="true" (API 28) izenburuetarako; TalkBackek haien artean nabigatzea ahalbidetzen du.
  • android:accessibilityLiveRegion="polite" testua aldatzen zaien eta iragarri behar diren guneetarako (egoera-mezuak, 4.1.3). announceForAccessibility() ez da gomendatzen, eta zaharkitutzat ageri da API 36tik (Android 16) aurrera: erabili live regions edo, leiho-aldaketetarako, setAccessibilityPaneTitle.
  • android:accessibilityTraversalBefore/After ibilbide-ordena zuzentzeko, diseinu bisuala eta logikoa bat ez datozenean.
  • sp unitateak testu guztirako (sistemaren ezarpenarekin eskalatzen dira); inoiz ez dp edo tamaina finkoak testuan; android:maxLines kontuz, eta wrap_content altueretan.
  • android:screenOrientation: ez behartu portrait, funtsezkoa ez bada (1.3.4).

Bista pertsonalizatu baterako (grafiko bat, puntuazio-kontrol bat), inplementatu nodoa funtzioz, egoeraz eta ekintzez betetzen duen AccessibilityDelegate bat:

class PuntuacionView(context: Context) : View(context) {
    var valor = 3
    init {
        isFocusable = true
        ViewCompat.setAccessibilityDelegate(this, object : AccessibilityDelegateCompat() {
            override fun onInitializeAccessibilityNodeInfo(
                host: View, info: AccessibilityNodeInfoCompat
            ) {
                super.onInitializeAccessibilityNodeInfo(host, info)
                info.className = SeekBar::class.java.name     // funtzioa: kontrol doigarria
                info.contentDescription = "Balorazioa"
                info.stateDescription = "5 izarretik $valor"
                info.addAction(AccessibilityNodeInfoCompat.ACTION_SCROLL_FORWARD)
                info.addAction(AccessibilityNodeInfoCompat.ACTION_SCROLL_BACKWARD)
            }
            override fun performAccessibilityAction(
                host: View, action: Int, args: Bundle?
            ): Boolean = when (action) {
                AccessibilityNodeInfoCompat.ACTION_SCROLL_FORWARD -> { cambiar(+1); true }
                AccessibilityNodeInfoCompat.ACTION_SCROLL_BACKWARD -> { cambiar(-1); true }
                else -> super.performAccessibilityAction(host, action, args)
            }
        })
    }
    private fun cambiar(d: Int) {
        valor = (valor + d).coerceIn(1, 5); invalidate()
        ViewCompat.setStateDescription(this, "5 izarretik $valor")
    }
}

Funtsezko puntua

Irisgarritasun-delegatu bat idatzi aurretik, galdetu zeure buruari osagai estandar bat erabil dezakezun (MaterialButton, Slider, CheckBox, Chip). Material osagaiek dagoeneko erakusten dituzte funtzioa, egoera eta ekintzak, eta Androiden bertsio bakoitzarekin eguneratuta mantentzen dira. Bista pertsonalizatua azken baliabidea da.

Jetpack Compose: semantika

Compose-n ez dago bistarik: composable-ek eraikitako semantika-zuhaitz bat dago. Material 3 osagaiek (Button, Checkbox, Switch, TextField) funtzioa eta egoera ematen dituzte. Garatzaileak falta dena osatzen du semantics aldatzailearekin:

@Composable
fun FilaMovimiento(m: Movimiento, onAbrir: () -> Unit, onCategorizar: () -> Unit) {
    Row(
        modifier = Modifier
            .fillMaxWidth()
            .heightIn(min = 48.dp)
            .clickable(role = Role.Button, onClick = onAbrir) // funtzioa eta ekintza
            .semantics(mergeDescendants = true) {  // nodo bakarra
                contentDescription = "${m.concepto}, ${m.importeAccesible}, ${m.fechaLarga}"
                customActions = listOf(
                    CustomAccessibilityAction("Sailkatu") { onCategorizar(); true }
                )
            }
    ) {
        Icon(painterResource(m.icono), contentDescription = null) // apaingarria
        Column(Modifier.weight(1f)) {
            Text(m.concepto, style = MaterialTheme.typography.bodyLarge)
            Text(m.fechaFormateada, style = MaterialTheme.typography.bodySmall)
        }
        Text(m.importeFormateado)
    }
}

// Atalaren izenburua
Text(
    "Martxoko mugimenduak",
    style = MaterialTheme.typography.titleMedium,
    modifier = Modifier.semantics { heading() }
)

// Ikono-botoia: beti deskribapenarekin
IconButton(onClick = onBuscar) {
    Icon(Icons.Default.Search, contentDescription = "Bilatu")
}

// Aldatzean iragarri behar den egoera-mezua
Text(
    estado,
    modifier = Modifier.semantics { liveRegion = LiveRegionMode.Polite }
)

Semantika-APIaren beste elementu batzuk: role = Role.Button (edo Checkbox, Switch, Tab, Image) kontrol bat eskuz eraikitzen duzunean; stateDescription egoeretarako («Zabalduta»); clearAndSetSemantics { } haurren semantika osorik ordezkatzeko; isTraversalGroup = true eta traversalIndex semantics barruan, ibilbide-ordena kontrolatzeko (Compose 1.5+); Modifier.minimumInteractiveComponentSize() (Material osagaiek lehenespenez aplikatzen dute) 48 dp bermatzeko; Modifier.focusRequester fokua lehen errorera mugitzeko; Modifier.toggleable/selectable clickable-en ordez egoera duten elementuetarako, funtzioa eta egoera automatikoki gehitzen baitituzte.

Testuaren eskalatzerako, erabili sp (Materialen tipografia-estiloek dagoeneko egiten dute) eta egiaztatu «Letra-tamaina» gehienekoan eta «Bistaratzearen tamaina» handia jarrita. Altuera finkoak eta maxLines = 1 overflow = Ellipsis-ekin funtsezko testuetan dira akatsik ohikoenak.

Ohiko akatsa

contentDescription guztian jartzea, testuetan eta edukiontzietan barne, «TalkBackek irakur dezan». Emaitza zarata da: testua bi aldiz iragartzen da, edukiontziak elementu fokagarri huts bihurtzen dira eta irudi apaingarriek irakurketa eteten dute. Araua: deskribapena testua ez diren elementu informatiboetan bakarrik; null apaingarrietan; mergeDescendants bidezko taldekatzea zenbait testuk unitate bat osatzen dutenean.

Switch Access, Ahots bidezko sarbidea eta teklatua

Switch Access aukerak Android etengailu batekin edo birekin erabiltzea ahalbidetzen du: elementu fokagarri eta eragingarriak zeharkatzen ditu (edo errenkadaka/puntuka eskaneatzen du) eta hautatutakoa aktibatzen du. Kontrol guztiak irisgarritasun-mailan focusable eta clickable izatea eskatzen du, ordena logikoa izatea eta keinu bidezko ekintzarik soilik ez egotea. Ahots bidezko sarbideak («Sakatu Bilatu», «Erakutsi zenbakiak») testu ikusgarria edo contentDescription erabiltzen du: deskribapenik gabeko ikono-botoietara ezin da iritsi. Teklatu fisikoek (desgaitasun motorra duten pertsonek asko erabiltzen dituzte) android:focusable eta nextFocusDown/Up koherenteak eskatzen dituzte; Compose-n, Modifier.focusable() eta focusProperties. Foku-adierazleak (2.4.7) ikusgarria izan behar du: Material osagaiek marrazten dute; kontrol propioetan, Modifier.onFocusChanged edo state_focused bat drawable elementuan erabiliz marraztu behar da.

Aplikazioak errespetatu behar dituen sistemaren ezarpenak

  • Kendu animazioak (Ezarpenak > Erabilerraztasuna): kontsultatu Settings.Global.ANIMATOR_DURATION_SCALE edo utzi frameworkaren animazioek errespeta dezaten.
  • Kontraste handiko testua, Koloreen alderantzikatzea eta Koloreen zuzenketa: erabili gaiaren koloreak eta egiaztatu modu ilunean.
  • Ekintzak egiteko denbora (AccessibilityManager.getRecommendedTimeoutMillis): toast, snackbar eta aldi baterako mezuei aplikatzen zaie (2.2.1).
  • Audio monoa eta azpitituluak: bideoa duten aplikazioetan, errespetatu CaptioningManager-en hobespenak.

Adibidea

Osasun-zentro baten aurretiko hitzorduen aplikazioa: tarte libreen zerrendak Chip hautagarriak erabiltzen ditu (funtzioa eta egoera automatikoak); egutegi pertsonalizatuak egun bakoitza erakusten du role = Role.Button, data osoa duen contentDescription eta «Tarterik ez» edo «3 tarte» stateDescription erabiliz; berrestean, liveRegion duen Text batek «Hitzordua berretsi da: maiatzaren 12an, 9:30ean» iragartzen du, eta fokua «Gehitu egutegira» botoira pasatzen da. Dena funtzionatzen du TalkBack, Switch Access eta teklatuarekin.

Laburpena

  • TalkBackek irisgarritasun-nodoaren deskribapena, egoera, funtzioa eta ekintzak iragartzen ditu; «Erakutsi ahots-irteera» aukerak zer iragartzen den ikustea ahalbidetzen du.
  • Views: contentDescription testua ez diren elementu informatiboetan bakarrik (@null apaingarrietan), labelFor, accessibilityHeading, accessibilityLiveRegion, 48 dp, sp, orientazioa behartu gabe.
  • Compose: semantics { contentDescription, role, stateDescription, heading(), liveRegion, customActions }, mergeDescendants taldekatzeko, clearAndSetSemantics, traversalIndex ordenarako.
  • Hobetsi Material osagaiak; eskuzko delegatuak eta semantikak azken baliabidea dira.
  • Switch Accessek, Ahots bidezko sarbideak eta teklatuak kontrol fokagarriak, izendunak eta foku ikusgarriarekin eskatzen dituzte, eta keinu bidezko ekintzarik soilik ez.

Ikastaro honetako 2 ikasgai irakurri dituzu: ez itzazu galdu

Sortu zure kontua, gorde irakurri duzuna eta jarraitu ikastaroarekin, osorik:

  • Ikasgai honetako testa (3 galdera), ikasitakoa egiaztatzeko
  • Benetako orriekin egindako ariketa praktikoak
  • Zure aurrerapena gordeta: utzi zenuen lekutik jarraituko duzu, edozein gailutatik
  • Ikastaroaren egiaztagiria, orduekin, eta 6. mailako ziurtagiria azterketa gainditzen duzunean

Zure Google kontuarekin edo zure posta elektronikoarekin bakarrik sartzen zara. Ez duzu pasahitzik behar.

Matrikulatu · 6. maila (119 €)