[html5] r852 - /
whatwg at whatwg.org
whatwg at whatwg.org
Thu May 31 19:07:47 PDT 2007
Author: ianh
Date: 2007-05-31 19:07:46 -0700 (Thu, 31 May 2007)
New Revision: 852
Modified:
index
source
Log:
[] (0) Define scrollIntoView(). Fix a typo ('dir content attribute' not 'dom content attribute').
Modified: index
===================================================================
--- index 2007-06-01 01:24:34 UTC (rev 851)
+++ index 2007-06-01 02:07:46 UTC (rev 852)
@@ -350,6 +350,9 @@
<li><a href="#sequential"><span class=secno>3.5.2.2.
</span>Sequential focus navigation</a>
</ul>
+
+ <li><a href="#scrolling"><span class=secno>3.5.3. </span>Scrolling
+ elements into view</a>
</ul>
<li><a href="#the-root"><span class=secno>3.6. </span>The root
@@ -2557,7 +2560,8 @@
<p class=note>The <code title=dom-document-dir->dir</code> attribute on the
<code><a href="#htmldocument">HTMLDocument</a></code> interface is defined
- along with the <code title=attr-dom>dom</code> content attribute.
+ along with the <code title=attr-dir><a href="#dir">dir</a></code> content
+ attribute.
<h3 id=elements><span class=secno>2.2. </span>Elements</h3>
@@ -2595,6 +2599,8 @@
void <a href="#click" title=dom-click>click</a>();
void <a href="#focus0" title=dom-focus>focus</a>();
void <a href="#blur" title=dom-blur>blur</a>();
+ void <a href="#scrollintoview" title=dom-scrollIntoView>scrollIntoView</a>();
+ void <a href="#scrollintoview" title=dom-scrollIntoView>scrollIntoView</a>(in boolean top);
// <a href="#command1" title=concept-command>Commands</a>
attribute <a href="#htmlmenuelement">HTMLMenuElement</a> <a href="#contextmenu0" title=dom-contextMenu>contextMenu</a>;
@@ -6578,6 +6584,8 @@
void <span title="dom-click">click</span>();
void <span title="dom-focus">focus</span>();
void <span title="dom-blur">blur</span>();
+ void <span title="dom-scrollIntoView">scrollIntoView</span>();
+ void <span title="dom-scrollIntoView">scrollIntoView</span>(in boolean top);
DOCUMENT
readonly attribute <span>Element</span> <span title="dom-document-activeElement">activeElement</span>;
@@ -6747,6 +6755,30 @@
http://msdn.microsoft.com/workshop/author/dhtml/reference/methods/focus.asp
-->
+ <h4 id=scrolling><span class=secno>3.5.3. </span>Scrolling elements into
+ view</h4>
+
+ <p>The <dfn id=scrollintoview
+ title=dom-scrollIntoView><code>scrollIntoView([<var
+ title="">top</var>])</code></dfn> method, when called, must cause the
+ element on which the method was called to have the attention of the user
+ called to it.
+
+ <p class=note>In a speech browser, this could happen by having the current
+ playback position move to the start of the given element.
+
+ <p>In visual user agents, if the argument is present and has the value
+ false, the user agent should scroll the element into view such that both
+ the bottom and the top of the element are in the viewport, with the bottom
+ of the element aligned with the bottom of the viewport. If it isn't
+ possible to show the entire element in that way, or if the argument is
+ omitted or is true, then the user agent must instead simply align the top
+ of the document with the top of the viewport.
+
+ <p>Non-visual user agents may ignore the argument, or may treat it in some
+ media-specific manner most useful to the user.</p>
+ <!-- XXX maybe this should move to CSSOM -->
+
<h3 id=the-root><span class=secno>3.6. </span>The root element</h3>
<h4 id=the-html><span class=secno>3.6.1. </span>The <dfn
@@ -24988,7 +25020,7 @@
<li>
<p>If the new resource is the same as the current resource, but a
- fragment identifier has been specified, then <a href="#scrolling"
+ fragment identifier has been specified, then <a href="#scrolling0"
title=navigate-fragid>scroll the document to the specified element</a>
and abort these steps.
@@ -25344,7 +25376,7 @@
the page has been completely set up, the user agent must <a
href="#update">update the session history with the new page</a>.
- <h4 id=scroll-to-fragid><span class=secno>4.6.7. </span><dfn id=scrolling
+ <h4 id=scroll-to-fragid><span class=secno>4.6.7. </span><dfn id=scrolling0
title=navigate-fragid>Scrolling to a fragment identifier</dfn></h4>
<p>When a user agent is supposed to scroll to a particular element, it may
Modified: source
===================================================================
--- source 2007-06-01 01:24:34 UTC (rev 851)
+++ source 2007-06-01 02:07:46 UTC (rev 852)
@@ -1068,7 +1068,7 @@
<p class="note">The <code title="dom-document-dir-">dir</code>
attribute on the <code>HTMLDocument</code> interface is defined
- along with the <code title="attr-dom">dom</code> content
+ along with the <code title="attr-dir">dir</code> content
attribute.</p>
@@ -1108,6 +1108,8 @@
void <span title="dom-click">click</span>();
void <span title="dom-focus">focus</span>();
void <span title="dom-blur">blur</span>();
+ void <span title="dom-scrollIntoView">scrollIntoView</span>();
+ void <span title="dom-scrollIntoView">scrollIntoView</span>(in boolean top);
// <span title="concept-command">Commands</span>
attribute <span>HTMLMenuElement</span> <span title="dom-contextMenu">contextMenu</span>;
@@ -5239,6 +5241,8 @@
void <span title="dom-click">click</span>();
void <span title="dom-focus">focus</span>();
void <span title="dom-blur">blur</span>();
+ void <span title="dom-scrollIntoView">scrollIntoView</span>();
+ void <span title="dom-scrollIntoView">scrollIntoView</span>(in boolean top);
DOCUMENT
readonly attribute <span>Element</span> <span title="dom-document-activeElement">activeElement</span>;
@@ -5420,8 +5424,34 @@
-->
+ <h4>Scrolling elements into view</h4>
+ <p>The <dfn title="dom-scrollIntoView"><code>scrollIntoView([<var
+ title="">top</var>])</code></dfn> method, when called, must cause
+ the element on which the method was called to have the attention of
+ the user called to it.</p>
+ <p class="note">In a speech browser, this could happen by having the
+ current playback position move to the start of the given
+ element.</p>
+
+ <p>In visual user agents, if the argument is present and has the
+ value false, the user agent should scroll the element into view such
+ that both the bottom and the top of the element are in the viewport,
+ with the bottom of the element aligned with the bottom of the
+ viewport. If it isn't possible to show the entire element in that
+ way, or if the argument is omitted or is true, then the user agent
+ must instead simply align the top of the document with the top of
+ the viewport.</p>
+
+ <p>Non-visual user agents may ignore the argument, or may treat it
+ in some media-specific manner most useful to the user.</p>
+
+ <!-- XXX maybe this should move to CSSOM -->
+
+
+
+
<h3>The root element</h3>
<h4>The <dfn><code>html</code></dfn> element</h4>
More information about the Commit-Watchers
mailing list