[cssom-view] Define 'beginning of the document' for navigating to #top. https://www.w3.org/Bugs/Public/show_bug.cgi?id=15588

Fri, 31 May 2013 14:29:35 +0200

author
Simon Pieters <simonp@opera.com>
date
Fri, 31 May 2013 14:29:35 +0200
changeset 8317
6102bc601fb4
parent 8316
4173a32e6fc9
child 8318
bf6c0e839ca7

[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  

mercurial