Axe DevTools Mobile 8 september 2026 Releaseopmerkingen

Deze status is verouderd en zal in oktober 2026 worden verwijderd. Op dat moment zullen genegeerde regels worden overgeslagen in de iteratie en zullen ze geen resultaat meer teruggeven.

Merk op dat AxeDevTools itself niet verouderd is. De volgende methoden zullen vervangen of volledig verwijderd worden in de release van oktober 2026.

• ignoreByViewIdResourceName(viewIdResourceName: String, ruleList: List) (Zal vervangen worden door ignoreRulesOnElementWithId(id: String, vararg rules: AxeRuleName))
• ignoreRules(rulesToIgnore: List)
• resetIgnoredRules()
• tagScansAs(tag: TagSet)
• deleteResult(axeDevToolsResultKey: AxeDevToolsResultKey)
• getResult(axeDevToolsResultKey: AxeDevToolsResultKey)

• getResult()
• postResult()
• deleteResult()
• tag()
• setScanName()
• getUserInfo()
• getResultSync()
• postResultSync()
• deleteResultSync()
• tagSync()
• setScanNameSync()
• getSessionId()
• BASE_FRONTEND_URL
• DB_DEFAULT_URL
• DB_QA_URL
• DB_DEV_URL

Het concept van experimentele regels zal volledig worden verwijderd in de oktoberrelease. Hetzelfde geldt voor tags - ze zullen verdwijnen met de pensionering van het Mobiele Dashboard.

Deze regels waren experimenteel en worden niet gepromoveerd. Ze zijn verwijderd uit onze regeliteratie.

• AxeDevToolsResultKey
• AxeDevToolsResultSummaryResponse
• ConnectionConfig - Dit zal worden vervangen door dbUrl constructor met één argument
• class TagsSet()
• Experimentele regels worden gepromoveerd of verwijderd

De Axe DevTools SDK gebruikt Apple's Vision-framework om tekst van het scherm te lezen voor verschillende toegankelijkheidsregels (bijv. Kleurencontrast, Botsende weergaven, elke regel die afhankelijk is van door Vision gedetecteerde tekst).

Vision retourneert niet altijd dezelfde gedetecteerde tekst tussen uitvoeringen van hetzelfde scherm. Wanneer Vision de tekst op een controle mist, zullen regels die van die tekst afhankelijk zijn niet voor dat element worden uitgevoerd bij die scan. Bevindingen kunnen inconsistent lijken tussen twee scans van hetzelfde scherm - een probleem dat bij de ene scan faalt, kan bij de volgende afwezig zijn.

Wanneer een Vision-gebaseerde regel een mislukking rapporteert, is de mislukking zelf nauwkeurig. De inconsistentie zit in of de regel draait of niet. Om dit probleem te overwinnen, probeer het volgende:

• Voer de scan opnieuw uit. Als een Vision-gebaseerde regel werd overgeslagen voor een controle, pikt een andere scan van hetzelfde scherm deze vaak op.
• Behandel elke mislukking van een Vision-gebaseerde regel als geldig - als Kleurencontrast een controle markeert, is het contrastprobleem echt en moet het worden aangepakt.
• Gebruik voor handmatige verificatie de Deque University-referentie voor het relevante WCAG-succescriterium. (Links zijn te vinden onderaan elke regulenpagina.)

Op iOS 26 en later, als een scherm tekst bevat met een procentteken erin (bijv. een tekstlabel dat "50% Korting" leest), kan de Ondersteunt Dynamische Tekst-regel als Onvolledig worden gerapporteerd in plaats van een succes of mislukking. Deze regel is afhankelijk van een toegankelijkheidsaudit geleverd door Apple, en die audit stopt de testuitvoering wanneer deze procenttekens tegenkomt. Om je tests draaiende te houden, slaat onze regel de controle voor dat scherm over en rapporteert deze als onvolledig voor elk element met een procentteken. Alle andere regels draaien normaal op het scherm, en andere schermen worden niet beïnvloed.

