- From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
- Date: Mon, 02 Feb 2009 11:53:19 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/spec In directory hutz:/tmp/cvs-serv23256 Modified Files: Overview.html Log Message: Filling in the rendering section: moving stuff around. (whatwg r2740) Index: Overview.html =================================================================== RCS file: /sources/public/html5/spec/Overview.html,v retrieving revision 1.1909 retrieving revision 1.1910 diff -u -d -r1.1909 -r1.1910 --- Overview.html 2 Feb 2009 11:42:55 -0000 1.1909 +++ Overview.html 2 Feb 2009 11:53:16 -0000 1.1910 @@ -972,8 +972,14 @@ <li><a href=#the-marquee-element><span class=secno>10.4.5 </span>The <code>marquee</code> element</a></li> <li><a href=#the-hr-element-0><span class=secno>10.4.6 </span>The <code>hr</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=#frames><span class=secno>10.4.8 </span>Frames</a></ol></li> - <li><a href=#other><span class=secno>10.5 </span>Other</a></ol></li> + <li><a href=#frames><span class=secno>10.4.8 </span>Frames</a></li> + <li><a href=#images-0><span class=secno>10.4.9 </span>Images</a></li> + <li><a href=#fragment-identifiers><span class=secno>10.4.10 </span>Fragment identifiers</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></ol></li> + <li><a href=#print-media><span class=secno>10.6 </span>Print media</a></li> + <li><a href=#interaction-with-css><span class=secno>10.7 </span>Interaction with CSS</a></ol></li> <li><a href=#obsolete-features><span class=secno>11 </span>Obsolete features</a> <ol> <li><a href=#self-contained-features-0><span class=secno>11.1 </span>Self-contained features</a> @@ -45965,7 +45971,28 @@ </li> - </ol><h2 id=rendering><span class=secno>10 </span>Rendering</h2><p><em>This section all its subsections are non-normative.</em><h3 id=introduction-8><span class=secno>10.1 </span>Introduction</h3><p>User agents are not required present HTML documents in any + </ol><h2 id=rendering><span class=secno>10 </span>Rendering</h2><p><em>This section all its subsections are non-normative.</em></p><!-- XXX + + figure/legend + iframe, embed, object, applet, video, audio, canvas + + Default UI + link: click + mark: skip to next mark element + title attribute: tooltip + cite attribute on q, blockquote, ins, del: on hover, show link + ... + + Define how to determine what element is under the cursor, unless + the CSS group has finally gotten around to defining that before we + get to it + + Extensions to CSS + for drag and drop + for datagrid + ... + +--><h3 id=introduction-8><span class=secno>10.1 </span>Introduction</h3><p>User agents are not required present HTML documents in any particular way. This section merely provides a set of suggestions for rendering HTML documents that, if followed, are likely to lead to a user experience that closely resembles the experience intended @@ -46006,7 +46033,16 @@ tr { display: table-row; } td, th { display: table-cell; } -li { display: list-item; }</pre><!-- XXX ruby, rt, rp --><!-- del, ins, and map are inline. --><p>For the purposes of the CSS table model, the <code><a href=#the-col-element>col</a></code> +li { display: list-item; }</pre><!-- XXX ruby, rt, rp + > * note on rt rendering + > + > Since there are a number of documents with ruby but without rp, when you + > write the rendering section, please include an advice for user agents + > that do not support "correct" ruby rendering to render something like + > "(" 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. + --><!-- del, ins, and map are inline. --><p>For the purposes of the CSS table model, the <code><a href=#the-col-element>col</a></code> element is to be treated as if it was present as many times as its <code title=attr-col-span><a href=#attr-col-span>span</a></code> attribute <a href=#rules-for-parsing-non-negative-integers title="rules for parsing non-negative integers">specifies</a>.<p>For the purposes of the CSS table model, the @@ -46215,45 +46251,27 @@ <!-- XXX button, select, textarea, bb --> - </dl><p class=XXX>...<h4 id=the-datagrid-element><span class=secno>10.4.3 </span>The <code><a href=#datagrid>datagrid</a></code> element</h4><p class=XXX>...<h4 id=rendering-and-menus-toolbars><span class=secno>10.4.4 </span>Rendering and menus/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 + </dl><p class=XXX>...<h4 id=the-datagrid-element><span class=secno>10.4.3 </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=rendering-and-menus-toolbars><span class=secno>10.4.4 </span>Rendering and menus/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-marquee-element><span class=secno>10.4.5 </span>The <code><a href=#the-marquee-element-0>marquee</a></code> element</h4><p class=XXX>...<h4 id=the-hr-element-0><span class=secno>10.4.6 </span>The <code><a href=#the-hr-element>hr</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>...<h4 id=frames><span class=secno>10.4.8 </span>Frames</h4><p class=XXX>...<h3 id=other><span class=secno>10.5 </span>Other</h3><!-- XXX - - figure/legend - iframe, embed, object, applet, video, audio, canvas - - Default UI - link: click - mark: skip to next mark element - title attribute: tooltip - cite attribute on q, blockquote, ins, del: on hover, show link - ... - - Define how to determine what element is under the cursor, unless - the CSS group has finally gotten around to defining that before we - get to it - - Extensions to CSS - for drag and drop - for datagrid - ... - -> * note on rt rendering -> -> Since there are a number of documents with ruby but without rp, when you -> write the rendering section, please include an advice for user agents -> that do not support "correct" ruby rendering to render something like -> "(" 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. - - img - how to handle alt text, img in link (no border)... Define - that either the src="" is shown (as an image) or the alt="" is - shown (inline) but should not ever have both at once. + that image instead.<h4 id=the-marquee-element><span class=secno>10.4.5 </span>The <code><a href=#the-marquee-element-0>marquee</a></code> element</h4><p class=XXX>...<h4 id=the-hr-element-0><span class=secno>10.4.6 </span>The <code><a href=#the-hr-element>hr</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>...<h4 id=frames><span class=secno>10.4.8 </span>Frames</h4><p class=XXX>...<h4 id=images-0><span class=secno>10.4.9 </span>Images</h4><p class=XXX>...</p><!-- + img - how to handle alt text, img in link (no border)... Define + that either the src="" is shown (as an image) or the alt="" is + shown (inline) but should not ever have both at once. + --><p class=XXX>Terms that need to be defined include: <dfn id=sizing-of-embedded-content>sizing + of embedded content</dfn><h4 id=fragment-identifiers><span class=secno>10.4.10 </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? --><h3 id=interactive-media><span class=secno>10.5 </span>Interactive media</h3><h4 id=hit-testing><span class=secno>10.5.1 </span>Hit testing</h4><p class=XXX>this should really be in a CSS spec -- hot to decide + which element is under the cursor --> +<!-- HIT TESTING TRANSPARENCY @@ -46315,37 +46333,14 @@ I. The event goes to X. STOP - --><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. Terms that need to be defined include: <dfn id=sizing-of-embedded-content>sizing - of embedded content</dfn><p>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>Section headers</h4> - - <p>For <code>h1</code> elements, CSS-aware visual user agents should - derive the size of the header from the level of <code>section</code> - nesting. This effect should be achieved by including the following - rules, or their equivalent, in the UA's user agent style sheet:</p> - - <pre>@namespace xh url(http://www.w3.org/1999/xhtml); -xh|section xh|h1 { /* same styles as h2 */ } -xh|section xh|section xh|h1 { /* same styles as h4 */ } -xh|section xh|section xh|section xh|h1 { /* same styles as h4 */ } -xh|section xh|section xh|section xh|section xh|h1 { /* same styles as h5 */ } -xh|section xh|section xh|section xh|section xh|section xh|h1 { /* same styles as h6 */ }</pre> + --> - <p>Authors should use <code>h1</code> elements to denote headers in - sections. Authors may instead use <code>h2</code> ... - <code>h6</code> elements, for backwards compatibility with user - agents that do not support <code>section</code> elements.</p> ---><p class=XXX> must define letting the user "<dfn id=obtain-a-physical-form>obtain a + <h3 id=print-media><span class=secno>10.6 </span>Print media</h3><p class=XXX> must define letting the user "<dfn id=obtain-a-physical-form>obtain a physical form</dfn> (or a representation of a physical form)" of a document (printing) and what this means for the UA, in particular - creating a new view for the print media.<p class=XXX>Must define that in CSS, tag and attribute + creating a new view for the print media.<h3 id=interaction-with-css><span class=secno>10.7 </span>Interaction with CSS</h3><!-- XXX this should be normative, so we'll have to move it out of + this section --><p class=XXX>Must define that in CSS, tag and attribute names in HTML documents, and class names in quirks mode documents, are case-insensitive, as well as saying which attribute values must be compared case-insensitively.<h2 id=obsolete-features><span class=secno>11 </span>Obsolete features</h2><p>Authors and documents must not use the features listed in this
Received on Monday, 2 February 2009 11:53:31 UTC