w3c / w3c/webdriver

Setting orientation to secondary view angles

Open
#352 2 comments 1 reaction 0 assignees View on GitHub

Nobody has claimed this yet.

enhancement
Dominant language
HTML
Stars
718
Forks
228
PR merge metrics
No merged PRs in 30d

Description

https://www.w3.org/Bugs/Public/show_bug.cgi?id=23949

Andreas Tolfsen:

WebDriver currently supports setting the screen orientation to either
portrait or landscape mode on devices that support this configuration.
Many devices support further rotation by 90° so that the top of the
device aligns with the bottom border of the viewport.

In Android this is refered to as secondary orientations. My
suggestion is to use *-primary and *-secondary as optional additions
to specify the type of orientation. This would recognize:

PORTRAIT
LANDSCAPE
PORTRAIT-PRIMARY
LANDSCAPE-PRIMARY
PORTRAIT-SECONDARY
LANDSCAPE-SECONDARY

The PORTRAIT and LANDSCAPE orientations would default to
PORTRAIT-PRIMARY and LANDSCAPE-PRIMARY.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Read the linked W3C bug and the quoted proposal first. Trace how WebDriver currently represents portrait and landscape orientation, then determine the specification changes needed to recognize primary and secondary variants while preserving the existing defaults. Done means the six listed orientations and their default behavior are specified consistently.

Written by the indexing model from the issue text.

Assessment

Tech stack
android
Domain
mobile-dev
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.