Skip to content

FF151 Element.requestFullScreen() option.keyboardLock docs#43884

Open
hamishwillee wants to merge 5 commits intomdn:mainfrom
hamishwillee:ff151_requestfullscreen_keyboardlock
Open

FF151 Element.requestFullScreen() option.keyboardLock docs#43884
hamishwillee wants to merge 5 commits intomdn:mainfrom
hamishwillee:ff151_requestfullscreen_keyboardlock

Conversation

@hamishwillee
Copy link
Copy Markdown
Collaborator

@hamishwillee hamishwillee commented Apr 21, 2026

FF151 adds support for the options.keyboardlock property to be passed in the options object to Element.requestFullScreen() in https://bugzilla.mozilla.org/show_bug.cgi?id=2032302.
This allows use cases such as games to use the Esc key (say) without exiting full screen mode.

The PR updates the docs for Element.requestFullScreen() with the new option and a new example.

It also fixes up layout issues and restructures the document to current standards - adding things like permissions policy integration and so on.

Note that right now the standard is in flux. This is broadly supprted on both FF and Safari in the same way, but things like what key is pressed to exit keyboard lock, what additional keys are intercepted, and so on, are not specified at all (and not likely to be).

Related docs work can be tracked in #43868

@github-actions github-actions Bot added the Content:WebAPI Web API docs label Apr 21, 2026
@github-actions github-actions Bot added the size/m [PR only] 51-500 LoC changed label Apr 21, 2026
@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Apr 21, 2026

Preview URLs (1 page)

(comment last updated: 2026-04-30 23:05:16)


{{embedlivesample("requesting_fullscreen_mode", , "400", "", "", "", "fullscreen")}}

### Using keyboard lock
Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is new example.

  • Need to know if there is a way to feature check on this option.
  • This just starts it - would be good to know what we could call preventdefault on to show the change.. Asking.

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Note, right now no feature checking as far as I can tell.

@hamishwillee hamishwillee marked this pull request as ready for review April 27, 2026 06:01
@hamishwillee hamishwillee requested a review from a team as a code owner April 27, 2026 06:01
@hamishwillee hamishwillee requested review from pepelsbey and removed request for a team April 27, 2026 06:01
@hamishwillee hamishwillee force-pushed the ff151_requestfullscreen_keyboardlock branch from f98f0d0 to 490d761 Compare April 30, 2026 23:03
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Content:WebAPI Web API docs size/m [PR only] 51-500 LoC changed

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants