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: +
+preventDefault
on
+ the BeforeInstallPromptEvent would have no effect, since it
+ is independent of the automated install prompt.
+ 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).
+ - 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 @@