Addaw, joan hasierara Egin dohaintza

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

Aplikazio hibridoak eta plataforma anitzekoak: React Native, Flutter eta WebView

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

Matrikulatu · 6. maila (119 €)

Espainian auditatzen diren aplikazioen zati handi bat ez dago Swift edo Kotlin lengoaietan idatzita, baizik eta React Native, Flutter, Ionic/Capacitor edo .NET MAUI erabiliz, edo zuzenean web paketatu gisa. Teknologia bakoitzak bere modua du jatorrizko irisgarritasun-APIa elikatzeko, eta bakoitzak bere puntu itsuak ditu. Ikasgai honek laburbiltzen du framework bakoitzak zer eskaintzen duen, nola erabiltzen den eta zer akats sortzen dituen maizen.

Printzipio komuna: plataformara itzultzea

Teknologia horiek guztiek UIAccessibility-rekin hitz egiten amaitzen dute iOSen, eta AccessibilityNodeInfo-rekin Androiden. Osagai bakoitzerako galdera hau da: zer izen, funtzio, egoera, balio eta ekintza iristen zaizkio jatorrizko irisgarritasun-zerbitzuari? Frameworkak ez baditu itzultzen, VoiceOverrek edo TalkBackek laukizuzen mutu bat ikusiko dute. Horregatik, egiaztapena beti egin behar da benetako laguntza-teknologiekin bi sistemetan, inoiz ez web-emuladorean edo frameworkaren ikuskapen-tresnarekin bakarrik.

React Native

React Nativek irisgarritasun-props-ak erakusten ditu bere oinarrizko osagaietan (View, Text, Pressable, TouchableOpacity, Image…), eta bi plataformetara mapatzen dira:

  • accessible={true}: bista eta haren haurrak elementu irisgarri bakarrean taldekatzen ditu (isAccessibilityElement / mergeDescendants-en baliokidea). Pressable-ek eta touchable-ek lehenespenez aktibatzen dute.
  • accessibilityLabel: izena. Derrigorrezkoa ikono-botoietan eta irudi informatiboetan.
  • accessibilityRole: button, link, header, image, checkbox, switch, tab, adjustable, alert, summary…
  • accessibilityState: {disabled, selected, checked, busy, expanded}; accessibilityValue: {min, max, now, text}.
  • accessibilityHint, accessibilityActions + onAccessibilityAction ekintza pertsonalizatuetarako.
  • accessibilityLiveRegion (Android) eta AccessibilityInfo.announceForAccessibility() (biak) egoera-mezuetarako.
  • importantForAccessibility="no-hide-descendants" (Android) eta accessibilityElementsHidden (iOS) ezkutatzeko; accessibilityViewIsModal (iOS) elkarrizketa-koadroetarako.
  • AccessibilityInfo.isScreenReaderEnabled() eta isReduceMotionEnabled() portaerak egokitzeko.
<Pressable
  accessibilityRole="button"
  accessibilityLabel={`${m.concepto}, ${m.importeAccesible}, ${m.fechaLarga}`}
  accessibilityHint="Mugimenduaren xehetasuna irekitzen du"
  accessibilityActions={[{ name: 'categorizar', label: 'Sailkatu' }]}
  onAccessibilityAction={(e) => e.nativeEvent.actionName === 'categorizar' && categorizar(m)}
  onPress={() => abrir(m)}
  style={{ minHeight: 48 }}
>
  <Image source={m.icono} accessible={false} />
  <Text>{m.concepto}</Text>
  <Text>{m.importeFormateado}</Text>
</Pressable>

React Nativeko ohiko akatsak: accessibilityLabel gabeko ikono bat biltzen duen TouchableOpacity; accessibilityRole="header" gabeko atal-goiburuak; atzeko fokua blokeatzen ez duten hirugarrenen liburutegietako modalak; allowFontScaling={false} duen testua (eskalatzea desaktibatzen du eta 1.4.4 hausten du) edo baxuegia den maxFontSizeMultiplier duena; pantaila-aldaketa iragartzen ez duten nabigazio-liburutegiak (egiaztatu pantailaren izenburuak fokua jasotzen duela edo iragartzen dela). eslint-plugin-react-native-a11y tresnek eta react-native-testing-library bidezko probek omisioak atzematen laguntzen dute.

