Document UserActivation API

[Elchi3]

Description

This pull request documents the recent addition of the UserActivation API to the HTML specification. It is specified at https://html.spec.whatwg.org/multipage/interaction.html#the-useractivation-interface and defines 4 new features that need MDN pages:

• The entry point to UserActivation: navigator.userActivation.
• A new UserActivation object
• Two properties on UserActivation: isActive and hasBeenActive.

The API allows you to programmatically read the current window's user activation state.

Motivation

I've recently documented user activation here: https://developer.mozilla.org/en-US/docs/Web/Security/User_activation (per an OWD project proposal, see openwebdocs/project#73).

Additional motivation comes from this being a recent HTML standard addition at whatwg/html#8254 and implementation in Chromiums (and soon WebKittens).

Additional details

I'm not really happy with the example sections. Wasn't sure what to demo exactly. Happy to hear ideas.

Related issues and pull requests

The compat data has been merged already mdn/browser-compat-data#17887
(still being implemented in WebKit, will update when I see a version)

[github-actions]

Preview URLs (8 pages)

• /en-US/docs/Glossary/Sticky_activation
• /en-US/docs/Glossary/Transient_activation
• /en-US/docs/Web/API/Navigator/userActivation
• /en-US/docs/Web/API/Navigator
• /en-US/docs/Web/API/UserActivation/hasBeenActive
• /en-US/docs/Web/API/UserActivation/isActive
• /en-US/docs/Web/API/UserActivation
• /en-US/docs/Web/Security/User_activation

Flaws (8)

Note! 3 documents with no flaws that don't need to be listed. 🎉

URL: /en-US/docs/Web/API/UserActivation
Title: UserActivation
Flaw count: 1

• bad_bcd_queries:
  • No BCD data for query: api.UserActivation

---

URL: /en-US/docs/Web/API/UserActivation/hasBeenActive
Title: UserActivation.hasBeenActive
Flaw count: 1

• bad_bcd_queries:
  • No BCD data for query: api.UserActivation.hasBeenActive

---

URL: /en-US/docs/Web/API/UserActivation/isActive
Title: UserActivation.isActive
Flaw count: 1

• bad_bcd_queries:
  • No BCD data for query: api.UserActivation.isActive

---

URL: /en-US/docs/Web/API/Navigator
Title: Navigator
Flaw count: 4

• macros:
  • /en-US/docs/Web/API/Navigator/securitypolicy does not exist
  • /en-US/docs/Web/API/Navigator/standalone does not exist
• bad_bcd_links:
  • no explanation!
  • no explanation!

---

URL: /en-US/docs/Web/API/Navigator/userActivation
Title: Navigator.userActivation
Flaw count: 1

• bad_bcd_queries:
  • No BCD data for query: api.Navigator.userActivation

(this comment was updated 2022-10-05 06:43:28.348164)