Skip to content

Commit

Permalink
Tweak the stack wording a bit to make it more clear we are talking ab…
Browse files Browse the repository at this point in the history
…out ordered sets here.
  • Loading branch information
annevk committed Nov 7, 2013
1 parent eba5ba8 commit 5664c87
Show file tree
Hide file tree
Showing 2 changed files with 27 additions and 29 deletions.
31 changes: 15 additions & 16 deletions Overview.html
Expand Up @@ -10,8 +10,8 @@

<p><a class="logo" href="//www.whatwg.org/"><img alt="WHATWG" height="100" src="//resources.whatwg.org/logo-fullscreen.svg" width="100"></a></p>
<h1 class="p-name">Fullscreen API</h1>
<h2 class="no-num no-toc" id="living-standard-—-last-updated-12-july-2013">Living Standard — Last Updated
<time class="dt-published" datetime="20130712">12 July 2013</time>
<h2 class="no-num no-toc" id="living-standard-—-last-updated-7-november-2013">Living Standard — Last Updated
<time class="dt-published" datetime="20131107">7 November 2013</time>
</h2>

<dl>
Expand Down Expand Up @@ -45,7 +45,7 @@ <h2 class="no-num no-toc" id="living-standard-—-last-updated-12-july-2013">Liv
<p class="copyright"><a href="http://creativecommons.org/publicdomain/zero/1.0/" rel="license"><img alt="CC0" src="http://i.creativecommons.org/p/zero/1.0/80x15.png"></a>
To the extent possible under law, the editors have waived all copyright and
related or neighboring rights to this work. In addition, as of
12 July 2013, the editors have made this specification available
7 November 2013, the editors have made this specification available
under the
<a href="http://www.openwebfoundation.org/legal/the-owf-1-0-agreements/owfa-1-0" rel="license">Open Web Foundation Agreement Version 1.0</a>,
which is available at
Expand Down Expand Up @@ -128,7 +128,7 @@ <h2 id="model"><span class="secno">3 </span>Model</h2>
have an associated <dfn id="fullscreen-enabled-flag">fullscreen enabled flag</dfn> and
<dfn id="fullscreen-element-stack">fullscreen element stack</dfn>. Unless otherwise stated the
<a href="#fullscreen-enabled-flag">fullscreen enabled flag</a> is unset and the
<a href="#fullscreen-element-stack">fullscreen element stack</a> is empty.
<a href="#fullscreen-element-stack">fullscreen element stack</a> is an initially empty ordered set.

<p class="note">HTML defines the exact conditions under which the
<a href="#fullscreen-enabled-flag">fullscreen enabled flag</a> is set. A
Expand All @@ -147,10 +147,10 @@ <h2 id="model"><span class="secno">3 </span>Model</h2>

<p>To <dfn id="concept-fullscreen-add" title="concept-fullscreen-add">add</dfn> an
<var title="">element</var> on a <var title="">document</var>'s
<a href="#fullscreen-element-stack">fullscreen element stack</a>, add it on top of
<a href="#fullscreen-element-stack">fullscreen element stack</a>, add, or move if already present, it on top of
<var title="">document</var>'s
<a class="external" data-anolis-spec="html" href="http://www.whatwg.org/specs/web-apps/current-work/multipage/browsers.html#browsing-context">browsing context</a>'s
<a href="#top-layer">top layer</a>, and then add it on top of
<a href="#top-layer">top layer</a>, and then add, or move if already present, it on top of
<var title="">document</var>'s <a href="#fullscreen-element-stack">fullscreen element stack</a>.

<p>To <dfn id="concept-fullscreen-remove" title="concept-fullscreen-remove">remove</dfn> an
Expand Down Expand Up @@ -470,14 +470,14 @@ <h3 id="new-stacking-layer"><span class="secno">6.1 </span>New stacking layer</h
<p class="note">The terminology used in this and following subsection attempts
to match CSS 2.1 Appendix E.

<p>The <a href="#top-layer">top layer</a> consists of a stack of elements, rendered in
the order they have been added to the stack. The last element added to the
stack is rendered closest to the user.
<p>The <a href="#top-layer">top layer</a> consists of an ordered set of elements, rendered in the
order they have been added to the set. The last element added is rendered closest to the
user.

<p class="note">The <code title="">z-index</code> property has no effect in the
<a href="#top-layer">top layer</a>.

<p>An element in this stack has the following <dfn id="characteristics">characteristics</dfn>:
<p>An element in a <a href="#top-layer">top layer</a> has the following <dfn id="characteristics">characteristics</dfn>:

<ul>
<li><p>It generates a new stacking context.
Expand Down Expand Up @@ -511,17 +511,16 @@ <h3 id="new-stacking-layer"><span class="secno">6.1 </span>New stacking layer</h

