From 80305f8794ca692bc54f80ac60ac9fd09b19d9af Mon Sep 17 00:00:00 2001 From: Ian Hickson Date: Wed, 27 Feb 2008 00:24:14 +0000 Subject: [PATCH] [act] (1) Introduce the concept of 'sectioning root', of which we have four:
, , ,
; stop
from being a sectioning element git-svn-id: http://svn.whatwg.org/webapps@1255 340c8d12-0b0e-0410-8428-c7bf67bfef74 --- index | 221 ++++++++++++++++++++++++++++----------------------------- source | 145 ++++++++++++++++++------------------- 2 files changed, 181 insertions(+), 185 deletions(-) diff --git a/index b/index index bbef2f54e91..ff57405e2f0 100644 --- a/index +++ b/index @@ -24,7 +24,7 @@

HTML 5

-

Working Draft — 26 February +

Working Draft — 27 February 2008

You can take part in this work. 3.8.4 The article element -

  • 3.8.5 The - blockquote element - -
  • 3.8.6 The +
  • 3.8.5 The aside element -
  • 3.8.7 The +
  • 3.8.6 The h1, h2, h3, h4, h5, and h6 elements -
  • 3.8.8 The +
  • 3.8.7 The header element -
  • 3.8.9 The +
  • 3.8.8 The footer element -
  • 3.8.10 The +
  • 3.8.9 The address element -
  • 3.8.11 Headings and +
  • 3.8.10 Headings and sections @@ -487,6 +484,9 @@
  • 3.9.4 The dialog element + +
  • 3.9.5 The + blockquote element
  • 3.10 Preformatted @@ -8409,74 +8409,7 @@ XXX attributes to give the date authored, date published href="#address">address element) does not apply to nested article elements. -

    3.8.5 The blockquote element

    - -
    -
    Categories - -
    Prose content. - -
    Sectioning content. - -
    Contexts in which this element may be used: - -
    Where prose content is expected. - -
    Content model: - -
    Prose content. - -
    Element-specific attributes: - -
    cite - -
    DOM interface: - -
    - 
    interface HTMLQuoteElement : HTMLElement {
-           attribute DOMString cite;
-};
    - -

    The HTMLQuoteElement interface is also - used by the q element.

    -
    - -

    The blockquote element represents - a section that is quoted from another source. - -

    Content inside a blockquote must - be quoted from another source, whose URI, if it has one, should be cited - in the cite - attribute. - -

    If the cite - attribute is present, it must be a URI (or IRI). User agents should allow - users to follow such citation links. - -

    If a blockquote element is preceded or followed by a single paragraph that contains a single cite element and that is itself not preceded or followed by another blockquote element and does not itself have - a q element descendant, then, the title of - the work given by that cite element - gives the source of the quotation contained in the blockquote element. - -

    The cite DOM - attribute reflects the element's cite - content attribte. - -

    The best way to represent a conversation is not with the - cite and blockquote elements, but with the dialog element. - -

    3.8.6 The 3.8.5 The aside element

    @@ -8547,7 +8480,7 @@ isn't his only passion. He also enjoys other pleasures.</p> ... -

    3.8.7 The 3.8.6 The h1, h2, h3, h4, h5, and h6 elements

    @@ -8587,7 +8520,7 @@ isn't his only passion. He also enjoys other pleasures.</p> the highest rank, the h6 element has the lowest rank, and two elements with the same name have equal rank. -

    3.8.8 The 3.8.7 The header element

    @@ -8680,7 +8613,7 @@ isn't his only passion. He also enjoys other pleasures.</p> href="#header">header element is the same as for an h1 element (the highest rank). -
    @@ -8740,7 +8673,7 @@ isn't his only passion. He also enjoys other pleasures.</p> </body> -

    3.8.10 The 3.8.9 The address element

    @@ -8824,7 +8757,7 @@ isn't his only passion. He also enjoys other pleasures.</p> element, does not apply to its ancestor elements, e.g. the page's body. -

    3.8.11 Headings +

    3.8.10 Headings and sections

    The h1-h6 @@ -8837,15 +8770,17 @@ isn't his only passion. He also enjoys other pleasures.</p> href="#rank">rank start new (implied) sections, headers of lower rank start subsections that are part of the previous one. -

    Sectioning content elements other than - blockquote are always considered - subsections of their nearest ancestor element of Sectioning content elements are always + considered subsections of their nearest ancestor element of sectioning content, regardless of what implied - sections other headings may have created. However, blockquote elements are associated - with implied sections. Effectively, blockquote elements act like sections on the - inside, and act opaquely on the outside. + sections other headings may have created. + +

    Certain elements are said to be sectioning roots, including blockquote and td elements. These elements can have their own + outlines, but the sections and headers inside these elements do not + contribute to the outlines of their ancestors.

    For the following fragment:

    @@ -8868,28 +8803,21 @@ isn't his only passion. He also enjoys other pleasures.</p>
    1. Foo (heading of explicit body - section) + section, containing the "Grunt" paragraph)
        -
      1. Bar (heading starting implied section) -
          -
        1. Bla (heading of explicit blockquote section) -
        - Baz (paragraph) +
      2. Bar (heading starting implied section, containing a block quote + and the "Baz" paragraph)
      3. Quux (heading starting implied section)
      4. Thud (heading of explicit section section)
      - Grunt (paragraph)
    -

    Notice how the blockquote nests - inside an implicit section while the section does not (and in fact, ends the - earlier implicit section so that a later paragraph is back at the top - level).

    +

    Notice how the section ends the + earlier implicit section so that a later paragraph ("Grunt") is back at + the top level.

    Sections may contain headers of any rank, but @@ -8941,7 +8869,7 @@ isn't his only passion. He also enjoys other pleasures.</p> produce the same outline in compliant user agents.

    -
    3.8.11.1. Creating an outline
    +
    3.8.10.1. Creating an outline

    This section will be rewritten at some point. The algorithm likely won't change, but its description will be dramatically @@ -9077,7 +9005,7 @@ isn't his only passion. He also enjoys other pleasures.</p> } -

    3.8.11.2. Determining +
    3.8.10.2. Determining which heading and section applies to a particular node

    This section will be rewritten at some point. The @@ -9305,7 +9233,7 @@ isn't his only passion. He also enjoys other pleasures.</p> -

    3.8.11.3. Distinguishing +
    3.8.10.3. Distinguishing site-wide headers from page headers

    Given the hypothetical section tree, but @@ -9606,6 +9534,73 @@ Address: <input name="address"></p> and blockquote elements for other ways to cite or quote. +

    3.9.5 The blockquote element

    + +
    +
    Categories + +
    Prose content. + +
    Sectioning root. + +
    Contexts in which this element may be used: + +
    Where prose content is expected. + +
    Content model: + +
    Prose content. + +
    Element-specific attributes: + +
    cite + +
    DOM interface: + +
    + 
    interface HTMLQuoteElement : HTMLElement {
+           attribute DOMString cite;
+};
    + +

    The HTMLQuoteElement interface is also + used by the q element.

    +
    + +

    The blockquote element represents + a section that is quoted from another source. + +

    Content inside a blockquote must + be quoted from another source, whose URI, if it has one, should be cited + in the cite + attribute. + +

    If the cite + attribute is present, it must be a URI (or IRI). User agents should allow + users to follow such citation links. + +

    If a blockquote element is preceded or followed by a single paragraph that contains a single cite element and that is itself not preceded or followed by another blockquote element and does not itself have + a q element descendant, then, the title of + the work given by that cite element + gives the source of the quotation contained in the blockquote element. + +

    The cite DOM + attribute reflects the element's cite + content attribte. + +

    The best way to represent a conversation is not with the + cite and blockquote elements, but with the dialog element. +

    3.10 Preformatted text

    3.10.1 The rat</b> scurries past the corner wall.</p>
    Prose content. +
    Sectioning root. +
    Contexts in which this element may be used:
    Where prose content is expected. @@ -19919,7 +19916,7 @@ notes on what would need to be defined for dashed lines:
    Categories -
    None. +
    Sectioning root.
    Contexts in which this element may be used: @@ -21617,6 +21614,8 @@ https://www.google.com/base/settings
    Interactive element. +
    Sectioning root. +
    Contexts in which this element may be used:
    Where prose content is expected. diff --git a/source b/source index ec22c926ef6..d139e5cbb78 100644 --- a/source +++ b/source @@ -6787,57 +6787,6 @@ XXX attributes to give the date authored, date published nested article elements.

    -

    The blockquote element

    - -
    -
    Categories
    -
    Prose content.
    -
    Sectioning content.
    -
    Contexts in which this element may be used:
    -
    Where prose content is expected.
    -
    Content model:
    -
    Prose content.
    -
    Element-specific attributes:
    -
    cite
    -
    DOM interface:
    -
    -
    interface HTMLQuoteElement : HTMLElement {
-           attribute DOMString cite;
-};
    -

    The HTMLQuoteElement interface is - also used by the q element.

    -
    -
    - -

    The blockquote element represents a section that is - quoted from another source.

    - -

    Content inside a blockquote must be quoted from - another source, whose URI, if it has one, should be cited in the - cite - attribute.

    - -

    If the cite attribute - is present, it must be a URI (or IRI). User agents should allow - users to follow such citation links.

    - -

    If a blockquote element is preceded or - followed by a single paragraph that contains a - single cite element and that is itself not - preceded or followed by another blockquote - element and does not itself have a q element - descendant, then, the title of the work given by that - cite element gives the source of the quotation - contained in the blockquote element.

    - -

    The cite DOM - attribute reflects the element's cite content attribte. - -

    The best way to represent a conversation is not with - the cite and blockquote elements, but with - the dialog element.

    -

    The aside element

    @@ -7144,17 +7093,18 @@ isn't his only passion. He also enjoys other pleasures.</p> start new (implied) sections, headers of lower rank start subsections that are part of the previous one.

    -

    Sectioning content elements other than - blockquote are always considered subsections of their - nearest ancestor element of sectioning content, - regardless of what implied sections other headings may have created. - However, blockquote elements are associated - with implied sections. Effectively, blockquote elements - act like sections on the inside, and act opaquely on the - outside.

    +

    Sectioning content elements are always considered + subsections of their nearest ancestor element of sectioning + content, regardless of what implied sections other headings + may have created.

    -
    +

    Certain elements are said to be sectioning roots, including blockquote and + td elements. These elements can have their own + outlines, but the sections and headers inside these elements do not + contribute to the outlines of their ancestors.

    +

    For the following fragment:

    <body>
  <h1>Foo</h1>