Er is geen actie vereist, aangezien je scan nog steeds voltooit. Om de ondersteuning voor Dynamische Tekst voor deze schermen te controleren, verhoog je de tekstgrootte op je apparaat onder **Instellingen** > **Toegankelijkheid** > **Weergave & Tekstgrootte** > **Grote Tekst** en bevestig je dat de tekst op het scherm correct schaalt. Dit probleem is gemeld aan Apple. (#2985)

De Kleurencontrast-regel gebruikt Apple's Vision-framework (Optical Character Recognition, of OCR) om tekst binnen de grenzen van een element te lezen. OCR kan af en toe kleine pictogramachtige glyphen - zoals terug-pijl chevrons (<), opsommingstekens, decoratieve symbolen - verkeerd identificeren als tekst. Wanneer dat gebeurt, voert de Kleurencontrast-regel uit op een element dat geen leesbare tekst bevat, wat een resultaat kan opleveren voor een knop die alleen uit iconen bestaat. Omdat OCR-uitvoer niet deterministisch is over scans heen, kan hetzelfde element in de resultaten voor Kleurencontrast verschijnen bij de ene scan en als "NIET VAN TOEPASSING" worden gemeld bij de volgende. Dit is een bekend kenmerk van OCR, geen bug in de regel.

Om dit probleem te omzeilen, kun je de ignore API's gebruiken om Kleurencontrastresultaten voor de getroffen elementen te onderdrukken.

Flutter map AppBar.title niet naar de native schermtitel-eigenschap - UIViewController.title, waardoor de Schermtitel-regel faalt op alle Flutter-schermen, ongeacht of er een beschrijvende titel aanwezig is.

Dit is een bekende beperking van het Flutter-platform die wordt gevolgd in flutter/flutter#185894.

Bij het uitvoeren van toegankelijkheidscontroles op kleinere schermformaten of met kleinere lettergroottes, kan de kleurcontrastregel valse positieven rapporteren voor verloopachtergronden. In dergelijke gevallen kan het zijn dat de voorgrondkleur niet kan worden bepaald en worden in plaats daarvan achtergrondkleuren met elkaar vergeleken, wat resulteert in een foutmelding.

Om dit probleem te omzeilen, probeer toegankelijkheidscontroles uit te voeren op grotere apparaten. Als alternatief kunt u ervoor kiezen om de regel in uw tests te negeren en de kleurcontrasten handmatig voor deze weergaven te controleren.

De toegankelijkheids-API's van Apple kunnen webinhoud binnen WKWebView onterecht rapporteren als „isVisible“, zelfs wanneer de webweergave wordt bedekt door native overlays (zoals modale weergaven, waarschuwingen of andere native UI-elementen). Dit gebeurt omdat het toegankelijkheidssysteem controleert of de WKWebView-container zelf zichtbaar is, in plaats van of de webinhoud daadwerkelijk onbelemmerd en waarneembaar is voor de gebruiker.

iOS 26 bevat een toegankelijkheidsfout waarbij standaardknoppen voor stappenregelaars niet „gedimd“ worden aangekondigd door assistieve technologie om aan te geven dat ze niet ingeschakeld zijn. Als gevolg hiervan zien de iOS-regels deze knoppen ook als ingeschakeld, zelfs als ze dat niet zijn. Er is een bugrapport ingediend bij Apple, maar totdat dit is opgelost, kunnen de volgende regels resultaten rapporteren op uitgeschakelde knoppen voor stappenregelaars: AssociatedText, InaccessibleAction, en ColorContrast.

Totdat Apple deze bug heeft opgelost, is de oplossing om [de regels te negeren](ios-ignore-rule). De standaardknoppen voor stappenregelaars hebben de identificatoren „Decrement“ en „Increment“ en kunnen indien nodig worden genegeerd op basis van de identificator.

Our Color Contrast rule depends on Machine Learning to detect text, which ensures that the text being scanned is visible to users of your application. In cases where the text contained in a view is the same color as the background, our Machine Learning algorithm is unable to detect if any text is present, so the Color Contrast rule does not run on this view.

Op sommige schermen kunnen valse positieven worden gerapporteerd met LabelInName en LabelAtFront vanwege een onjuiste associatedText-eigenschap die wordt gevonden (#1622)

Bij het verbeteren van onze regels hebben we ontdekt dat in XCTest geneste controles niet terugkeren in de toegankelijkheidsboom. Er is een bug ingediend bij Apple. (#1110)

In UIKit-apps is een afbeelding zonder een `accessibilityLabel` niet focusbaar met assistive technologie standaard.
De eigenschappen die we gebruiken om focusbaarheid van Apple te controleren, kunnen onnauwkeurig zijn wanneer een `accessibilityIdentifier` is ingesteld op de afbeelding. Vanwege dit onverwachte gedrag zullen resultaten voor problemen met de ImageView Name in UIKit-apps worden gerapporteerd als 'Nodig nagekeken'. Er is een bugrapport ingediend bij Apple. (#1633)

We werken actief aan oplossingen voor de volgende valse positieven en zullen deze lijst bijwerken zodra er oplossingen worden vrijgegeven.

In Scroll View
Tekst binnen elementen met banner-gedrag, vaste kop-/voetteksten, zwevende actieknoppen en aangepaste tabweergaven kan worden gemarkeerd met een "Nodig nagekeken" of "Niet geslaagd"-bericht. Om deze elementen beschikbaar te maken voor degenen die grotere tekst nodig hebben, gebruik UILargeContentViewer. (#622, #2077)

v2.11.0 Image View Name & Active Control Name
Als een UIImageView een accessibilityIdentifier heeft ingesteld maar niet focusbaar is door VoiceOver, en het heeft focusbare controles genest binnenin, kan Active Control Name een valse positieve rapportage geven op de UIImageView. Door de accessibilityIdentifier te verwijderen wordt het probleem opgelost. Er is een bug ingediend bij Apple. (#1633)

Label In Name and Label At Front
Deze twee regels zoeken naar het zichtbare label van een controle onder nabijgelegen elementen om de status van de regel te helpen bepalen. In sommige weergavehiërarchieën kan de onjuiste nabijgelegen tekst worden gedetecteerd waardoor deze regels falen. (#1622)

De Label at Front-regel controleert of het zichtbare label van een element aan het begin van de aangekondigde tekst komt. Een regelmislukking kan optreden wanneer de zichtbare tekst van een interactief element een afkorting bevat (bijv. „GB“, „km“) of een bedekte / afgekorte identificator, en de toegankelijkheidsaankondiging bestaat uit de vertegenwoordigde woorden (bijv. „gigabytes“, „kilometers“), hoewel dit het aanbevolen patroon is om afgekorte of afgekorte inhoud schermlezer-vriendelijk te maken.

Als het eerste deel van het zichtbare label van een interactief element overeenkomt met het begin van de schermlezer-aankondiging en alleen het afgekorte / bedekte gedeelte verschilt, kan het gemarkeerde resultaat veilig worden genegeerd. Verifieer met een schermlezer dat de volledige aankondiging wordt voorgelezen zoals bedoeld.

Bij gebruik van decoratieve tekst in weergaven zoals „Contacticonen“, is het mogelijk om een toegankelijkheidsprobleem te introduceren. Als u een tekstweergave gebruikt om letters weer te geven in plaats van afbeeldingen te genereren met de gewenste letters als vectoren, en u verklaart die tekstweergave vervolgens als niet belangrijk voor toegankelijkheid, zullen wij niet in staat zijn om betrouwbaar te beoordelen of u een toegankelijkheidsschending heeft geïntroduceerd.

Als u focusbare tekst aanpast om twee of minder tekens te negeren, kunt u onbedoeld veel een-woord knoppen in verschillende talen negeren (bijv. „OK“, „Nee“, „Sí“). Om deze problemen te vermijden, dient u de gewenste letters uit het woord te halen dat u wilt representeren in het pictogram en de letters als onderdeel van de afbeelding te genereren in plaats van als afzonderlijke tekstweergaven. `FocusableText` zal dan niet op deze weergaven worden uitgevoerd.

Flutter map AppBar.title niet naar de native schermtitel-eigenschap - Activity.setTitle, waardoor de Schermtitel-regel faalt op alle Flutter-schermen, ongeacht of er een beschrijvende titel aanwezig is.

Dit is een bekende beperking van het Flutter-platform die wordt gevolgd in flutter/flutter#185894.

In sommige gevallen vertrouwt assistieve technologie op AccessibilityEvent beschrijvingen van het Android-systeem om informatie aan de gebruiker aan te kondigen wanneer er geen andere aankondiging beschikbaar is. Aangezien AccessibilityEvents worden geactiveerd door gebruikersacties, kunnen we de correcte beschrijving niet verkrijgen als deze informatie niet wordt verstrekt.

Om dit probleem te vermijden, zorg ervoor dat alle relevante weergaven als belangrijk voor toegankelijkheid worden gemarkeerd. Dit zal Talkback in staat stellen om de informatie van de weergave te benaderen, die onze tool vervolgens kan detecteren.

Onze kleurcontrastregel is afhankelijk van machine learning om tekst te detecteren, wat ervoor zorgt dat de gescande tekst zichtbaar is voor gebruikers van uw applicatie. In gevallen waarin de tekst in een weergave dezelfde kleur heeft als de achtergrond, is ons machine learning-algoritme niet in staat om te detecteren of er tekst aanwezig is, zodat de kleurcontrastregel niet wordt uitgevoerd op deze weergave.

Apps geschreven met XML die gebruikmaken van de hinttekstfunctie kunnen valse positieven zien met de EditTextName regel. Hinttekst werd pas geïntroduceerd in Android 8 (SDK 26). Door dit element in uw XML-app te gebruiken, wordt de hinttekst toegewezen aan de waarde van het tekstinvoerveld. Meer recente versies van Android zijn beter uitgerust om deze ervaring toegankelijk te maken.

Om dit probleem te overkomen, is onze eerste aanbeveling om uw tests op nieuwere versies van Android uit te voeren. Als het echter belangrijk is dat de app toegankelijk is op oudere Android-versies, kunt u overwegen om het gebruik van de hintText functie te vermijden, omdat deze niet officieel wordt ondersteund.

U kunt resultaten zien voor weergaven die verborgen zijn achter andere weergaven op het scherm. Deze verborgen weergaven zijn niet toegankelijk voor assistieve technologie, maar Axe DevTools Mobile rapporteert ze nog steeds als problemen.

We werken aan een oplossing voor dit complexe probleem. In de tussentijd, als TalkBack deze weergaven niet kan bereiken, kunt u de overeenkomstige problemen negeren. Ze vereisen geen oplossing om toegankelijkheid te garanderen.

ML Kit tekstherkenning is vereist in veel van de Axe DevTools Mobile regels om de nauwkeurigheid van de resultaten te waarborgen. De ML Kit-bibliotheek zou automatisch moeten worden geïmporteerd wanneer je Axe DevTools Mobile gebruikt in je geautomatiseerde Espresso- of UIAutomator-tests. In sommige gevallen gebeurt de automatische import echter niet, en zie je de volgende fout in de logcat:

De Touchdoelafstand-regel wordt momenteel niet uitgevoerd op slider-componenten die in Jetpack Compose zijn geschreven. Er kan op dit moment geen actie worden ondernomen. Er komt echter binnenkort een oplossing!

Op Android API 30 heeft een van de locatiepogingen om resultaten lokaal op te slaan een machtigingsfout. Het resultaat wordt nog steeds als een JSON-bestand opgeslagen ondanks dat deze fout wordt weergegeven. De fout kan worden onderdrukt door de code in het volgende blok uit te schakelen:

In sommige hybride en cross-platform apps kunnen we onverwachte resultaten teruggeven wanneer items in een scrollweergave gedeeltelijk van het scherm zijn. Om een element te testen op toegankelijkheid, zorg ervoor dat het volledig op het scherm staat voordat je de scan uitvoert.

Met API 31 (Android 12) is de mogelijkheid geïntroduceerd om niet-systeemoverlays te verbergen. Om de Axe Analyzer-app te gebruiken, zorg ervoor dat deze instelling niet is ingeschakeld. Als je ervoor hebt gekozen om deze functie te gebruiken vanwege de beveiligingsverbeteringen, raden we aan deze uitgeschakeld te laten voor interne testversies waar je veilig testgegevens kunt gebruiken en zo de beveiligingsproblemen kunt elimineren. Note: this setting does not affect Google's accessibility scanner app as it's considered a system overlay.

Om de Axe Accessibility Analyzer-app te gebruiken, update elke aanroep naar de methode setHideOverlayWindows(true) naar setHideOverlayWindows(false) op de getroffen activiteitvensters.

Om de volledige functionaliteit van Axe DevTools voor Mobiel te ontgrendelen, moet je ervoor zorgen dat schermafbeeldingen zijn ingeschakeld. We raden aan schermafbeeldingen in te schakelen op een debug- of testversie van je app die gebruikmaakt van mock data om beveiligingsproblemen te voorkomen. Bekijk onze gids voor het inschakelen van schermafbeeldingen in Android-apps.

Als je je build minimaliseert, krijg je een crash met een foutlog dat meldt dat een adapter niet kon worden gevonden bij het inloggen op de Axe DevTools-bibliotheek. Schakel minify uit voor je debug-builds met geïmplementeerde Axe DevTools. (#729)

Een build met geactiveerde r8 kan proberen de axeDevTools-bibliotheek te minimaliseren, resulterend in een fout zoals:

De Compose API's zijn verouderd, gebruik a.u.b. de layoutonafhankelijke API's om updates te blijven ontvangen. Als je doorgaat met het gebruiken van de Compose API's en je tegen een fout aanloopt in de trant van `Precies '1' node verwacht maar '2' nodes gevonden die voldoen aan: (isRoot)` of `Geen weergave geïnitialiseerd, heb je AxeDevToolsCompose.setComposeTestRule() aangeroepen?`, verwijs dan naar Compose setTestTag API.

Vanwege beperkingen van de MAUI-apparchitectuur in het Android-ecosysteem, zal de Bewerken Tekst Naam-regel op het dashboard als Moet Beoordeeld Worden verschijnen wanneer een fout wordt vermoed voor SDK-versie 5.5.0 en hoger. Bevestig in dit geval het correcte gedrag handmatig.

Wanneer je aangepaste dialogen of modalen implementeert die de native controls niet uitbreiden, kun je resultaten krijgen voor weergaven achter het modaal. In dit geval raden we aan onze tool niet te gebruiken tegen deze aangepaste modalen of dialogen, maar in plaats daarvan deze handmatig te controleren om ervoor te zorgen dat ze zich gedragen met ondersteunende technologie zoals gewenst.

Als de schermafbeelding ontbreekt op de scandetailpagina, kan het zijn dat je app voorkomt dat er schermafbeeldingen worden gemaakt. Dit is vaak om veiligheidsredenen in je productie-applicatie. Overweeg om deze eis voor je testversie te verwijderen om volledige functionaliteit in het Axe DevTools Mobile Dashboard mogelijk te maken.

• Android - FLAG_SECURE

Sommige Android-scannamen die standaard de schermtitel zijn, verschijnen als de volledige klassennaam inclusief de bundelidentifier. In een toekomstige release wordt dit opgelost zodat de schermtitel in een leesbaardere naam wordt opgemaakt. Als tijdelijke oplossing kun je de scannaam instellen vanaf het dashboard of vanuit de frameworks. (#1643)