Skip to content

Commit

Permalink
Added algorithm note, addressed example comment
Browse files Browse the repository at this point in the history
  • Loading branch information
dmurph committed Oct 29, 2020
1 parent a55c05d commit 6290db1
Showing 1 changed file with 18 additions and 5 deletions.
23 changes: 18 additions & 5 deletions index.html
Original file line number Diff line number Diff line change
Expand Up @@ -223,8 +223,8 @@ <h3>
"sizes": "128x128"
}],
"start_url": "/index.html",
"display_override": ["minimal-ui", "standalone"],
"display": "minimal-ui",
"display_override": ["minimal-ui"],
"display": "standalone",
"theme_color": "yellow",
"background_color": "red"
}
Expand Down Expand Up @@ -639,7 +639,7 @@ <h2>
</li>
<li>
[=list/For each=] |fallback_mode:DisplayModeType| of the
fallback_chain of |manifest|.{{WebAppManifest/display}}:
fallback chain of |manifest|.{{WebAppManifest/display}}:
<ol>
<li>
If the user agent supports the |fallback_mode|, then
Expand All @@ -651,8 +651,15 @@ <h2>
<p class="note">
The above loop is guaranteed to return a value before it terminates,
due to the fact that {{browser}} is in every mode's fallback chain,
and the requirement that all user agents support the {{browser}} [=display
mode=].
and the requirement that all user agents support the {{browser}}
[=display mode=].
</p>
<p class="note">
In the future, new values added to {{DisplayModeType}} will not be
added to the fallback chain, and the algorithm should treat these
values, when used with the {{WebAppManifest/display}} field, as
{{browser}}. New values will only be compatible with
{{WebAppManifest/display_override}}.
</p>
</p>
<div class="example">
Expand Down Expand Up @@ -1453,6 +1460,12 @@ <h3>
display modes specified here, then it falls back to considering the
{{display}} field. See [=display modes=] for the algorithm steps.
</p>
<p class="note">
This member is intended to be only used for advanced cases, where
the developer wants explicit control over the fallback order of their
display modes. Otherwise, the {{display}} should be sufficient for
most use cases.
</p>
</section>
<section>
<h3>
Expand Down

0 comments on commit 6290db1

Please sign in to comment.