Flutter

Flutterrek pixel guztiak bere motorrarekin marrazten ditu; ez du jatorrizko bistarik erabiltzen. Irisgarritasunerako, plataformarekin sinkronizatzen duen semantika-zuhaitz paralelo bat eraikitzen du. Material eta Cupertino widget-ek lehenespenez elikatzen dute; pertsonalizatuek widget hau behar dute: Semantics:

Semantics(
  label: '${m.concepto}, ${m.importeAccesible}, ${m.fechaLarga}',
  hint: 'Mugimenduaren xehetasuna irekitzen du',
  button: true,
  onTap: () => abrir(m),
  customSemanticsActions: {
    CustomSemanticsAction(label: 'Sailkatu'): () => categorizar(m),
  },
  child: ExcludeSemantics(      // haurrek ez dute nodo propiorik sortzen
    child: Row(children: [
      Image.asset(m.icono),
      Text(m.concepto),
      Text(m.importeFormateado),
    ]),
  ),
);

// Izenburua
Semantics(header: true, child: Text('Martxoko mugimenduak'));

// Irudi informatiboa
Image.asset('grafico.png', semanticLabel: 'Gastuak kategoriaren arabera: elikadura % 40…');

// Egoeraren iragarpena
SemanticsService.announce('Hitzordua berretsi da', TextDirection.ltr);

Beste elementu batzuk: MergeSemantics haurrak nodo bakarrean batzeko, ExcludeSemantics ezkutatzeko, Semantics(sortKey: OrdinalSortKey(n)) ordenarako, liveRegion: true egoera-mezuetarako, eta MediaQuery.textScalerOf(context) eskalatzea errespetatzeko (Text elementuek lehenespenez egiten dute, textScaler finkatzen ez bada). MaterialApp-eko showSemanticsDebugger: true banderak semantika-zuhaitza erakusten du interfazearen gainean. Ohiko puntu ahulak: Semantics(button: true) gabeko edukiontzien gaineko GestureDetector edo InkWell, semanticLabel gabeko Icon, posizioa erakusten ez duten widget pertsonalizatuak dituzten zerrenda luzeak, eta Flutterren web-bertsioa, zeinaren irisgarritasuna sortutako DOM zuhaitz «semantiko» baten mende baitago, eta aktibatu eta egiaztatu egin behar baita.

Funtsezko puntua

Flutterren eta bere pixelak marrazten dituen edozein motorretan, irisgarritasuna ez da ezertatik heredatzen: semantika-zuhaitzak elementu bat deskribatzen ez badu, elementu hori ez da existitzen TalkBackentzat ezta VoiceOverrentzat ere. Semantika-ikuskatzaileak garapen-errutinaren parte izan behar du.

WebView-ko aplikazioak: Ionic, Capacitor, Cordova eta PWA paketatuak

Interfazea WKWebView edo WebView baten barruko HTML bada, weberako WCAG 2.2 osorik aplikatzen dira: HTML semantikoa, ARIA, fokua, kontrastea. Jatorrizko laguntza-teknologiek DOMa irakurtzen dute nabigatzailearen motorraren bidez. Berezitasunak:

  • Baliteke sistemaren testu-eskalatzea WebView-ari ez aplikatzea: Androiden, WebSettings.textZoom-ek sistemaren letra-eskalari jarraitu behar dio (aplikazio askok % 100ean finkatzen dute); iOSen, CSSak font: -apple-system-body (eta tamaina erlatiboak) erabili behar ditu Dynamic Typeri jarraitzeko.
  • WebView-a biltzen duten jatorrizko barrek eta kontrolek (fitxak, atzera botoia) jatorrizko arauak betetzen dituzte; jatorrizko zatiaren eta web-zatiaren arteko foku-ordenak koherentea izan behar du.
  • Kamera, biometria edo jatorrizko jakinarazpenetarako pluginek alternatiba eta feedback irisgarria izan behar dute.
  • Ionic Frameworkek ARIA zentzuzkoa duten osagaiak ditu, baina bertsio zaharrek eta osagai pertsonalizatuek auditoria behar dute, beste edozein webek bezala.
  • «Pantailaren» izenburua (2.4.2) nabigatzean iragarri behar da: WebView baten barruko SPA batean, kudeatu fokua eta document.title beste edozein SPAtan bezala.

