W3C home > Mailing lists > Public > public-html-diffs@w3.org > February 2009

spec/Overview.html 1.1921 2751 Filling in the rendering section: color-

From: poot <cvsmail@w3.org>
Date: Wed, 4 Feb 2009 19:46:59 +0900 (JST)
To: public-html-diffs@w3.org
Message-Id: <20090204104659.770E42BC1B@toro.w3.mag.keio.ac.jp>

Filling in the rendering section: color-related presentational hints;
fixes for previous checkin. (whatwg r2751)

maps to the dimension property
http://people.w3.org/mike/diffs/html5/spec/Overview.1.1921.html#maps-to-the-dimension-property
2.4.3.5 Percentages and lengths
http://people.w3.org/mike/diffs/html5/spec/Overview.1.1921.html#percentages-and-dimensions
rules for parsing dimension values
http://people.w3.org/mike/diffs/html5/spec/Overview.1.1921.html#rules-for-parsing-dimension-values
container frame element
http://people.w3.org/mike/diffs/html5/spec/Overview.1.1921.html#container-frame-element
2.4.6 Space-separated tokens
http://people.w3.org/mike/diffs/html5/spec/Overview.1.1921.html#space-separated-tokens
find a number
http://people.w3.org/mike/diffs/html5/spec/Overview.1.1921.html#find-a-number
maps to the pixel length property
http://people.w3.org/mike/diffs/html5/spec/Overview.1.1921.html#maps-to-the-pixel-length-property
presentational hints
http://people.w3.org/mike/diffs/html5/spec/Overview.1.1921.html#presentational-hints
10.3.5 Fonts and colors
http://people.w3.org/mike/diffs/html5/spec/Overview.1.1921.html#fonts-and-colors
rules for serialising simple color values
http://people.w3.org/mike/diffs/html5/spec/Overview.1.1921.html#rules-for-serialising-simple-color-values
rules for parsing a legacy color value
http://people.w3.org/mike/diffs/html5/spec/Overview.1.1921.html#rules-for-parsing-a-legacy-color-value
10.3.2 Display types
http://people.w3.org/mike/diffs/html5/spec/Overview.1.1921.html#display-types

http://people.w3.org/mike/diffs/html5/spec/Overview.diff.html
http://dev.w3.org/cvsweb/html5/spec/Overview.html?r1=1.1920&r2=1.1921&f=h
http://html5.org/tools/web-apps-tracker?from=2750&to=2751

===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.1920
retrieving revision 1.1921
diff -u -d -r1.1920 -r1.1921
--- Overview.html	4 Feb 2009 10:09:34 -0000	1.1920
+++ Overview.html	4 Feb 2009 10:43:55 -0000	1.1921
@@ -2124,18 +2124,24 @@
 
    <li>Return <var title="">number</var>.</li>
 
-  </ol><h5 id=percentages-and-dimensions><span class=secno>2.4.3.5 </span>Percentages and lengths</h5><p>A string is a <dfn id=valid-dimension-value>valid dimension value</dfn> if it consists of
+  </ol><h5 id=percentages-and-dimensions><span class=secno>2.4.3.5 </span>Percentages and lengths</h5><!--(percentages are not used in html5)
+  <p>A string is a <dfn>valid dimension value</dfn> if it consists of
   a character in the range U+0031 DIGIT ONE (1) to U+0039 DIGIT NINE
   (9), optionally followed by zero of more characters in the range
   U+0030 DIGIT ZERO (0) to U+0039 DIGIT NINE (9), optionally followed
   by a U+002E FULL STOP character (.) and one of more characters in
   the range U+0030 DIGIT ZERO (0) to U+0039 DIGIT NINE (9), and
-  optionally suffixed by a U+0025 PERCENT SIGN character (%).<p>A <a href=#valid-dimension-value>valid dimension value</a> represents the number that
+  optionally suffixed by a U+0025 PERCENT SIGN character (%).</p>
+
+  <p>A <span>valid dimension value</span> represents the number that
   is represented in base ten by that string of digits, optionally with
   a fractional component. If the U+0025 PERCENT SIGN is present, then
