diff --git a/index.html b/index.html index b3ebee7da..703395a6f 100644 --- a/index.html +++ b/index.html @@ -413,16 +413,58 @@

Prior to presenting an automated install prompt, a user agent - MUST run the steps to notify that an install prompt is + MAY run the steps to notify that an install prompt is available, to give the site the opportunity to prevent the default action (which is to install the application). Alternatively, the user agent MAY run the steps to notify that an install prompt is available at any time, giving the site the opportunity to show a site-triggered install prompt without automatically showing - the prompt. + the prompt. And, the user agent MAY present an install prompt + at any time, without giving the site an opportunity to prevent it (in + this case, it is RECOMMENDED that the automated prompt be minimally + intrusive, since the site will have no control over when it shows).

+
+

+ The above gives user agents a number of alternatives for + controlling the prompting behaviour: +

+
    +
  1. Don't ever show an automated prompt; dispatch the + BeforeInstallPromptEvent, requiring the site to opt in to + showing a prompt. +
  2. +
  3. Show an automated prompt, and do not implement + BeforeInstallPromptEvent. The prompt is considered part of + the user agent's user interface, not under the control of the + developer (no different to any other affordance offered by a user + agent). +
  4. +
  5. Show an automated prompt, and independently, dispatch the + BeforeInstallPromptEvent (perhaps at different times or + under different circumstances). This is just a combination of the + previous two options. The automated prompt might look quite + different to the site-triggered prompt (e.g., being smaller or more + subtle). In this approach, using preventDefault on + the BeforeInstallPromptEvent would have no effect, since it + is independent of the automated install prompt. +
  6. +
  7. Dispatch the BeforeInstallPromptEvent, and if it is not + cancelled, show an automated prompt. In this approach, using + preventDefault + would stop the automatic prompt from appearing. User agents that + adopt this approach would need to show a second prompt if the + event's prompt() + method is called (otherwise, the site might show an "Install" + button that does nothing when clicked). +
  8. +
+

- In either case, when a user agent presents an install prompt, the end-user's choice is represented either "accepted" or "dismissed". These values are represented in the API of @@ -454,8 +496,7 @@

browsing context.
  • If mayShowPrompt is true, then the user agent MAY, - in parallel, request to present an install prompt - with event. + in parallel, present an install prompt.