- From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
- Date: Thu, 05 Feb 2009 09:18:16 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv26627
Modified Files:
Overview.html
Log Message:
Filling in the rendering section: Frames. (whatwg r2759)
Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.1928
retrieving revision 1.1929
diff -u -d -r1.1928 -r1.1929
--- Overview.html 5 Feb 2009 01:55:03 -0000 1.1928
+++ Overview.html 5 Feb 2009 09:18:13 -0000 1.1929
@@ -165,7 +165,8 @@
<li><a href=#real-numbers><span class=secno>2.4.3.3 </span>Real numbers</a></li>
<li><a href=#ratios><span class=secno>2.4.3.4 </span>Ratios</a></li>
<li><a href=#percentages-and-dimensions><span class=secno>2.4.3.5 </span>Percentages and lengths</a></li>
- <li><a href=#lists-of-integers><span class=secno>2.4.3.6 </span>Lists of integers</a></ol></li>
+ <li><a href=#lists-of-integers><span class=secno>2.4.3.6 </span>Lists of integers</a></li>
+ <li><a href=#lists-of-dimensions><span class=secno>2.4.3.7 </span>Lists of dimensions</a></ol></li>
<li><a href=#dates-and-times><span class=secno>2.4.4 </span>Dates and times</a>
<ol>
<li><a href=#months><span class=secno>2.4.4.1 </span>Months</a></li>
@@ -964,34 +965,33 @@
<li><a href=#self-contained-features><span class=secno>10.4 </span>Self-contained features</a>
<ol>
<li><a href=#embedded-content-1><span class=secno>10.4.1 </span>Embedded content</a></li>
- <li><a href=#fragment-identifiers><span class=secno>10.4.2 </span>Fragment identifiers</a></li>
- <li><a href=#frames><span class=secno>10.4.3 </span>Frames</a></li>
- <li><a href=#ruby-annotations><span class=secno>10.4.4 </span>Ruby annotations</a></li>
- <li><a href=#toolbars-0><span class=secno>10.4.5 </span>Toolbars</a>
+ <li><a href=#frames><span class=secno>10.4.2 </span>Frames</a></li>
+ <li><a href=#ruby-annotations><span class=secno>10.4.3 </span>Ruby annotations</a></li>
+ <li><a href=#toolbars-0><span class=secno>10.4.4 </span>Toolbars</a>
<ol>
- <li><a href=#the-icon-property><span class=secno>10.4.5.1 </span>The 'icon' property</a></ol></li>
- <li><a href=#the-bb-element-0><span class=secno>10.4.6 </span>The <code>bb</code> element</a></li>
- <li><a href=#the-br-element-0><span class=secno>10.4.7 </span>The <code>br</code> element</a></li>
- <li><a href=#the-button-element-0><span class=secno>10.4.8 </span>The <code>button</code> element</a></li>
- <li><a href=#the-datagrid-element><span class=secno>10.4.9 </span>The <code>datagrid</code> element</a></li>
- <li><a href=#the-details-element-0><span class=secno>10.4.10 </span>The <code>details</code> element</a></li>
- <li><a href=#the-fieldset-element-0><span class=secno>10.4.11 </span>The <code>fieldset</code> element</a></li>
- <li><a href=#the-figure-element-0><span class=secno>10.4.12 </span>The <code>figure</code> element</a></li>
- <li><a href=#the-hr-element-0><span class=secno>10.4.13 </span>The <code>hr</code> element</a></li>
- <li><a href=#the-input-element-as-a-text-entry-widget><span class=secno>10.4.14 </span>The <code>input</code> element as a text entry widget</a></li>
- <li><a href=#the-input-element-as-domain-specific-widgets><span class=secno>10.4.15 </span>The <code>input</code> element as domain-specific widgets</a></li>
- <li><a href=#the-input-element-as-a-range-control><span class=secno>10.4.16 </span>The <code>input</code> element as a range control</a></li>
- <li><a href=#the-input-element-as-a-color-well><span class=secno>10.4.17 </span>The <code>input</code> element as a color well</a></li>
- <li><a href=#the-input-element-as-a-check-box-widget><span class=secno>10.4.18 </span>The <code>input</code> element as a check box widget</a></li>
- <li><a href=#the-input-element-as-a-radio-button-widget><span class=secno>10.4.19 </span>The <code>input</code> element as a radio button widget</a></li>
- <li><a href=#the-input-element-as-a-file-upload-control><span class=secno>10.4.20 </span>The <code>input</code> element as a file upload control</a></li>
- <li><a href=#the-input-element-as-a-button><span class=secno>10.4.21 </span>The <code>input</code> element as a button</a></li>
- <li><a href=#the-marquee-element><span class=secno>10.4.22 </span>The <code>marquee</code> element</a></li>
- <li><a href=#the-meter-element-0><span class=secno>10.4.23 </span>The <code>meter</code> element</a></li>
- <li><a href=#the-progress-element-0><span class=secno>10.4.24 </span>The <code>progress</code> element</a></li>
- <li><a href=#the-select-element-0><span class=secno>10.4.25 </span>The <code>select</code> element</a></li>
- <li><a href=#the-textarea-element-0><span class=secno>10.4.26 </span>The <code>textarea</code> element</a></li>
- <li><a href=#the-title-attribute-0><span class=secno>10.4.27 </span>The <code title=attr-title>title</code> attribute</a></ol></li>
+ <li><a href=#the-icon-property><span class=secno>10.4.4.1 </span>The 'icon' property</a></ol></li>
+ <li><a href=#the-bb-element-0><span class=secno>10.4.5 </span>The <code>bb</code> element</a></li>
+ <li><a href=#the-br-element-0><span class=secno>10.4.6 </span>The <code>br</code> element</a></li>
+ <li><a href=#the-button-element-0><span class=secno>10.4.7 </span>The <code>button</code> element</a></li>
+ <li><a href=#the-datagrid-element><span class=secno>10.4.8 </span>The <code>datagrid</code> element</a></li>
+ <li><a href=#the-details-element-0><span class=secno>10.4.9 </span>The <code>details</code> element</a></li>
+ <li><a href=#the-fieldset-element-0><span class=secno>10.4.10 </span>The <code>fieldset</code> element</a></li>
+ <li><a href=#the-figure-element-0><span class=secno>10.4.11 </span>The <code>figure</code> element</a></li>
+ <li><a href=#the-hr-element-0><span class=secno>10.4.12 </span>The <code>hr</code> element</a></li>
+ <li><a href=#the-input-element-as-a-text-entry-widget><span class=secno>10.4.13 </span>The <code>input</code> element as a text entry widget</a></li>
+ <li><a href=#the-input-element-as-domain-specific-widgets><span class=secno>10.4.14 </span>The <code>input</code> element as domain-specific widgets</a></li>
+ <li><a href=#the-input-element-as-a-range-control><span class=secno>10.4.15 </span>The <code>input</code> element as a range control</a></li>
+ <li><a href=#the-input-element-as-a-color-well><span class=secno>10.4.16 </span>The <code>input</code> element as a color well</a></li>
+ <li><a href=#the-input-element-as-a-check-box-widget><span class=secno>10.4.17 </span>The <code>input</code> element as a check box widget</a></li>
+ <li><a href=#the-input-element-as-a-radio-button-widget><span class=secno>10.4.18 </span>The <code>input</code> element as a radio button widget</a></li>
+ <li><a href=#the-input-element-as-a-file-upload-control><span class=secno>10.4.19 </span>The <code>input</code> element as a file upload control</a></li>
+ <li><a href=#the-input-element-as-a-button><span class=secno>10.4.20 </span>The <code>input</code> element as a button</a></li>
+ <li><a href=#the-marquee-element><span class=secno>10.4.21 </span>The <code>marquee</code> element</a></li>
+ <li><a href=#the-meter-element-0><span class=secno>10.4.22 </span>The <code>meter</code> element</a></li>
+ <li><a href=#the-progress-element-0><span class=secno>10.4.23 </span>The <code>progress</code> element</a></li>
+ <li><a href=#the-select-element-0><span class=secno>10.4.24 </span>The <code>select</code> element</a></li>
+ <li><a href=#the-textarea-element-0><span class=secno>10.4.25 </span>The <code>textarea</code> element</a></li>
+ <li><a href=#the-title-attribute-0><span class=secno>10.4.26 </span>The <code title=attr-title>title</code> attribute</a></ol></li>
<li><a href=#interactive-media><span class=secno>10.5 </span>Interactive media</a>
<ol>
<li><a href=#hit-testing><span class=secno>10.5.1 </span>Hit testing</a></li>
@@ -2465,6 +2465,101 @@
<li><p>Return the <var title="">numbers</var> list and
abort.</li>
+ </ol><h5 id=lists-of-dimensions><span class=secno>2.4.3.7 </span>Lists of dimensions</h5><!-- no definition of a type since no conforming feature uses this
+ syntax (it's only used in cols="" and rows="" on <frameset> --><p>The <dfn id=rules-for-parsing-a-list-of-dimensions>rules for parsing a list of dimensions</dfn> are as
+ follows. These rules return a list of zero or more pairs consisting
+ of a number and a unit, the unit being one of <i>percentage</i>,
+ <i>relative</i>, and <i>absolute</i>.<ol><li><p>Let <var title="">raw input</var> be the string being
+ parsed.</li>
+
+ <li><p>If the last character in <var title="">raw input</var> is a
+ U+002C COMMA character (","), then remove that character from <var title="">raw input</var>.</li>
+
+ <li><p><a href=#split-a-string-on-commas title="split a string on commas">Split the string <var title="">raw input</var> on commas</a>. Let <var title="">raw
+ tokens</var> be the resulting list of tokens.</li>
+
+ <li><p>Let <var title="">result</var> be an empty list of
+ number/unit pairs.</li>
+
+ <li>
+
+ <p>For each token in <var title="">raw tokens</var>, run the
+ following substeps:</p>
+
+ <ol><li><p>Let <var title="">input</var> be the token.</li>
+
+ <li><p>Let <var title="">position</var> be a pointer into <var title="">input</var>, initially pointing at the start of the
+ string.</li>
+
+ <li><p>Let <var title="">value</var> be the number 0.</li>
+
+ <li><p>Let <var title="">unit</var> be <i>absolute</i>.</li>
+
+ <li><p>If <var title="">position</var> is past the end of <var title="">input</var>, set <var title="">unit</var> to
+ <i>relative</i> and jump to the last substep.</li>
+
+ <li><p>If the character at <var title="">position</var> is a
+ character in the range U+0030 DIGIT ZERO (0) to U+0039 DIGIT NINE
+ (9), <a href=#collect-a-sequence-of-characters>collect a sequence of characters</a> in the range
+ U+0030 DIGIT ZERO (0) to U+0039 DIGIT NINE (9), interpret the
+ resulting sequence as an integer in base ten, and increment <var title="">value</var> by that integer.</li>
+
+ <li>
+
+ <p>If the character at <var title="">position</var> is a U+002E
+ FULL STOP character (.), run these substeps:</p>
+
+ <ol><li><p><a href=#collect-a-sequence-of-characters>Collect a sequence of characters</a> consisting
+ of <a href=#space-character title="space character">space characters</a> and
+ characters in the range U+0030 DIGIT ZERO (0) to U+0039 DIGIT
+ NINE (9). Let <var title="">s</var> be the resulting
+ sequence.</li>
+
+ <li><p>Remove all <a href=#space-character title="space character">space
+ characters</a> in <var title="">s</var>.</li>
+
+ <li>
+
+ <p>If <var title="">s</var> is not the empty string, run these
+ subsubsteps:</p>
+
+ <ol><li><p>Let <var title="">length</var> be the number of
+ characters in <var title="">s</var> (after the spaces were
+ removed).</li>
+
+ <li><p>Let <var title="">fraction</var> be the result of
+ interpreting <var title="">s</var> as a base-ten integer, and
+ then dividing that number by <span title="">10<sup title=""><var title="">length</var></sup></span>.</li>
+
+ <li><p>Increment <var title="">value</var> by <var title="">fraction</var>.</li>
+
+ </ol></li>
+
+ </ol></li>
+
+ <li><p><a href=#skip-whitespace>Skip whitespace</a>.</li>
+
+ <li>
+
+ <p>If the character at <var title="">position</var> is a U+0025
+ PERCENT SIGN (%) character, then set <var title="">unit</var> to
+ <i>percentage</i>.</p>
+
+ <p>Otherwise, if the character at <var title="">position</var>
+ is a U+002A ASTERISK character (*), then set <var title="">unit</var> to <i>relative</i>.</p>
+
+ </li>
+
+ <!-- the remaining characters in /input/ are ignored -->
+
+ <li><p>Add an entry to <var title="">result</var> consisting of
+ the number given by <var title="">value</var> and the unit given
+ by <var title="">unit</var>.</li>
+
+ </ol></li>
+
+ <li><p>Return the list <var title="">result</var>.</li>
+
</ol><h4 id=dates-and-times><span class=secno>2.4.4 </span>Dates and times</h4><p>In the algorithms below, the <dfn id=number-of-days-in-month-month-of-year-year>number of days in month <var title="">month</var> of year <var title="">year</var></dfn> is:
<em>31</em> if <var title="">month</var> is 1, 3, 5, 7, 8, 10, or
12; <em>30</em> if <var title="">month</var> is 4, 6, 9, or 11;
@@ -3256,12 +3351,17 @@
</ol><p class=note>This causes any occurrences of the token to be
removed from the string, and any spaces that were surrounding the
token to be collapsed to a single space, except at the start and end
- of the string, where such spaces are removed.<h4 id=comma-separated-tokens><span class=secno>2.4.7 </span>Comma-separated tokens</h4><p class=XXX>We should allow whitespace around commas, and
- leading/trailing whitespace.<p>A <dfn id=set-of-comma-separated-tokens>set of comma-separated tokens</dfn> is a set of zero or
+ of the string, where such spaces are removed.<h4 id=comma-separated-tokens><span class=secno>2.4.7 </span>Comma-separated tokens</h4><p>A <dfn id=set-of-comma-separated-tokens>set of comma-separated tokens</dfn> is a set of zero or
more tokens each separated from the next by a single U+002C COMMA
character (<code title="">,</code>), where tokens consist of any
- string of zero or more characters, none of which are U+002C COMMA
- characters (<code title="">,</code>).<p><a href=#set-of-comma-separated-tokens title="set of comma-separated tokens">Sets of
+ string of zero or more characters, neither beginning nor ending with
+ <a href=#space-character title="space character">space characters</a>, nor
+ containing any U+002C COMMA characters (<code title="">,</code>),
+ and optionally surrounded by <a href=#space-character title="space character">space
+ characters</a>.<p class=example>For instance, the string "<code title=""> a ,b,,d d </code>" consists of four
+ tokens: "a", "b", the empty string, and "d d". Leading and
+ trailing whitespace around each token doesn't count as part of the
+ token, and the empty string can be a token.<p><a href=#set-of-comma-separated-tokens title="set of comma-separated tokens">Sets of
comma-separated tokens</a> sometimes have further restrictions on
what consists a valid token. When such restrictions are defined, the
tokens must all fit within those restrictions; other values are
@@ -3280,10 +3380,12 @@
end of <var title="">input</var>, jump to the last step.</li>
<li><p><a href=#collect-a-sequence-of-characters>Collect a sequence of characters</a> that are not
- U+002C COMMA characters (<code title="">,</code>).</li>
+ U+002C COMMA characters (<code title="">,</code>). Let <var title="">s</var> be the resulting sequence (which might be the
+ empty string).</li>
- <li><p>Add the string collected in the previous step (which might
- be the empty string) to <var title="">tokens</var>.</li>
+ <li><p>Remove any leading or trailing sequence of <a href=#space-character title="space character">space characters</a> from <var title="">s</var>.</li>
+
+ <li><p>Add <var title="">s</var> to <var title="">tokens</var>.</li>
<li><p>If <var title="">position</var> is not past the end of <var title="">input</var>, then the character at <var title="">position</var> is a U+002C COMMA character (<code title="">,</code>); advance <var title="">position</var> past that
character.</li>
@@ -21094,9 +21196,9 @@
single <a href=#valid-e-mail-address>valid e-mail address</a>, the element is
<a href=#suffering-from-a-type-mismatch>suffering from a type mismatch</a>.<p>A <dfn id=valid-e-mail-address-list>valid e-mail address list</dfn> is a <a href=#set-of-comma-separated-tokens>set of
comma-separated tokens</a>, where each token is itself a
- <a href=#valid-e-mail-address>valid e-mail address</a>, possibly with one or more leading
- or trailing <a href=#space-character title="space character">space
- characters</a>.<p>A <dfn id=valid-e-mail-address>valid e-mail address</dfn> is a string that matches the
+ <a href=#valid-e-mail-address>valid e-mail address</a>. To obtain the list of tokens from
+ a <a href=#valid-e-mail-address-list>valid e-mail address list</a>, the user agent must <a href=#split-a-string-on-commas title="split a string on commas">split the string on
+ commas</a>.<p>A <dfn id=valid-e-mail-address>valid e-mail address</dfn> is a string that matches the
production <code title="">dot-atom "@" dot-atom</code>
where <code title="">dot-atom</code> is defined in RFC 2822 section
3.2.4, excluding the <code>CFWS</code> production everywhere. <a href=#references>[RFC2822]</a><div class=bookkeeping>
@@ -22233,7 +22335,9 @@
</dl><p>The tokens must not be <a href=#ascii-case-insensitive>ASCII case-insensitive</a>
matches for any of the other tokens (i.e. duplicates are not
- allowed).<p>User agents should prevent the user from selecting files that are
+ allowed). To obtain the list of tokens from the attribute, the user
+ agent must <a href=#split-a-string-on-commas title="split a string on commas">split the
+ attribute value on commas</a>.<p>User agents should prevent the user from selecting files that are
not accepted by one (or more) of these tokens.</p><hr><div class=bookkeeping>
<p>The following common <code><a href=#the-input-element>input</a></code> element content
@@ -46226,7 +46330,36 @@
<code><a href=#the-iframe-element>iframe</a></code> element, then the the <dfn id=container-frame-element>container frame
element</dfn> of the <code><a href=#the-body-element>body</a></code> element is that
<code>frame</code> or <code><a href=#the-iframe-element>iframe</a></code> element. Otherwise, there
- is no <a href=#container-frame-element>container frame element</a>.</p><hr><p>The <code><a href=#the-table-element>table</a></code> element's <code title=attr-table-cellspacing>cellspacing</code> attribute
+ is no <a href=#container-frame-element>container frame element</a>.</p><hr><p>If the <code>Document</code> has a <a href=#root-element>root element</a>, and
+ the <code>Document</code>'s <a href=#browsing-context>browsing context</a> is a
+ <a href=#nested-browsing-context>nested browsing context</a>, and the <a href=#browsing-context-container>browsing context
+ container</a> of that <a href=#nested-browsing-context>nested browsing context</a> is a
+ <code>frame</code> or <code><a href=#the-iframe-element>iframe</a></code> element, and that element
+ has a <code title=attr-frames-scrolling>scrolling</code>
+ attribute, then the user agent is expected to compare the value of
+ the attribute in an <a href=#ascii-case-insensitive>ASCII case-insensitive</a> manner to
+ the values in the first column of the following table, and if one of
+ them matches, then the user agent is expected to treat that
+ attribute as a <a href=#presentational-hints title="presentational hints">presentational
+ hint</a> for the aforementioned root element's 'overflow'
+ property, setting it to the value given in the corresponding cell on
+ the same row in the second column:<table><thead><tr><th> Attribute value
+ <th> 'overflow' value
+ <tbody><tr><td><code title="">on</code>
+ <td>'scroll'
+ <tr><td><code title="">scroll</code>
+ <td>'scroll'
+ <tr><td><code title="">yes</code>
+ <td>'scroll'
+ <tr><td><code title="">off</code>
+ <td>'hidden'
+ <tr><td><code title="">noscroll</code>
+ <td>'hidden'
+ <tr><td><code title="">no</code>
+ <td>'hidden'
+ <tr><td><code title="">auto</code>
+ <td>'auto'
+ </table><hr><p>The <code><a href=#the-table-element>table</a></code> element's <code title=attr-table-cellspacing>cellspacing</code> attribute
<a href=#maps-to-the-pixel-length-property>maps to the pixel length property</a> 'border-spacing' on the
element.<p>The <code><a href=#the-table-element>table</a></code> element's <code title=attr-table-cellpadding>cellpadding</code> attribute <a href=#maps-to-the-pixel-length-property title="maps to the pixel length property">maps to the pixel length
properties</a> 'padding-top', 'padding-right', 'padding-bottom',
@@ -46911,11 +47044,275 @@
<code>Document</code> is in <a href=#quirks-mode>quirks mode</a>:<pre class=css>@namespace url(http://www.w3.org/1999/xhtml);
img[align=left] { margin-right: 3px; }
-img[align=right] { margin-left: 3px; }</pre><h4 id=fragment-identifiers><span class=secno>10.4.2 </span>Fragment identifiers</h4><p class=XXX>(need to remove "must" and reword) CSS UAs in visual
- media must, when scrolling a page to a fragment identifier, align
- the top of the viewport with the target element's top border
- edge.</p><!-- XXX horiz pos given bidi, and not scrolling when not
- required to? --><h4 id=frames><span class=secno>10.4.3 </span>Frames</h4><p class=XXX>...</p><!-- <frame>: bordercolor; frameborder (yes/1|no/0); marginwidth, marginheight (int/%); scrolling (yes/on/scroll|no/off/noscroll|auto) --><!-- <frame>, <iframe>: scrolling (yes/on/scroll|no/off/noscroll|auto) --><h4 id=ruby-annotations><span class=secno>10.4.4 </span>Ruby annotations</h4><p class=XXX>...</p><!-- XXX ruby, rt, rp
+img[align=right] { margin-left: 3px; }</pre><h4 id=frames><span class=secno>10.4.2 </span>Frames</h4><p>When an <code><a href=#the-html-element>html</a></code> element's second child element is a
+ <code>frameset</code> element, the user agent is expected to render
+ the <code>frameset</code> element as described below across the
+ surface of the <a href=#view>view</a>, instead of applying the usual CSS
+ rendering rules.<p>When rendering a <code>frameset</code> on a surface, the user
+ agent is expected to use the following layout algorithm:<ol><li>
+
+ <p>The <var title="">cols</var> and <var title="">rows</var>
+ variables are lists of zero or more pairs consisting of a number
+ and a unit, the unit being one of <i>percentage</i>,
+ <i>relative</i>, and <i>absolute</i>.</p>
+
+ <p>Use the <a href=#rules-for-parsing-a-list-of-dimensions>rules for parsing a list of dimensions</a> to
+ parse the value of the element's <code title=attr-frameset-cols>cols</code> attribute, if there is
+ one. Let <var title="">cols</var> be the result, or an empty list
+ if there is no such attribute.</p>
+
+ <p>Use the <a href=#rules-for-parsing-a-list-of-dimensions>rules for parsing a list of dimensions</a> to
+ parse the value of the element's <code title=attr-frameset-rows>rows</code> attribute, if there is
+ one. Let <var title="">rows</var> be the result, or an empty list
+ if there is no such attribute.</p>
+
+ </li>
+
+ <li>
+
+ <p>For any of the entries in <var title="">cols</var> or <var title="">rows</var> that have the number zero and the unit
+ <i>relative</i>, change the entry's number to one.</p>
+
+ </li>
+
+ <li>
+
+ <p>If <var title="">cols</var> has no entries, then add a single
+ entry consisting of the value 1 and the unit <i>relative</i> to
+ <var title="">cols</var>.</p>
+
+ <p>If <var title="">rows</var> has no entries, then add a single
+ entry consisting of the value 1 and the unit <i>relative</i> to
+ <var title="">rows</var>.</p>
+
+ </li>
+
+ <li>
+
+ <p>Invoke the algorithm defined below to <a href=#convert-a-list-of-dimensions-to-a-list-of-pixel-values>convert a list of
+ dimensions to a list of pixel values</a> using <var title="">cols</var> as the input list, and the width of the
+ surface that the <code><a href=#the-fieldset-element>fieldset</a></code> is being rendered into, in
+ CSS pixels, as the input dimension. Let <var title="">sized
+ cols</var> be the resulting list.</p>
+
+ <p>Invoke the algorithm defined below to <a href=#convert-a-list-of-dimensions-to-a-list-of-pixel-values>convert a list of
+ dimensions to a list of pixel values</a> using <var title="">rows</var> as the input list, and the height of the
+ surface that the <code><a href=#the-fieldset-element>fieldset</a></code> is being rendered into, in
+ CSS pixels, as the input dimension. Let <var title="">sized
+ rows</var> be the resulting list.</p>
+
+ </li>
+
+ <li>
+
+ <p>Split the surface into a grid of <span title=""><var title="">w</var>×<var title="">h</var></span> rectangles,
+ where <var title="">w</var> is the number of entries in <var title="">sized cols</var> and <var title="">h</var> is the number
+ of entries in <var title="">sized rows</var>.</p>
+
+ <p>Size the columns so that each column in the grid is as many CSS
+ pixels wide as the corresponding entry in the <var title="">sized
+ cols</var> list.</p>
+
+ <p>Size the rows so that each row in the grid is as many CSS
+ pixels high as the corresponding entry in the <var title="">sized
+ rows</var> list.</p>
+
+ </li>
+
+ <li>
+
+ <p>Let <var title="">children</var> be the list of
+ <code>frame</code> and <code>frameset</code> elements that are
+ children of the <code>frameset</code> element for which the
+ algorithm was invoked.</p>
+
+ </li>
+
+ <li>
+
+ <p>For each row of the grid of rectangles created in the previous
+ step, from top to bottom, run these substeps:</p>
+
+ <ol><li>
+
+ <p>For each rectangle in the row, from left to right, run these
+ substeps:</p>
+
+ <ol><li>
+
+ <p>If there are any elements left in <var title="">children</var>, take the first element in the list,
+ and assign it to the rectangle.</p>
+
+ <p>If this is a <code>frameset</code> element, then recurse
+ the entire <code>frameset</code> layout algorithm for that
+ <code>frameset</code> element, with the rectangle as the
+ surface.</p>
+
+ <p>Otherwise, it is a <code>frame</code> element; create a
+ <a href=#nested-browsing-context>nested browsing context</a> sized to fit the
+ rectangle.</p>
+
+ </li>
+
+ <li>
+
+ <p>If there are any elements left in <var title="">children</var>, remove the first element from <var title="">children</var>.</p>
+
+ </ol></li>
+
+ </ol></li>
+
+ <li>
+
+ <p>If the <code>frameset</code> element <a href=#has-a-border>has a border</a>,
+ draw an outer set of borders around the rectangles, using the
+ element's <a href=#frame-border-color>frame border color</a>.</p>
+
+ <p>For each rectangle, if there is an element assigned to that
+ rectangle, and that element <a href=#has-a-border>has a border</a>, draw an
+ inner set of borders around that rectangle, using the
+ element's <a href=#frame-border-color>frame border color</a>.</p>
+
+ <p>For each (visible) border that does not abut a rectangle that
+ is assigned a <code>frame</code> element with a <code title=attr-frame-noresize>noresize</code> attribute (including
+ rectangles in further nested <code>frameset</code> elements), the
+ user agent is expected to allow the user to move the border,
+ resizing the rectangles within, keeping the proportions of any
+ nested <code>frameset</code> grids.</p>
+
+ <p>A <code>frameset</code> or <code>frame</code> element <dfn id=has-a-border>has
+ a border</dfn> if the following algorithm returns true:</p>
+
+ <ol><li><p>If the element has a <code title=attr-frames-frameborder>frameborder</code> attribute
+ whose value is not the empty string and whose first character is
+ either a U+0031 DIGIT ONE (1), a U+0079 LATIN SMALL LETTER Y, or
+ a U+0059 LATIN CAPITAL LETTER Y, then return true.</li>
+
+ <li><p>Otherwise, if the element has a <code title=attr-frames-frameborder>frameborder</code> attribute,
+ return false.</li>
+
+ <li><p>Otherwise, if the element has a parent element that is a
+ <code>frameset</code> element, then return true if <em>that</em>
+ element <a href=#has-a-border>has a border</a>, and false if it does
+ not.</li>
+
+ <li><p>Otherwise, return true.</li>
+
+ </ol><p>The <dfn id=frame-border-color>frame border color</dfn> of a <code>frameset</code> or
+ <code>frame</code> element is the color obtained from the
+ following algorithm:</p>
+
+ <ol><li><p>If the element has a <code title=attr-frames-bordercolor>bordercolor</code> attribute,
+ then return the color obtained from applying the <a href=#rules-for-parsing-a-legacy-color-value>rules for
+ parsing a legacy color value</a> to that attribute's
+ value.</li>
+
+ <li><p>Otherwise, if the element has a parent element that is a
+ <code>frameset</code> element, then the <a href=#frame-border-color>frame border
+ color</a> of that element.</p>
+
+ <li><p>Otherwise, return gray.</li>
+
+ </ol></li>
+
+ </ol><p>The algorithm to <dfn id=convert-a-list-of-dimensions-to-a-list-of-pixel-values>convert a list of dimensions to a list of
+ pixel values</dfn> consists of the following steps:<ol><li>
+
+ <p>Let <var title="">input list</var> be the list of numbers and
+ units passed to the algorithm.</p>
+
+ <p>Let <var title="">output list</var> be a list of numbers the
+ same length as <var title="">input list</var>, all zero.</p>
+
+ <p>Entries in <var title="">output list</var> correspond to the
+ entries in <var title="">input list</var> that have the same
+ position.</p>
+
+ </li>
+
+ <li><p>Let <var title="">input dimension</var> be the size passed
+ to the algorithm.</p>
+
+ <li>
+
+ <p>Let <var title="">count percentage</var> be the number of
+ entries in <var title="">input list</var> whose unit is
+ <i>percentage</i>.</p>
+
+ <p>Let <var title="">total percentage</var> be the sum of all the
+ numbers in <var title="">input list</var> whose unit is
+ <i>percentage</i>.</p>
+
+ <p>Let <var title="">count relative</var> be the number of
+ entries in <var title="">input list</var> whose unit is
+ <i>relative</i>.</p>
+
+ <p>Let <var title="">total relative</var> be the sum of all the
+ numbers in <var title="">input list</var> whose unit is
+ <i>relative</i>.</p>
+
+ <p>Let <var title="">count absolute</var> be the number of
+ entries in <var title="">input list</var> whose unit is
+ <i>absolute</i>.</p>
+
+ <p>Let <var title="">total absolute</var> be the sum of all the
+ numbers in <var title="">input list</var> whose unit is
+ <i>absolute</i>.</p>
+
+ <p>Let <var title="">remaining space</var> be the value of <var title="">input dimension</var>.</p>
+
+ </li>
+
+ <li>
+
+ <p>If <var title="">total absolute</var> is greater than <var title="">remaining space</var>, then for each entry in <var title="">input list</var> whose unit is <i>absolute</i>, set the
+ corresponding value in <var title="">output list</var> to the
+ number of the entry in <var title="">input list</var> multiplied
+ by <var title="">remaining space</var> and divided by <var title="">total absolute</var>. Then, set <var title="">remaining
+ space</var> to zero.</p>
+
+ <p>Otherwise, for each entry in <var title="">input list</var>
+ whose unit is <i>absolute</i>, set the corresponding value in <var title="">output list</var> to the number of the entry in <var title="">input list</var>. Then, decrement <var title="">remaining
+ space</var> by <var title="">total absolute</var>.</p>
+
+ </li>
+
+ <li>
+
+ <p>If <var title="">total percentage</var> multiplied by the <var title="">input dimension</var> and divided by 100 is greater than
+ <var title="">remaining space</var>, then for each entry in <var title="">input list</var> whose unit is <i>percentage</i>, set the
+ corresponding value in <var title="">output list</var> to the
+ number of the entry in <var title="">input list</var> multiplied
+ by <var title="">remaining space</var> and divided by <var title="">total percentage</var>. Then, set <var title="">remaining
+ space</var> to zero.</p>
+
+ <p>Otherwise, for each entry in <var title="">input list</var>
+ whose unit is <i>percentage</i>, set the corresponding value in
+ <var title="">output list</var> to the number of the entry in <var title="">input list</var> multiplied by the <var title="">input
+ dimension</var> and divided by 100. Then, decrement <var title="">remaining space</var> by <var title="">total
+ percentage</var> multiplied by the <var title="">input
+ dimension</var> and divided by 100.</p>
+
+ </li>
+
+ <li>
+
+ <p>For each entry in <var title="">input list</var> whose unit is
+ <i>relative</i>, set the corresponding value in <var title="">output list</var> to the number of the entry in <var title="">input list</var> multiplied by <var title="">remaining
+ space</var> and divided by <var title="">total relative</var>.</p>
+
+ </li>
+
+ <li><p>Return <var title="">output list</var>.</li>
+
+ </ol><p>User agents working with integer values for frame widths (as
+ opposed to user agents that can lay frames out with subpixel
+ accuracy) are expected to distribute the remainder first the last
+ entry whose unit is <i>relative</i>, then equally (not
+ proportionally) to each entry whose unit is <i>percentage</i>, then
+ equally (not proportionally) to each entry whose unit is
+ <i>absolute</i>, and finally, failing all else, to the last
+ entry.<h4 id=ruby-annotations><span class=secno>10.4.3 </span>Ruby annotations</h4><p class=XXX>...</p><!-- XXX ruby, rt, rp
> * note on rt rendering
>
> Since there are a number of documents with ruby but without rp, when you
@@ -46924,23 +47321,23 @@
> "(" and ")" before and after ruby text (using, e.g., CSS ::before and
> ::after) even when there are no rp elements. Otherwise, reading Web
> pages without rp is very annoying.
- --><h4 id=toolbars-0><span class=secno>10.4.5 </span>Toolbars</h4><h5 id=the-icon-property><span class=secno>10.4.5.1 </span>The 'icon' property</h5><p>UAs should use the command's Icon as the default generic icon
+ --><h4 id=toolbars-0><span class=secno>10.4.4 </span>Toolbars</h4><h5 id=the-icon-property><span class=secno>10.4.4.1 </span>The 'icon' property</h5><p>UAs should use the command's Icon as the default generic icon
provided by the user agent when the 'icon' property computes to
'auto' on an element that either defines a command or refers to one
using the <code title=command-attribute>command</code> attribute,
but when the property computes to an actual image, it should use
- that image instead.<h4 id=the-bb-element-0><span class=secno>10.4.6 </span>The <code><a href=#the-bb-element>bb</a></code> element</h4><p class=XXX>...<h4 id=the-br-element-0><span class=secno>10.4.7 </span>The <code><a href=#the-br-element>br</a></code> element</h4><p class=XXX>...</p><!-- clear="left|right|all|both" --><h4 id=the-button-element-0><span class=secno>10.4.8 </span>The <code><a href=#the-button-element>button</a></code> element</h4><p class=XXX>...<h4 id=the-datagrid-element><span class=secno>10.4.9 </span>The <code><a href=#datagrid>datagrid</a></code> element</h4><p class=XXX>This section will probably include details on
+ that image instead.<h4 id=the-bb-element-0><span class=secno>10.4.5 </span>The <code><a href=#the-bb-element>bb</a></code> element</h4><p class=XXX>...<h4 id=the-br-element-0><span class=secno>10.4.6 </span>The <code><a href=#the-br-element>br</a></code> element</h4><p class=XXX>...</p><!-- clear="left|right|all|both" --><h4 id=the-button-element-0><span class=secno>10.4.7 </span>The <code><a href=#the-button-element>button</a></code> element</h4><p class=XXX>...<h4 id=the-datagrid-element><span class=secno>10.4.8 </span>The <code><a href=#datagrid>datagrid</a></code> element</h4><p class=XXX>This section will probably include details on
how to render DATAGRID (including <span id=datagridPseudos>its
pseudo-elements</span>), drag-and-drop, etc, in a visual medium, in
- concert with CSS.<h4 id=the-details-element-0><span class=secno>10.4.10 </span>The <code><a href=#the-details-element>details</a></code> element</h4><p class=XXX>...<h4 id=the-fieldset-element-0><span class=secno>10.4.11 </span>The <code><a href=#the-fieldset-element>fieldset</a></code> element</h4><p class=XXX>...</p><!-- XXX <legend align="left|right|center|bottom|top"> --><h4 id=the-figure-element-0><span class=secno>10.4.12 </span>The <code><a href=#the-figure-element>figure</a></code> element</h4><p class=XXX>...<h4 id=the-hr-element-0><span class=secno>10.4.13 </span>The <code><a href=#the-hr-element>hr</a></code> element</h4><p class=XXX>...</p><!-- align=left|right|center (as auto margins), width=(int=>width:px; %->width:%)
+ concert with CSS.<h4 id=the-details-element-0><span class=secno>10.4.9 </span>The <code><a href=#the-details-element>details</a></code> element</h4><p class=XXX>...<h4 id=the-fieldset-element-0><span class=secno>10.4.10 </span>The <code><a href=#the-fieldset-element>fieldset</a></code> element</h4><p class=XXX>...</p><!-- XXX <legend align="left|right|center|bottom|top"> --><h4 id=the-figure-element-0><span class=secno>10.4.11 </span>The <code><a href=#the-figure-element>figure</a></code> element</h4><p class=XXX>...<h4 id=the-hr-element-0><span class=secno>10.4.12 </span>The <code><a href=#the-hr-element>hr</a></code> element</h4><p class=XXX>...</p><!-- align=left|right|center (as auto margins), width=(int=>width:px; %->width:%)
color (color implies noshade); sets 'color' which then propagates to border-color; defaults to 'gray'
size=int, noshade
with noshade: border-width = size/2 (default size=2 => 1px per side); solid borders; rounded corners
without no shade: inset borders
without noshade, size>1: height = size-2; border-width=1px
without noshade, size=1: height = 0; border-top-width=1px only
- --><h4 id=the-input-element-as-a-text-entry-widget><span class=secno>10.4.14 </span>The <code><a href=#the-input-element>input</a></code> element as a text entry widget</h4><p class=XXX>When an <code><a href=#the-input-element>input</a></code> element's <code title=attr-input-type><a href=#attr-input-type>type</a></code> attribute is in the <a href=#text-state-and-search-state title=attr-input-type-text>Text</a>, <a href=#text-state-and-search-state title=attr-input-type-search>Search</a>, <a href=#url-state title=attr-input-type-url>URL</a>, <a href=#e-mail-state title=attr-input-type-email>E-mail</a>, or <a href=#password-state title=attr-input-type-password>Password</a> state, ...</p><!-- datalist presentation --><!-- size: http://mxr.mozilla.org/mozilla-central/ident?i=CalcIntrinsicSize --><h4 id=the-input-element-as-domain-specific-widgets><span class=secno>10.4.15 </span>The <code><a href=#the-input-element>input</a></code> element as domain-specific widgets</h4><p class=XXX>When an <code><a href#the-input-element>input</a></code> element's <code title=attr-input-type><a href=#attr-input-type>type</a></code> attribute is in the <a href=#date-and-time-state title=attr-input-type-datetime>Date and Time</a>, <a href=#date-state title=attr-input-type-date>Date</a>, <a href=#month-state title=attr-input-type-month>Month</a>, <a href=#week-state title=attr-input-type-week>Week</a>, <a href=#time-state title=attr-input-type-time>Time</a>, <a href=#local-date-and-time-state title=attr-input-type-datetime-local>Local Date and Time</a> or
- <a href=#number-state title=attr-input-type-number>Number</a> state...</p><!-- datalist presentation --><h4 id=the-input-element-as-a-range-control><span class=secno>10.4.16 </span>The <code><a href=#the-input-element>input</a></code> element as a range control</h4><p class=XXX>When an <code><a href=#the-input-element>input</a></code> element's <code title=attr-input-type><a href=#attr-input-type>type</a></code> attribute is in the <a href=#range-state title=attr-input-type-range>Range</a> state, ...</p><!-- datalist presentation --><h4 id=the-input-element-as-a-color-well><span class=secno>10.4.17 </span>The <code><a href=#the-input-element>input</a></code> element as a color well</h4><p class=XXX>When an <code><a href=#the-input-element>input</a></code> element's <code title=attr-input-type><a href=#attr-input-type>type</a></code> attribute is in the <a href=#color-state title=attr-input-type-color>Color</a> state, ...</p><!-- datalist presentation --><h4 id=the-input-element-as-a-check-box-widget><spa class=secno>10.4.18 </span>The <code><a href=#the-input-element>input</a></code> element as a check box widget</h4><p class=XXX>When an <code><a href=#the-input-element>input</a></code> element's <code title=attr-input-type><a href=#attr-input-type>type</a></code> attribute is in the <a href=#checkbox-state title=attr-input-type-checkbox>Checkbox</a> state, ...<h4 id=the-input-element-as-a-radio-button-widget><span class=secno>10.4.19 </span>The <code><a href=#the-input-element>input</a></code> element as a radio button widget</h4><p class=XXX>When an <code><a href=#the-input-element>input</a></code> element's <code title=attr-input-type><a href=#attr-input-type>type</a></code> attribute is in the <a href=#radio-button-state title=attr-input-type-radio>Radio Button</a> state, ...<h4 id=the-input-element-as-a-file-upload-control><span class=secno>10.4.20 </span>The <code><a href=#the-input-element>input</a></code> element as a file upload control</h4><p class=XXX>When an <code><a href=#the-input-element>inpt</a></code> element's <code title=attr-input-type><a href=#attr-input-type>type</a></code> attribute is in the <a href=#file-upload-state title=attr-input-type-file>File Upload</a> state, ...<h4 id=the-input-element-as-a-button><span class=secno>10.4.21 </span>The <code><a href=#the-input-element>input</a></code> element as a button</h4><p class=XXX>When an <code><a href=#the-input-element>input</a></code> element's <code title=attr-input-type><a href=#attr-input-type>type</a></code> attribute is in the <a href=#submit-button-state title=attr-input-type-submit>Submit Button</a> <a href=#reset-button-state title=attr-input-type-reset>Reset Button</a>, or <a href=#button-state title=attr-input-type-button>Button</a> state, ...<h4 id=the-marquee-element><span class=secno>10.4.22 </span>The <code><a href=#the-marquee-element-0>marquee</a></code> element</h4><p class=XXX>...</p><!-- XXX attributes: height/width; direction is case insensitive; bgcolor; hspace/vspace --><h4 id=the-meter-element-0><span class=secn>10.4.23 </span>The <code><a href=#the-meter-element>meter</a></code> element</h4><p class=XXX>...<h4 id=the-progress-element-0><span class=secno>10.4.24 </span>The <code><a href=#the-progress-element>progress</a></code> element</h4><p class=XXX>...<h4 id=the-select-element-0><span class=secno>10.4.25 </span>The <code><a href=#the-select-element>select</a></code> element</h4><p class=XXX>...</p><!-- multiple, size; optgroup --><h4 id=the-textarea-element-0><span class=secno>10.4.26 </span>The <code><a href=#the-textarea-element>textarea</a></code> element</h4><p class=XXX>...<h4 id=the-title-attribute-0><span class=secno>10.4.27 </span>The <code title=attr-title><a href=#the-title-attribute>title</a></code> attribute</h4><p>Given an element (e.g. the element designated by the mouse
+ --><h4 id=the-input-element-as-a-text-entry-widget><span class=secno>10.4.13 </span>The <code><a href=#the-input-element>input</a></code> element as a text entry widget</h4><p class=XXX>When an <code><a href=#the-input-element>input</a></code> element's <code title=attr-input-type><a href=#attr-input-type>type</a></code> attribute is in the <a href=#text-state-and-search-state title=attr-input-type-text>Text</a>, <a href=#text-state-and-search-state title=attr-input-type-search>Search</a>, <a href=#url-state title=attr-input-type-url>URL</a>, <a href=#e-mail-state title=attr-input-type-email>E-mail</a>, or <a href=#password-state title=attr-input-type-password>Password</a> state, ...</p><!-- datalist presentation --><!-- size: http://mxr.mozilla.org/mozilla-central/ident?i=CalcIntrinsicSize --><h4 id=the-input-element-as-domain-specific-widgets><span class=secno>10.4.14 </span>The <code><a href=#the-input-element>input</a></code> element as domain-specific widgets</h4><p class=XXX>When an <code><a href#the-input-element>input</a></code> element's <code title=attr-input-type><a href=#attr-input-type>type</a></code> attribute is in the <a href=#date-and-time-state title=attr-input-type-datetime>Date and Time</a>, <a href=#date-state title=attr-input-type-date>Date</a>, <a href=#month-state title=attr-input-type-month>Month</a>, <a href=#week-state title=attr-input-type-week>Week</a>, <a href=#time-state title=attr-input-type-time>Time</a>, <a href=#local-date-and-time-state title=attr-input-type-datetime-local>Local Date and Time</a> or
+ <a href=#number-state title=attr-input-type-number>Number</a> state...</p><!-- datalist presentation --><h4 id=the-input-element-as-a-range-control><span class=secno>10.4.15 </span>The <code><a href=#the-input-element>input</a></code> element as a range control</h4><p class=XXX>When an <code><a href=#the-input-element>input</a></code> element's <code title=attr-input-type><a href=#attr-input-type>type</a></code> attribute is in the <a href=#range-state title=attr-input-type-range>Range</a> state, ...</p><!-- datalist presentation --><h4 id=the-input-element-as-a-color-well><span class=secno>10.4.16 </span>The <code><a href=#the-input-element>input</a></code> element as a color well</h4><p class=XXX>When an <code><a href=#the-input-element>input</a></code> element's <code title=attr-input-type><a href=#attr-input-type>type</a></code> attribute is in the <a href=#color-state title=attr-input-type-color>Color</a> state, ...</p><!-- datalist presentation --><h4 id=the-input-element-as-a-check-box-widget><spa class=secno>10.4.17 </span>The <code><a href=#the-input-element>input</a></code> element as a check box widget</h4><p class=XXX>When an <code><a href=#the-input-element>input</a></code> element's <code title=attr-input-type><a href=#attr-input-type>type</a></code> attribute is in the <a href=#checkbox-state title=attr-input-type-checkbox>Checkbox</a> state, ...<h4 id=the-input-element-as-a-radio-button-widget><span class=secno>10.4.18 </span>The <code><a href=#the-input-element>input</a></code> element as a radio button widget</h4><p class=XXX>When an <code><a href=#the-input-element>input</a></code> element's <code title=attr-input-type><a href=#attr-input-type>type</a></code> attribute is in the <a href=#radio-button-state title=attr-input-type-radio>Radio Button</a> state, ...<h4 id=the-input-element-as-a-file-upload-control><span class=secno>10.4.19 </span>The <code><a href=#the-input-element>input</a></code> element as a file upload control</h4><p class=XXX>When an <code><a href=#the-input-element>inpt</a></code> element's <code title=attr-input-type><a href=#attr-input-type>type</a></code> attribute is in the <a href=#file-upload-state title=attr-input-type-file>File Upload</a> state, ...<h4 id=the-input-element-as-a-button><span class=secno>10.4.20 </span>The <code><a href=#the-input-element>input</a></code> element as a button</h4><p class=XXX>When an <code><a href=#the-input-element>input</a></code> element's <code title=attr-input-type><a href=#attr-input-type>type</a></code> attribute is in the <a href=#submit-button-state title=attr-input-type-submit>Submit Button</a> <a href=#reset-button-state title=attr-input-type-reset>Reset Button</a>, or <a href=#button-state title=attr-input-type-button>Button</a> state, ...<h4 id=the-marquee-element><span class=secno>10.4.21 </span>The <code><a href=#the-marquee-element-0>marquee</a></code> element</h4><p class=XXX>...</p><!-- XXX attributes: height/width; direction is case insensitive; bgcolor; hspace/vspace --><h4 id=the-meter-element-0><span class=secn>10.4.22 </span>The <code><a href=#the-meter-element>meter</a></code> element</h4><p class=XXX>...<h4 id=the-progress-element-0><span class=secno>10.4.23 </span>The <code><a href=#the-progress-element>progress</a></code> element</h4><p class=XXX>...<h4 id=the-select-element-0><span class=secno>10.4.24 </span>The <code><a href=#the-select-element>select</a></code> element</h4><p class=XXX>...</p><!-- multiple, size; optgroup --><h4 id=the-textarea-element-0><span class=secno>10.4.25 </span>The <code><a href=#the-textarea-element>textarea</a></code> element</h4><p class=XXX>...<h4 id=the-title-attribute-0><span class=secno>10.4.26 </span>The <code title=attr-title><a href=#the-title-attribute>title</a></code> attribute</h4><p>Given an element (e.g. the element designated by the mouse
cursor), if the element, or one of its ancestors, has a <code title=attr-title><a href=#the-title-attribute>title</a></code> attribute, and the nearest such
attribute has a value that is not the empty string, it is expected
that the user agent will expose the contents of that attribute as a
Received on Thursday, 5 February 2009 09:18:30 UTC