9. ikasgaia (10 guztira) · 11 min irakurtzeko · Berrikuspen-data: 26/10/2026
Irisgarritasuna garapen-fluxuan: osagaiak, aurrebistak eta proba automatizatuak
Ikasgai ireki bat irakurtzen ari zara. Matrikulatu testak eta ariketak egiteko, zure aurrerapena gordetzeko eta ziurtagiria lortzeko.
Matrikulatu · 6. maila (119 €)Ikastaro honetan ikasi duzun guztia hurrengo sprint-ean galtzen da inork babesten ez badu: etiketarik gabeko osagai berri bat, gelaxka baten altuera finkatzen duen birfaktorizazio bat, pantaila-aldaketa iragartzeari uzten dion liburutegi eguneratu bat. Ikasgai hau garapen-taldearen eguneroko lanean zentratzen da: okertzea zaila egiten duen osagai-geruza bat eraikitzea, irisgarritasuna programatu bitartean berrikustea eta egiaztapenak automatizatzea iOS, Android, React Native eta Flutterren probetan. Aplikazioen auditoria formala, Accessibility Inspector, Accessibility Scanner eta eskuzko proben protokoloarekin, maila bereko «Aplikazio mugikorren ebaluazioa» ikastaroan ikusiko duzu.
Ondo egitera behartzen duten osagaiak
Aplikazio hibridoen ikasgaian osagai irisgarrien geruza propio bat gomendatzen zen. Ideia horren bertsio eraginkorrena osagaien sinadurak diseinatzea da, akatsak konpilatu ez dezan: izen irisgarria derrigorrezko parametro bat bada, inork ezin du ahaztu.
// Compose: ikono-botoiak deskribapen bat eskatzen du
@Composable
fun BotonIcono(icono: ImageVector, descripcion: String, onClick: () -> Unit) {
IconButton(onClick = onClick) { // botoi-funtzioa eta 48 dp berez
Icon(icono, contentDescription = descripcion)
}
}
// SwiftUI: izenburua derrigorrezkoa da, ikonoa bakarrik ikusten bada ere
struct BotonIcono: View {
let titulo: LocalizedStringKey
let simbolo: String
let accion: () -> Void
var body: some View {
Button(action: accion) { Label(titulo, systemImage: simbolo) }
.labelStyle(.iconOnly) // izenburuak izen irisgarria izaten jarraitzen du
}
} Aplikatu ideia bera zerrendako errenkadari (izen konposatua eta ekintzak parametro gisa), atal-goiburuari (beti izenburu gisa markatzen duena), formularioko eremuari (derrigorrezko etiketa ikusgarria, sarreraren helburua eta errore-mezua) eta elkarrizketa-koadroari (derrigorrezko izenburua eta kudeatutako fokua). Dokumentatu osagai bakoitzean zer bermatzen duen eta zer geratzen den erabiltzen duenaren esku.
Funtsezko puntua
Ondo diseinatutako osagai batek ehun pantaila zuzentzen ditu aldi berean; gaizki diseinatutako batek akats bera hedatzen du guztietara. Horregatik, irisgarritasun-berrikuspenik errentagarriena osagai-liburutegiarena da, erabili aurretik.
Programatu bitartean berrikustea: analisi estatikoa eta aurrebistak
Analisi estatikoak omisio nabarmenak atzematen ditu aplikazioa exekutatu gabe:
- Android Lint-ek irisgarritasun-egiaztapenak ditu, hala nola
ContentDescription(deskribapenik gabeko irudia),ClickableViewAccessibility,KeyboardInaccessibleWidgetetaLabelFor. Igo itzazu errore-mailara proiektuaren konfigurazioan, integrazioa blokea dezaten. - SwiftLint-ek aukerako arauak eskaintzen ditu SwiftUIrako, hala nola
accessibility_label_for_imageetaaccessibility_trait_for_button. - React Native: eslint-plugin-react-native-a11y, aplikazio hibridoen ikasgaian ezagutu zenuena.
Aurrebistek pantaila bakoitza testu handiarekin edo kontraste handituarekin ikusteko aukera ematen dute, simulagailua ireki gabe:
// SwiftUI
#Preview("AX5 testua") {
FichaCita(cita: .ejemplo)
.environment(\.dynamicTypeSize, .accessibility5)
}
// Compose: letra-eskala bat baino gehiago oharpen bakarrean
@PreviewFontScale
@Composable
fun FichaCitaPreview() { FichaCita(cita = citaEjemplo) }
@Preview(fontScale = 2f, uiMode = Configuration.UI_MODE_NIGHT_YES)
@Composable
fun FichaCitaGrandeOscuroPreview() { FichaCita(cita = citaEjemplo) } Exekuzioan, Xcode-ren Environment Overrides panelak Dynamic Type, Handitu kontrastea edo Testu lodia aldatzen ditu hegan, eta Android Studioko Compose aurrebisten UI Check moduak irisgarritasun- eta egokitzapen-arazoak adierazten ditu. Minutu gutxiko berrikuspenak dira, eta testu moztuak eta kontraste nahikoa ez dutenak atzematen dituzte probetara iritsi aurretik.
Infografia · Mailak
Irisgarritasuna babesteko geruzak aplikazio batean
Oinarritik, akatsak prebenitzen dituenetik, gailurrera, benetako esperientzia berresten duenera
- 1. maila (oinarria): Osagai irisgarriakBotoiak, eremuak, errenkadak eta goiburuak dagoeneko badakarte izena, funtzioa, egoera eta 48 dp
- 2. maila: Analisi estatikoaAndroid Lint-ek, SwiftLint-ek eta eslint-ek falta diren etiketak eta funtzioak atzematen dituzte
- 3. maila: AurrebistakTestu handia, modu iluna eta kontrastea pantaila bakoitzean, exekutatu aurretik
- 4. maila: Semantika-probakOsagai bakoitzaren izena, funtzioa, egoera eta ekintzak egiaztatzen dituzten testak
- 5. maila: Auditoria UI probetanperformAccessibilityAudit, AccessibilityChecks eta Flutterren gidak CIan
- 6. maila (gailurra): Eskuzko probakVoiceOver, TalkBack, Switch eta teklatua benetako gailuan, eta erabiltzaileak
Irakurri infografia testu gisa
Sei geruza pilatuta, oinarritik gailurrera, aplikazio baten irisgarritasuna babesten dutenak haren garapenean. Oinarria, osagai irisgarriak: botoiak, eremuak, errenkadak eta goiburuak dagoeneko badakarte izena, funtzioa, egoera eta 48 dp. Bigarren geruza, analisi estatikoa: Android Lint-ek, SwiftLint-ek eta eslint-ek falta diren etiketak eta funtzioak atzematen dituzte. Hirugarrena, aurrebistak: pantaila bakoitza testu handiarekin, modu ilunarekin eta kontrastearekin berrikusten da exekutatu aurretik. Laugarrena, semantika-probak: izena, funtzioa, egoera eta ekintzak egiaztatzen dituzten testak. Bosgarrena, interfaze-probetako auditoriak: performAccessibilityAudit, AccessibilityChecks eta Flutterren gidak etengabeko integrazioan. Gailurra, eskuzko probak VoiceOver, TalkBack, Switch Access eta teklatuarekin benetako gailuan, eta erabiltzaileekin. Geruza bakoitzak beheko geruzek ikusi ezin dutena atzematen du.
Semantika-probak
Semantika-proba batek egiaztatzen du osagai batek erakutsi behar dituen izena, funtzioa, egoera eta ekintzak erakusten dituela. Azkarra eta egonkorra da, eta espero den portaera dokumentatzen du.
// Compose
@get:Rule val compose = createComposeRule()
@Test fun botonBuscarTieneNombreRolYAccion() {
compose.setContent { BarraSuperior() }
compose.onNodeWithContentDescription("Bilatu")
.assertHasClickAction()
.assert(SemanticsMatcher.expectValue(SemanticsProperties.Role, Role.Button))
compose.onNodeWithText("Martxoko mugimenduak")
.assert(SemanticsMatcher.keyIsDefined(SemanticsProperties.Heading))
}
// React Native Testing Library
expect(screen.getByRole('button', { name: 'Bilatu' })).toBeOnTheScreen();
// Flutter: etiketa semantikoaren araberako bilaketa
expect(find.bySemanticsLabel('Bilatu'), findsOneWidget); iOSen, UI probek elementuak irisgarritasun-informazioaren bidez aurkitzen dituzte: app.buttons["Bilatu"] botoi bat bilatzen du bere identifikatzailearen edo etiketaren arabera, eta label-ek espero den balioa duela egiaztatu dezakezu.
Ohiko akatsa
UI probek elementuak aurki ditzaten, norbaitek "btn_buscar_test" bezalako etiketak esleitzen dizkie botoiei. Probek gainditu egiten dute, eta VoiceOverrek «btn buscar test» irakurtzen du. Probetan elementuak aurkitzeko, erabili accessibilityIdentifier iOSen, testTag Compose-n edo testID React Native-n, ez baitira iragartzen; gorde etiketa pertsonak entzun behar duen izenerako, eta egiaztatu testean.
Auditoria automatikoak UI proben barruan
Plataformek irisgarritasun-egiaztapen automatikoak exekutatzea ahalbidetzen dute probek zeharkatzen duten pantaila bakoitzaren gainean:
// iOS 17 / Xcode 15: uneko pantailaren auditoria
func testAuditoriaMisCitas() throws {
let app = XCUIApplication()
app.launch()
app.buttons["Nire hitzorduak"].tap()
try app.performAccessibilityAudit(for: [.dynamicType, .contrast, .hitRegion,
.sufficientElementDescription, .textClipped]) { incidencia in
// true itzultzen du berrikusitako eta dokumentatutako arazoetarako bakarrik
incidencia.auditType == .contrast && incidencia.element?.identifier == "logo-municipal"
}
}
// Android Espresso-rekin: Accessibility Test Framework-en egiaztapenak ekintza bakoitzean
@BeforeClass @JvmStatic
fun activarComprobaciones() {
AccessibilityChecks.enable().setRunChecksFromRootView(true)
}
// Flutter: flutter_test-en barne dauden gidak
testWidgets('hitzorduen pantailak oinarrizko gidak betetzen ditu', (tester) async {
final handle = tester.ensureSemantics();
await tester.pumpWidget(const MiApp());
await expectLater(tester, meetsGuideline(androidTapTargetGuideline));
await expectLater(tester, meetsGuideline(labeledTapTargetGuideline));
await expectLater(tester, meetsGuideline(textContrastGuideline));
handle.dispose();
}); Compose-ren proba-liburutegiaren bertsio berriek Accessibility Test Framework-en egiaztapenak ere aktibatzea ahalbidetzen dute; kontsultatu zure bertsioaren dokumentazioa. Auditoria horiek atzematen dituzte deskribapenik gabeko elementuak, ukipen-helburu txikiak, kontraste eskasa edo testu handiarekin moztutako testua. Ez dute atzematen etiketa bat zuzena den, irakurketa-ordenak zentzurik duen, fokua leku egokira itzultzen den elkarrizketa-koadro bat ixtean, ezta zeregin oso bat egin daitekeen ere: 4. mailako tresna automatikoen ikastaroan ikusi zenuen bezala, automatizazioak arazoen zati bat bakarrik estaltzen du.
Onarpen-irizpideak eta «eginda»ren definizioa
Automatizazioa talde-akordioekin sostengatzen da. Sartu interfazea duen istorio bakoitzaren «eginda»ren definizioan egiazta daitezkeen irizpide gutxi batzuk:
- Funtzionaltasunaren ibilbide osoa VoiceOver eta TalkBackekin benetako gailuan, elementu muturik edo bikoiztuta gabe.
- Testua gehienekoan eta testu lodiarekin berrikusitako pantailak, moztutako testurik gabe.
- Alternatiba duten keinuak eta irisgarritasun-ekintzak; 44 pt edo 48 dp-ko helburuak.
- Pantaila-aldaketetan, elkarrizketa-koadroetan eta erroreetan kudeatutako fokua.
- Semantika-probak eta auditoria automatikoa berdean etengabeko integrazioan.
Probatu zuk zeuk
Aplikazio baten kodea eskura baduzu, exekutatu Android Lint edo SwiftLint irisgarritasun-arauak aktibatuta, eta zenbatu abisuak. Bestela, ireki aurrebista bat edo simulagailua testu-tamaina handienarekin, eta idatzi zenbat pantailak mozten dituzten testuak. Zenbaki hori abiapuntu ona da zure lehen «eginda»ren definiziorako.
Laburpena
- Diseinatu sinadurek izen irisgarria, etiketa ikusgarria eta izenburua eskatzen dituzten osagaiak: akatsak konpilatzeari uzten dio.
- Erabili analisi estatikoa (Android Lint, SwiftLint, eslint) eta testu handiko eta kontrasteko aurrebistak programatu bitartean.
- Semantika-probek izena, funtzioa, egoera eta ekintzak egiaztatzen dituzte; aurkitu elementuak proba-identifikatzaileekin, inoiz ez etiketa faltsuekin.
performAccessibilityAudit-ek,AccessibilityChecks-ek etaflutter_test-en gidek pantaila bakoitzeko egiaztapenak automatizatzen dituzte, baina ez dute eskuzko proba ordezten.- Irisgarritasun-irizpide egiaztagarriak dituen «eginda»ren definizio batek entrega bakoitzeko lana babesten du.
Ikastaro honetako 4 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 €)