-  the dimension is a percentage; otherwise, it is a length.<p class=note>For historical reasons, percentanges and lengths
-  less than 1.0 cannot be represented as <a href=#valid-dimension-value title="valid dimension
-  value">valid dimension values</a>.<p>The <dfn id=rules-for-parsing-dimension-values>rules for parsing dimension values</dfn> are as given in
+  the dimension is a percentage; otherwise, it is a length.</p>
+
+  <p class="note">For historical reasons, percentanges and lengths
+  less than 1.0 cannot be represented as <span title="valid dimension
+  value">valid dimension values</span>.</p>
+--><p>The <dfn id=rules-for-parsing-dimension-values>rules for parsing dimension values</dfn> are as given in
   the following algorithm. When invoked, the steps must be followed in
   the order given, aborting at the first step that returns a
   value. This algorithm will either return a number greater than or
@@ -2193,9 +2199,6 @@
 
     </ol></li>
 
-   <li><p><a href=#collect-a-sequence-of-characters>Collect a sequence of characters</a> that are
-   U+0030 DIGIT ZERO (0) characters, and discard them.</li>
-
    <li><p>If <var title="">position</var> is past the end of <var title="">input</var>, return <var title="">value</var> as a
    length.</li>
 
@@ -3144,10 +3147,16 @@
    <li><p>Return <var title="">result</var>, which will be a
    <a href=#valid-lowercase-simple-color>valid lowercase simple color</a>.</li>
 
-  </ol><p class=note>The <a href=#canvas-context-2d title=canvas-context-2d>2D graphics
+  </ol><hr><p>Some obsolete legacy attributes parse colors in a more
+  complicated manner, using the <dfn id=rules-for-parsing-a-legacy-color-value>rules for parsing a legacy color
+  value</dfn>, which are given in the following algorithm. When
+  invoked, the steps must be followed in the order given, aborting at
+  the first step that returns a value. This algorithm will either
+  return a <a href=#simple-color>simple color</a> or an error.<ol class=XXX><li>...
+
+  </ol><hr><p class=note>The <a href=#canvas-context-2d title=canvas-context-2d>2D graphics
   context</a> has a separate color syntax that also handles
-  opacity.<p class=note>Some obsolete legacy attributes parse colors in a
-  more complicated manner.<h4 id=space-separated-tokens><span class=secno>2.4.6 </span>Space-separated tokens</h4><p>A <dfn id=set-of-space-separated-tokens>set of space-separated tokens</dfn> is a set of zero or
+  opacity.<h4 id=space-separated-tokens><span class=secno>2.4.6 </span>Space-separated tokens</h4><p>A <dfn id=set-of-space-separated-tokens>set of space-separated tokens</dfn> is a set of zero or
   more words separated by one or more <a href=#space-character title="space
   character">space characters</a>, where words consist of any
   string of one or more characters, none of which are <a href=#space-character title="space character">space characters</a>.<p>A string containing a <a href=#set-of-space-separated-tokens>set of space-separated tokens</a>
@@ -46099,20 +46108,7 @@
   appropriate for elements whose 'direction' property is 'ltr', and
   are expected to be flipped around on elements whose 'direction'
   property is 'rtl'.<p class=XXX>Please send feedback if you can accurately describe
