Skip to content

Commit

Permalink
Add a non-normative note that the app can be installed from a documen…
Browse files Browse the repository at this point in the history
…t that is outside the scope of that app.

Closes w3c#784.
  • Loading branch information
mgiuca committed Sep 12, 2019
1 parent 95d216f commit 944d443
Showing 1 changed file with 20 additions and 1 deletion.
21 changes: 20 additions & 1 deletion index.html
Original file line number Diff line number Diff line change
Expand Up @@ -318,6 +318,25 @@ <h2 id="installable-web-applications">
Installability signals</a>).
</li>
</ol>
<div class="note" data-link-for="WebAppManifest">
<p>
The {{Document}} might not be <a data-lt=
"within-scope-manifest">within scope</a> of the linked manifest, by
design. For example, a page at <code>https://example.com</code> might
link a manifest with <a>scope</a> <code>"/installable/"</code>,
allowing the top-level page of the site (which itself is not part of
the installable web application) to show installation UI.
</p>
<p>
Implementors should be aware of this possibility. One consequence is
that if, post install, the user agent opens the document URL in an
<a>application context</a>, it would immediately start showing the
"out of scope" warning UI (that is recommended in <a href=
"#navigation-scope">Navigation scope</a>). Hence, implementors might
wish to avoid doing this if the {{Document}} is <a data-lt=
"within-scope-manifest">out of scope</a>.
</p>
</div>
<section>
<h3>
Authority of the manifest's metadata
Expand Down Expand Up @@ -842,7 +861,7 @@ <h4>
</section>
</section>
<section>
<h2>
<h2 id="navigation-scope">
Navigation scope
</h2>
<p data-link-for="WebAppManifest">
Expand Down

0 comments on commit 944d443

Please sign in to comment.