Schermoriëntatie

Waar We Op Controleren

Je app mag de voorkeursweergaveoriëntatie van de gebruiker niet beperken. Als een gebruiker bijvoorbeeld zijn apparaat op de landschapmodus heeft ingesteld, moet de app meedraaien en zich aanpassen - niet vast blijven staan in de portretmodus.

Mislukt Voorbeeld ❌

De app blijft in de portrait mode zelfs wanneer het apparaat naar landschapsmodus wordt gedraaid

Gebruikers met apparaten die in een vaste landschapsoriëntatie zijn gemonteerd, kunnen de app niet gebruiken

Geslaagd Voorbeeld ✅

De app past zich aan rotates to landscape mode wanneer het apparaat wordt gedraaid

Gebruikers met apparaten die in elke oriëntatie zijn gemonteerd, kunnen de app volledig gebruiken

In Één Oogopslag

• Deze regel heeft een ernstige impact voor gebruikers
• Vergrendel je app niet op één oriëntatie
• Verwijder eventuele hard-coded oriëntatiebeperkingen in je manifest of activiteitencode

Impact op Gebruikers

Sommige mensen hebben een telefoon of tablet in een vaste oriëntatie gemonteerd. Als de app deze oriëntatie niet ondersteunt, wordt deze onbruikbaar voor de gebruiker.

Bevestig Schermoriëntatieprobleem

1. Draai het apparaat 90 graden, van portretmodus naar landschapsmodus
2. Een van de volgende situaties zal zich voordoen:
   • Ontoegankelijk: Het scherm blijft in portretmodus en draait niet naar landschapsmodus.
   • Toegankelijk: Het scherm draait van portretmodus naar landschapsmodus.

Los Problemen Op

Native Android

Laat je applicatie elke oriëntatie ondersteunen door hard-coded oriëntatiebeperkingen te verwijderen. Gemeenschappelijke plaatsen om te controleren:

1. In AndroidManifest.xml, verwijder of werk het screenOrientation-attribuut bij op elk <activity>-element:

<!-- Remove or change this -->
android:screenOrientation="portrait"

2. In de activiteitencode, verwijder alle aanroepen naar setRequestedOrientation:

// Remove this
this.setRequestedOrientation(ActivityInfo.SCREEN_ORIENTATION_PORTRAIT);

Flutter

Beperk de app niet tot één oriëntatie met behulp van SystemChrome.setPreferredOrientations.

// Failing — locked to portrait only
SystemChrome.setPreferredOrientations([
  DeviceOrientation.portraitUp,                                                   
  DeviceOrientation.portraitDown,
]);                                                                               
                                                                                
// Passing — all orientations allowed
SystemChrome.setPreferredOrientations(DeviceOrientation.values);

Kan Ik Deze Regel Negeren?

Schermoriëntatie heeft een Ernstige impact voor gebruikers. We raden aan om dit probleem in bijna alle gevallen aan te pakken. Als je app specifiek is ontworpen voor een apparaat dat fysiek beperkt is tot één oriëntatie (zoals een point-of-sale terminal), kan het negeren van deze regel gepast zijn. Leer meer over regels negeren.

Hulpmiddelen

• Web Content Accessibility Guidelines (WCAG) 2.1, W3C-aanbeveling
  • Succescriterium 1.3.4 - Oriëntatie
• WCAG 2.1 Begrijpende Documenten
  • Begrijpen van 1.3.4 AA - Oriëntatie