<h3 id="::backdrop-pseudo-element"><span class="secno">6.2 </span><code title="">::backdrop</code> pseudo-element</h3>

<p>Each element in the <a href="#top-layer">top layer</a>'s stack has a
<p>Each element in a <a href="#top-layer">top layer</a> has a
<dfn id="css-pe-backdrop" title="css-pe-backdrop"><code>::backdrop</code></dfn> pseudo-element.
This pseudo-element is a box rendered immediately below the element (and
above the element below the element in the stack, if any), within the same
above the element before the element in the set, if any), within the same
<a href="#top-layer">top layer</a>. This pseudo-element box has the same <a href="#characteristics">characteristics</a>
as any element box in the <a href="#top-layer">top layer</a>.

<p class="note">The <a href="#css-pe-backdrop"><code title="css-pe-backdrop">::backdrop</code></a>
pseudo-element can be used to create a backdrop that hides the underlying
document for an element in the <a href="#top-layer">top layer</a>'s stack (such as an
element that is displayed fullscreen).
<p class="note">The <a href="#css-pe-backdrop"><code title="css-pe-backdrop">::backdrop</code></a> pseudo-element can be used
to create a backdrop that hides the underlying document for an element in a
<a href="#top-layer">top layer</a> (such as an element that is displayed fullscreen).

<p>It does not inherit from any element and is not
inherited from. No restrictions are made on what properties apply to this
Expand Down
25 changes: 12 additions & 13 deletions Overview.src.html
Expand Up @@ -114,7 +114,7 @@ <h2>Model</h2>
have an associated <dfn>fullscreen enabled flag</dfn> and
<dfn>fullscreen element stack</dfn>. Unless otherwise stated the
<span>fullscreen enabled flag</span> is unset and the
<span>fullscreen element stack</span> is empty.
<span>fullscreen element stack</span> is an initially empty ordered set.

<p class=note>HTML defines the exact conditions under which the
<span>fullscreen enabled flag</span> is set. A
Expand All @@ -133,10 +133,10 @@ <h2>Model</h2>

<p>To <dfn title=concept-fullscreen-add>add</dfn> an
<var title>element</var> on a <var title>document</var>'s
<span>fullscreen element stack</span>, add it on top of
<span>fullscreen element stack</span>, add, or move if already present, it on top of
<var title>document</var>'s
<span data-anolis-spec=html>browsing context</span>'s
<span>top layer</span>, and then add it on top of
<span>top layer</span>, and then add, or move if already present, it on top of
<var title>document</var>'s <span>fullscreen element stack</span>.

<p>To <dfn title=concept-fullscreen-remove>remove</dfn> an
Expand Down Expand Up @@ -456,14 +456,14 @@ <h3>New stacking layer</h3>
<p class=note>The terminology used in this and following subsection attempts
to match CSS 2.1 Appendix E.

<p>The <span>top layer</span> consists of a stack of elements, rendered in
the order they have been added to the stack. The last element added to the
stack is rendered closest to the user.
<p>The <span>top layer</span> consists of an ordered set of elements, rendered in the
order they have been added to the set. The last element added is rendered closest to the
user.

<p class=note>The <code title>z-index</code> property has no effect in the
<span>top layer</span>.

<p>An element in this stack has the following <dfn>characteristics</dfn>:
<p>An element in a <span>top layer</span> has the following <dfn>characteristics</dfn>:

<ul>
<li><p>It generates a new stacking context.
Expand Down Expand Up @@ -497,17 +497,16 @@ <h3>New stacking layer</h3>

<h3><code title>::backdrop</code> pseudo-element</h3>

<p>Each element in the <span>top layer</span>'s stack has a
<p>Each element in a <span>top layer</span> has a
<dfn title=css-pe-backdrop><code>::backdrop</code></dfn> pseudo-element.
This pseudo-element is a box rendered immediately below the element (and
above the element below the element in the stack, if any), within the same
above the element before the element in the set, if any), within the same
<span>top layer</span>. This pseudo-element box has the same <span>characteristics</span>
as any element box in the <span>top layer</span>.

<p class=note>The <code title=css-pe-backdrop>::backdrop</code>
pseudo-element can be used to create a backdrop that hides the underlying
document for an element in the <span>top layer</span>'s stack (such as an
element that is displayed fullscreen).
<p class=note>The <code title=css-pe-backdrop>::backdrop</code> pseudo-element can be used
to create a backdrop that hides the underlying document for an element in a
<span>top layer</span> (such as an element that is displayed fullscreen).

<p>It does not inherit from any element and is not
inherited from. No restrictions are made on what properties apply to this
Expand Down

0 comments on commit 5664c87

Please sign in to comment.