-  rules required by legacy content.<p>When the text below says that an attribute <var title="">attribute</var> on an element <var title="">element</var>
-  <dfn id=maps-to-the-pixel-length-property>maps to the pixel length property</dfn> (or properties) <var title="">properties</var>, it means that if <var title="">element</var> has an attribute <var title="">attribute</var> set, and parsing that attribute's value
-  using the <a href=#rules-for-parsing-non-negative-integers>rules for parsing non-negative integers</a>
-  doesn't generate an error, then the user agent is expected to use
-  the parsed value as a pixel length for a <a href=#presentational-hints title="presentational
-  hints">presentational hint</a> for <var title="">property</var>.<p>When the text below says that an attribute <var title="">attribute</var> on an element <var title="">element</var>
-  <dfn id=maps-to-the-dimension-property>maps to the dimension property</dfn> (or properties) <var title="">properties</var>, it means that if <var title="">element</var> has an attribute <var title="">attribute</var> set, and parsing that attribute's value
-  using the <a href=#rules-for-parsing-dimension-values>rules for parsing dimension values</a> doesn't
-  generate an error, then the user agent is expected to use the parsed
-  dimension as the value for a <a href=#presentational-hints title="presentational
-  hints">presentational hint</a> for <var title="">property</var>,
-  with the value given as a pixel length if the dimension was an
-  integer, and with the value given as a percentage if the dimension
-  was a percentage.<h4 id=display-types><span class=secno>10.3.2 </span>Display types</h4><pre class=css>@namespace url(http://www.w3.org/1999/xhtml);
+  rules required by legacy content.<h4 id=display-types><span class=secno>10.3.2 </span>Display types</h4><pre class=css>@namespace url(http://www.w3.org/1999/xhtml);
 
 address, article, aside, blockquote, body, center, dd, dialog, dir,
 div, dl, dt, figure, footer, form, h1, h2, h3, h4, h5, h6, header, hr,
@@ -46194,7 +46190,19 @@
   <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>When the text below says that an attribute <var title="">attribute</var> on an element <var title="">element</var>
+  <dfn id=maps-to-the-pixel-length-property>maps to the pixel length property</dfn> (or properties) <var title="">properties</var>, it means that if <var title="">element</var> has an attribute <var title="">attribute</var> set, and parsing that attribute's value
+  using the <a href=#rules-for-parsing-non-negative-integers>rules for parsing non-negative integers</a>
+  doesn't generate an error, then the user agent is expected to use
+  the parsed value as a pixel length for a <a href=#presentational-hints title="presentational
+  hints">presentational hint</a> for <var title="">properties</var>.<p>When the text below says that an attribute <var title="">attribute</var> on an element <var title="">element</var>
+  <dfn id=maps-to-the-dimension-property>maps to the dimension property</dfn> (or properties) <var title="">properties</var>, it means that if <var title="">element</var> has an attribute <var title="">attribute</var> set, and parsing that attribute's value
+  using the <a href=#rules-for-parsing-dimension-values>rules for parsing dimension values</a> doesn't
+  generate an error, then the user agent is expected to use the parsed
+  dimension as the value for a <a href=#presentational-hints title="presentational
+  hints">presentational hint</a> for <var title="">properties</var>, with the value given as a pixel length if
+  the dimension was an integer, and with the value given as a
+  percentage if the dimension was a percentage.</p><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',
@@ -46335,7 +46343,50 @@
 <var title="">x</var> <var title="">x</var> h1 { font-size: 1.17em; }
 <var title="">x</var> <var title="">x</var> <var title="">x</var> h1 { font-size: 1.00em; }
 <var title="">x</var> <var title="">x</var> <var title="">x</var> <var title="">x</var> h1 { font-size: 0.83em; }
-<var title="">x</var> <var title="">x</var> <var title="">x</var> <var title="">x</var> <var title="">x</var> h1 { font-size: 0.67em; }</pre><hr><p class=XXX>...background...</p><!-- body, table, td, th, tbody, tfoot, thead, tr: background (empty string ignored?), bgcolor --><hr><p class=XXX>...body...</p><!--link, vlink, alink, text --><hr><p class=XXX>...tables...</p><!-- table: bordercolor --><hr><p class=XXX>...font...</p><!-- face=>font-family --><!-- pointsize=>font-size as pt if present;
+<var title="">x</var> <var title="">x</var> <var title="">x</var> <var title="">x</var> <var title="">x</var> h1 { font-size: 0.67em; }</pre><hr><p>When a <code><a href=#the-body-element>body</a></code>, <code><a href=#the-table-element>table</a></code>, <code><a href=#the-thead-element>thead</a></code>,
+  <code><a href=#the-tbody-element>tbody</a></code>, <code><a href=#the-tfoot-element>tfoot</a></code>, <code><a href=#the-tr-element>tr</a></code>,
+  <code><a href=#the-td-element>td</a></code>, or <code><a href=#the-th-element>th</a></code> element has a <code title=attr-background>background</code> attribute set to a
+  non-empty value, the new value is expected to be <a href=#resolve-a-url title="resolve a url">resolved</a> relative to the element, and
+  if this is successful, the user agent is expected to treat the
+  attribute as a <a href=#presentational-hints title="presentational hints">presentational
+  hint</a> setting the element's 'background-image' property to the
+  resulting <a href=#absolute-url>absolute URL</a>.<p>When a <code><a href=#the-body-element>body</a></code>, <code><a href=#the-table-element>table</a></code>, <code><a href=#the-thead-element>thead</a></code>,
+  <code><a href=#the-tbody-element>tbody</a></code>, <code><a href=#the-tfoot-element>tfoot</a></code>, <code><a href=#the-tr-element>tr</a></code>,
+  <code><a href=#the-td-element>td</a></code>, or <code><a href=#the-th-element>th</a></code> element has a <code title=attr-bgcolor>bgcolor</code> attribute set, the new value is
+  expected to be parsed using the <a href=#rules-for-parsing-a-legacy-color-value>rules for parsing a legacy
+  color value</a>, and the user agent is expected to treat the
+  attribute as a <a href=#presentational-hints title="presentational hints">presentational
+  hint</a> setting the element's 'background-color' property to the
+  resulting color.<p>When a <code><a href=#the-body-element>body</a></code> element has a <code title=attr-body-text><a href=#attr-body-text>text</a></code> attribute, its value is expected
+  to be parsed using the <a href=#rules-for-parsing-a-legacy-color-value>rules for parsing a legacy color
+  value</a>, and the user agent is expected to treat the attribute
+  as a <a href=#presentational-hints title="presentational hints">presentational hint</a>
+  setting the element's 'color' property to the resulting color.<p>When a <code><a href=#the-body-element>body</a></code> element has a <code title=attr-body-link><a href=#attr-body-link>link</a></code> attribute, its value is expected
+  to be parsed using the <a href=#rules-for-parsing-a-legacy-color-value>rules for parsing a legacy color
+  value</a>, and the user agent is expected to treat the attribute
+  as a <a href=#presentational-hints title="presentational hints">presentational hint</a>
+  setting the 'color' property of any element in the
+  <code>Document</code> matching the ':link' pseudo-class to the
+  resulting color.<p>When a <code><a href=#the-body-element>body</a></code> element has a <code title=attr-body-vlink><a href=#attr-body-vlink>vlink</a></code> attribute, its value is
+  expected to be parsed using the <a href=#rules-for-parsing-a-legacy-color-value>rules for parsing a legacy
+  color value</a>, and the user agent is expected to treat the
+  attribute as a <a href=#presentational-hints title="presentational hints">presentational
+  hint</a> setting the 'color' property of any element in the
+  <code>Document</code> matching the ':visited' pseudo-class to the
+  resulting color.<p>When a <code><a href=#the-body-element>body</a></code> element has a <code title=attr-body-alink><a href=#attr-body-alink>alink</a></code> attribute, its value is
+  expected to be parsed using the <a href=#rules-for-parsing-a-legacy-color-value>rules for parsing a legacy
+  color value</a>, and the user agent is expected to treat the
+  attribute as a <a href=#presentational-hints title="presentational hints">presentational
+  hint</a> setting the 'color' property of any element in the
+  <code>Document</code> matching the ':active' pseudo-class and either
+  the ':link' pseudo-class or the ':visited' pseudo-class to the
+  resulting color.<p>When a <code><a href=#the-table-element>table</a></code> element has a <code title=attr-table-bordercolor>bordercolor</code> attribute, its
+  value is expected to be parsed using the <a href=#rules-for-parsing-a-legacy-color-value>rules for parsing a
+  legacy color value</a>, and the user agent is expected to treat
+  the attribute as a <a href=#presentational-hints title="presentational hints">presentational
+  hint</a> setting the element's 'border-top-color',
+  'border-right-color', 'border-bottom-color', and
+  'border-right-color' properties to the resulting color.</p><hr><p class=XXX>...font...</p><!-- face=>font-family --><!-- pointsize=>font-size as pt if present;
        otherwise size=>font-size as follows:
         int <0: as x-small
         int >7: as xx-large
Received on Wednesday, 4 February 2009 10:47:36 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Saturday, 18 December 2010 06:13:58 GMT