@@ -7172,16 +7122,10 @@ isn't his only passion. He also enjoys other pleasures.</p>
    
    ...the structure would be:
    
    
      
     
    1. 
-     Foo (heading of explicit body section)
+     Foo (heading of explicit body section, containing the "Grunt" paragraph)
      
        
       
      1. 
-       Bar (heading starting implied section)
-       
          
-        
        1. 
-         Bla (heading of explicit blockquote section)
-        
          2. 
-       
        
-       Baz (paragraph)
+       Bar (heading starting implied section, containing a block quote and the "Baz" paragraph)
       
        2. 
       
      2. 
        Quux (heading starting implied section)
@@ -7190,13 +7134,11 @@ isn't his only passion. He also enjoys other pleasures.</p>
        Thud (heading of explicit section section)
       
        3. 
      
      
-     Grunt (paragraph)
     
      2. 
    
    
-   
    Notice how the blockquote nests inside an implicit
-   section while the section does not (and in fact, ends
-   the earlier implicit section so that a later paragraph is back at
-   the top level).
    
+   
    Notice how the section ends the earlier implicit
+   section so that a later paragraph ("Grunt") is back at the top
+   level.

    Sections may contain headers of any rank, but @@ -7829,6 +7771,59 @@ Address: <input name="address"></p> to cite or quote.

    +

    The blockquote element

    + +
    +
    Categories
    +
    Prose content.
    +
    Sectioning root.
    +
    Contexts in which this element may be used:
    +
    Where prose content is expected.
    +
    Content model:
    +
    Prose content.
    +
    Element-specific attributes:
    +
    cite
    +
    DOM interface:
    +
    +
    interface HTMLQuoteElement : HTMLElement {
+           attribute DOMString cite;
+};
    +

    The HTMLQuoteElement interface is + also used by the q element.

    +
    +
    + +

    The blockquote element represents a section that is + quoted from another source.

    + +

    Content inside a blockquote must be quoted from + another source, whose URI, if it has one, should be cited in the + cite + attribute.

    + +

    If the cite attribute + is present, it must be a URI (or IRI). User agents should allow + users to follow such citation links.

    + +

    If a blockquote element is preceded or + followed by a single paragraph that contains a + single cite element and that is itself not + preceded or followed by another blockquote + element and does not itself have a q element + descendant, then, the title of the work given by that + cite element gives the source of the quotation + contained in the blockquote element.

    + +

    The cite DOM + attribute reflects the element's cite content attribte. + +

    The best way to represent a conversation is not with + the cite and blockquote elements, but with + the dialog element.

    + + +

    Preformatted text

    The pre element

    @@ -10566,6 +10561,7 @@ brighter. A <b>rat</b> scurries past the corner wall.</p>
    Categories
    Prose content.
    +
    Sectioning root.
    Contexts in which this element may be used:
    Where prose content is expected.
    Content model:
    @@ -17401,7 +17397,7 @@ notes on what would need to be defined for dashed lines:
    Categories
    -
    None.
    +
    Sectioning root.
    Contexts in which this element may be used:
    As a child of a tr element.
    Content model:
    @@ -19301,6 +19297,7 @@ https://www.google.com/base/settings
    Categories
    Prose element.
    Interactive element.
    +
    Sectioning root.
    Contexts in which this element may be used:
    Where prose content is expected.
    Content model: