Fri, 31 May 2013 14:29:35 +0200
[cssom-view] Define 'beginning of the document' for navigating to #top. https://www.w3.org/Bugs/Public/show_bug.cgi?id=15588
cssom-view/Overview.html | file | annotate | diff | comparison | revisions | |
cssom-view/Overview.src.html | file | annotate | diff | comparison | revisions |
1.1 --- a/cssom-view/Overview.html Fri May 31 12:48:50 2013 +0200 1.2 +++ b/cssom-view/Overview.html Fri May 31 14:29:35 2013 +0200 1.3 @@ -125,7 +125,9 @@ 1.4 <li><a href="#css-pixels"><span class="secno">3.1 </span>CSS pixels</a></ol></li> 1.5 <li><a href="#common-infrastructure"><span class="secno">4 </span>Common Infrastructure</a> 1.6 <ol class="toc"> 1.7 - <li><a href="#scrolling"><span class="secno">4.1 </span>Scrolling</a></ol></li> 1.8 + <li><a href="#scrolling"><span class="secno">4.1 </span>Scrolling</a> 1.9 + <ol class="toc"> 1.10 + <li><a href="#common-scroll-positions"><span class="secno">4.1.1 </span>Common Scroll Positions</a></ol></ol></li> 1.11 <li><a href="#extensions-to-the-window-interface"><span class="secno">5 </span>Extensions to the <code title="">Window</code> Interface</a> 1.12 <ol class="toc"> 1.13 <li><a href="#the-mediaquerylist-interface"><span class="secno">5.1 </span>The <code title="">MediaQueryList</code> Interface</a></li> 1.14 @@ -261,8 +263,8 @@ 1.15 <dd><p>Righward and upward. 1.16 </dl> 1.17 1.18 -<p>The term <dfn id="scrolling-area">scrolling area</dfn> refers to a box of an element that has the following edges, depending on the element's scrolling box's <a href="#overflow-directions">overflow 1.19 -directions</a>. 1.20 +<p>The term <dfn id="scrolling-area">scrolling area</dfn> refers to a box of a <a href="#viewport">viewport</a> or an element that has the following edges, depending on the 1.21 +<a href="#viewport">viewport</a>'s or element's scrolling box's <a href="#overflow-directions">overflow directions</a>. 1.22 1.23 <dl class="switch"> 1.24 <dt>If the <a href="#overflow-directions">overflow directions</a> are rightward and downward 1.25 @@ -384,6 +386,28 @@ 1.26 <p>When a user agent is to perform an <dfn id="concept-instant-scroll" title="concept-instant-scroll">instant scroll</dfn> of a scrolling box <var title="">box</var> to 1.27 <var title="">position</var>, it must update the scroll position of <var title="">box</var> to <var title="">position</var>. 1.28 1.29 +<h4 id="common-scroll-positions"><span class="secno">4.1.1 </span>Common Scroll Positions</h4> 1.30 + 1.31 +<p>The <dfn id="beginning-of-the-document">beginning of the document</dfn> is the scroll position the <a href="#viewport">viewport</a> would have by aligning the <a href="#scrolling-area">scrolling area</a> in the 1.32 +<a href="#viewport">viewport</a> as follows, depending on the <a href="#viewport">viewport</a>'s <a href="#overflow-directions">overflow directions</a>: 1.33 + 1.34 +<dl class="switch"> 1.35 + <dt>If the <a href="#overflow-directions">overflow directions</a> are rightward and downward 1.36 + <dd><p>Align the top edge of the <a href="#scrolling-area">scrolling area</a> with the top of the <a href="#viewport">viewport</a>. Align the left edge of the <a href="#scrolling-area">scrolling area</a> 1.37 + with the left of the <a href="#viewport">viewport</a>. 1.38 + <dt>If the <a href="#overflow-directions">overflow directions</a> are leftward and downward 1.39 + <dd><p>Align the top edge of the <a href="#scrolling-area">scrolling area</a> with the top of the <a href="#viewport">viewport</a>. Align the right edge of the <a href="#scrolling-area">scrolling area</a> 1.40 + with the right of the <a href="#viewport">viewport</a>. 1.41 + <dt>If the <a href="#overflow-directions">overflow directions</a> are leftward and upward 1.42 + <dd><p>Align the bottom edge of the <a href="#scrolling-area">scrolling area</a> with the bottom of the <a href="#viewport">viewport</a>. Align the right edge of the <a href="#scrolling-area">scrolling 1.43 + area</a> with the right of the <a href="#viewport">viewport</a>. 1.44 + <dt>If the <a href="#overflow-directions">overflow directions</a> are rightward and upward 1.45 + <dd><p>Align the bottom edge of the <a href="#scrolling-area">scrolling area</a> with the bottom of the <a href="#viewport">viewport</a>. Align the left edge of the <a href="#scrolling-area">scrolling 1.46 + area</a> with the left of the <a href="#viewport">viewport</a>. 1.47 +</dl> 1.48 + 1.49 +<p class="note">The <a href="#beginning-of-the-document">beginning of the document</a> concept is used when navigating to the <code title="">#top</code> fragment identifier, as defined in HTML. 1.50 +<a href="#refsHTML">[HTML]</a> 1.51 1.52 <h2 id="extensions-to-the-window-interface"><span class="secno">5 </span>Extensions to the <code title="">Window</code> Interface</h2> 1.53
2.1 --- a/cssom-view/Overview.src.html Fri May 31 12:48:50 2013 +0200 2.2 +++ b/cssom-view/Overview.src.html Fri May 31 14:29:35 2013 +0200 2.3 @@ -231,8 +231,8 @@ 2.4 <dd><p>Righward and upward. 2.5 </dl> 2.6 2.7 -<p>The term <dfn>scrolling area</dfn> refers to a box of an element that has the following edges, depending on the element's scrolling box's <span>overflow 2.8 -directions</span>. 2.9 +<p>The term <dfn>scrolling area</dfn> refers to a box of a <span>viewport</span> or an element that has the following edges, depending on the 2.10 +<span>viewport</span>'s or element's scrolling box's <span>overflow directions</span>. 2.11 2.12 <dl class=switch> 2.13 <dt>If the <span>overflow directions</span> are rightward and downward 2.14 @@ -354,6 +354,28 @@ 2.15 <p>When a user agent is to perform an <dfn title=concept-instant-scroll>instant scroll</dfn> of a scrolling box <var title>box</var> to 2.16 <var title>position</var>, it must update the scroll position of <var title>box</var> to <var title>position</var>. 2.17 2.18 +<h4>Common Scroll Positions</h4> 2.19 + 2.20 +<p>The <dfn>beginning of the document</dfn> is the scroll position the <span>viewport</span> would have by aligning the <span>scrolling area</span> in the 2.21 +<span>viewport</span> as follows, depending on the <span>viewport</span>'s <span>overflow directions</span>: 2.22 + 2.23 +<dl class=switch> 2.24 + <dt>If the <span>overflow directions</span> are rightward and downward 2.25 + <dd><p>Align the top edge of the <span>scrolling area</span> with the top of the <span>viewport</span>. Align the left edge of the <span>scrolling area</span> 2.26 + with the left of the <span>viewport</span>. 2.27 + <dt>If the <span>overflow directions</span> are leftward and downward 2.28 + <dd><p>Align the top edge of the <span>scrolling area</span> with the top of the <span>viewport</span>. Align the right edge of the <span>scrolling area</span> 2.29 + with the right of the <span>viewport</span>. 2.30 + <dt>If the <span>overflow directions</span> are leftward and upward 2.31 + <dd><p>Align the bottom edge of the <span>scrolling area</span> with the bottom of the <span>viewport</span>. Align the right edge of the <span>scrolling 2.32 + area</span> with the right of the <span>viewport</span>. 2.33 + <dt>If the <span>overflow directions</span> are rightward and upward 2.34 + <dd><p>Align the bottom edge of the <span>scrolling area</span> with the bottom of the <span>viewport</span>. Align the left edge of the <span>scrolling 2.35 + area</span> with the left of the <span>viewport</span>. 2.36 +</dl> 2.37 + 2.38 +<p class=note>The <span>beginning of the document</span> concept is used when navigating to the <code title>#top</code> fragment identifier, as defined in HTML. 2.39 +<span data-anolis-ref>HTML</span> 2.40 2.41 <h2>Extensions to the <code title>Window</code> Interface</h2> 2.42