.NET MAUI eta beste batzuk

MAUIk SemanticProperties.Description, SemanticProperties.Hint, SemanticProperties.HeadingLevel eta SemanticScreenReader.Announce() erakusten ditu; AutomationProperties.IsInAccessibleTree-k ezkutatzea ahalbidetzen du. Kotlin Multiplatformek, Compose Multiplatformekin, Compose-ren semantika heredatzen du Androiden eta UIAccessibility-ra itzultzen du iOSen, oraindik garatzen ari den estaldurarekin; komeni da bertsio bakoitza egiaztatzea. Unityk eta beste joko-motor batzuek ez dute jatorrizko euskarri osorik, eta plugin espezifikoak behar dituzte.

Praktika on komunak

  1. Hobetsi frameworkaren osagaiak eskuz marraztutako kontrolen aurretik; funtzioa, egoera eta ekintzak heredatzen dituzte bi plataformetan.
  2. Definitu osagai irisgarrien geruza propio bat (botoia, eremua, txartela, goiburua), props zuzenak dagoeneko dakartzana, eta debekatu horiek gabeko primitiboak zuzenean erabiltzea.
  3. Probatu benetako gailuan iOSen eta Androiden, VoiceOver eta TalkBack erabiliz; mapaketak desberdinak dira, eta akats bat plataforma bakarrean ager daiteke.
  4. Ez desaktibatu letra-eskalatze orokorra; egokitu diseinua.
  5. Auditatu hirugarrenen liburutegiak (karruselak, data-hautatzaileak, grafikoak, modalak) hartu aurretik: zuzendu ezin diren akats gehienen jatorria dira.
  6. Automatizatu ahal dena: irisgarritasuneko lint arauak, etiketak eta funtzioak badaudela egiaztatzen duten probak, eta Xcode/Androiden auditoreak pipeline-an (ikastaro honetako «Irisgarritasuna garapen-fluxuan» ikasgaian eta «Aplikazio mugikorren ebaluazioa» ikastaroan ikusiko duzu).

Ohiko akatsa

Aplikazio hibrido bat irisgarritzat jotzea «webak axe gainditzen duelako». axe-k ez ditu ikusten etiketarik gabeko jatorrizko fitxa-barra, textZoom % 100ean finkatuta duen WebView-a, ezta pantaila aldatzean iragarpenik eza ere. Aplikazio hibrido baten auditoriak web-metodologia (WebView-aren barruan) eta jatorrizkoa (inguratzen duen guztia) konbinatzen ditu.

Adibidea

React Native-ko merkataritza elektronikoko aplikazio batek aurrerapen automatikoa eta etiketarik gabeko geziak zituen karrusel-liburutegi bat erabiltzen zuen. Osagai propio batekin ordezkatu zen: accessibilityRole="adjustable", «6tik 2. produktua» accessibilityValue-rekin, hurrengora/aurrekora mapatutako «gehitu/gutxitu» ekintzak, isScreenReaderEnabled edo isReduceMotionEnabled direnean desaktibatutako aurrerapen automatikoa eta pausa-botoi ikusgarri bat (2.2.2). Osagai berak funtzionatu zuen iOSen eta Androiden, kode espezifikorik gabe.

Laburpena

  • Plataforma anitzeko teknologia guztiek UIAccessibility eta AccessibilityNodeInfo elikatzen amaitzen dute; galdera beti da zer izen, funtzio, egoera eta ekintza iristen zaizkion jatorrizko zerbitzuari.
  • React Native: accessible, accessibilityLabel/Role/State/Value/Hint/Actions, live regions eta announceForAccessibility; ez desaktibatu allowFontScaling.
  • Flutter: widget nagusia Semantics da (label, hint, button, header, liveRegion, custom actions), MergeSemantics/ExcludeSemantics, SemanticsService.announce eta semantika-araztailea.
  • WebView: weberako WCAG osorik, gehi sistemaren testu-eskalatzea eta jatorrizko zatiarekiko koherentzia.
  • Osagai irisgarrien geruza propioa, hirugarrenen liburutegien auditoria eta benetako gailuko probak bi plataformetan.

Baliagarria izan zaizu ikasgai hau?

Sortu zure kontua, 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 €)