[html5] r3069 - [ac] (0) Add cite='' attribute to <section> and <article>.

whatwg at whatwg.org whatwg at whatwg.org
Wed May 6 16:07:39 PDT 2009


Author: ianh
Date: 2009-05-06 16:07:38 -0700 (Wed, 06 May 2009)
New Revision: 3069

Modified:
   index
   source
Log:
[ac] (0) Add cite='' attribute to <section> and <article>.

Modified: index
===================================================================
--- index	2009-05-04 06:10:31 UTC (rev 3068)
+++ index	2009-05-06 23:07:38 UTC (rev 3069)
@@ -39,7 +39,7 @@
   <div class=head>
    <p><a class=logo href=http://www.whatwg.org/ rel=home><img alt=WHATWG src=/images/logo></a></p>
    <h1>HTML 5</h1>
-   <h2 class="no-num no-toc" id=draft-recommendation-—-date:-01-jan-1901>Draft Recommendation — 4 May 2009</h2>
+   <h2 class="no-num no-toc" id=draft-recommendation-—-date:-01-jan-1901>Draft Recommendation — 6 May 2009</h2>
    <p>You can take part in this work. <a href=http://www.whatwg.org/mailing-list>Join the working group's discussion list.</a></p>
    <p><strong>Web designers!</strong> We have a <a href=http://blog.whatwg.org/faq/>FAQ</a>, a <a href=http://forums.whatwg.org/>forum</a>, and a <a href=http://www.whatwg.org/mailing-list#help>help mailing list</a> for you!</p>
    <dl><dt>Multiple-page version:</dt>
@@ -4721,8 +4721,10 @@
 
    </dd>
 
-   <dt>If the element is a <code><a href=#the-blockquote-element>blockquote</a></code>, <code><a href=#the-q-element>q</a></code>,
-   <code><a href=#the-ins-element>ins</a></code>, or <code><a href=#the-del-element>del</a></code> element with a <code title="">cite</code> attribute</dt>
+   <dt>If the element is a <code><a href=#the-q-element>q</a></code>, <code><a href=#the-blockquote-element>blockquote</a></code>,
+   <code><a href=#the-section-element>section</a></code>, <code><a href=#the-article-element>article</a></code>, <code><a href=#the-ins-element>ins</a></code>, or
+   <code><a href=#the-del-element>del</a></code> element with a <code title="">cite</code>
+   attribute</dt>
 
    <dd>
 
@@ -12142,8 +12144,13 @@
    <dd><a href=#flow-content-0>Flow content</a>.</dd>
    <dt>Content attributes:</dt>
    <dd><a href=#global-attributes>Global attributes</a></dd>
+   <dd><code title=attr-section-cite><a href=#attr-section-cite>cite</a></code></dd>
    <dt>DOM interface:</dt>
-   <dd>Uses <code><a href=#htmlelement>HTMLElement</a></code>.</dd>
+   <dd>
+<pre class=idl>interface <dfn id=htmlsectionelement>HTMLSectionElement</dfn> : <a href=#htmlelement>HTMLElement</a> {
+           attribute DOMString <a href=#dom-section-cite title=dom-section-cite>cite</a>;
+};</pre>
+   </dd>
   </dl><p>The <code><a href=#the-section-element>section</a></code> element <a href=#represents>represents</a> a
   generic document or application section. A section, in this context,
   is a thematic grouping of content, typically with a heading, possibly
@@ -12154,6 +12161,23 @@
   sections of a thesis. A Web site's home page could be split into
   sections for an introduction, news items, contact information.</p>
 
+  <p>The <dfn id=attr-section-cite title=attr-section-cite><code>cite</code></dfn>
+  attribute may be used if the content of the section was taken from
+  another page (e.g. syndicating content from multiple sources on one
+  page). The attribute, if present, must contain a <a href=#valid-url>valid
+  URL</a> referencing the original source. <span class=impl>To
+  obtain the corresponding citation link, the value of the attribute
+  must be <a href=#resolve-a-url title="resolve a url">resolved</a> relative to the
+  element. User agents should allow users to follow such citation
+  links.</span></p>
+
+  <div class=impl>
+
+  <p>The <dfn id=dom-section-cite title=dom-section-cite><code>cite</code></dfn> DOM
+  attribute must <a href=#reflect>reflect</a> the element's <code title=attr-section-cite><a href=#attr-section-cite>cite</a></code> content attribute.</p>
+
+  </div>
+
   <div class=example>
 
    <p>In the following example, we see an article (part of a larger
@@ -12254,11 +12278,14 @@
    <dd><a href=#flow-content-0>Flow content</a>.</dd>
    <dt>Content attributes:</dt>
    <dd><a href=#global-attributes>Global attributes</a></dd>
-<!--
-XXX attributes to give the date authored, date published
--->
+   <dd><code title=attr-article-cite><a href=#attr-article-cite>cite</a></code></dd>
+   <!-- v2 attributes to give the date authored, date published, name of author, etc -->
    <dt>DOM interface:</dt>
-   <dd>Uses <code><a href=#htmlelement>HTMLElement</a></code>.</dd>
+   <dd>
+<pre class=idl>interface <dfn id=htmlarticleelement>HTMLArticleElement</dfn> : <a href=#htmlelement>HTMLElement</a> {
+           attribute DOMString <a href=#dom-article-cite title=dom-article-cite>cite</a>;
+};</pre>
+   </dd>
   </dl><p>The <code><a href=#the-article-element>article</a></code> element <a href=#represents>represents</a> a
   section of a page that consists of a composition that forms an
   independent part of a document, page, or site. This could be a forum
@@ -12270,9 +12297,7 @@
   that its contents could stand alone, for example in syndication.
   However, the element is still associated with its ancestors; for
   instance, contact information that <a href=#applyToSection>applies</a> to a parent <code><a href=#the-body-element>body</a></code>
-  element still covers the <code><a href=#the-article-element>article</a></code> as well.</p> <!-- XXX
-  or should we apply the rules in the last paragraph to all articles?
-  -->
+  element still covers the <code><a href=#the-article-element>article</a></code> as well.</p>
 
   <p>When <code><a href=#the-article-element>article</a></code> elements are nested, the inner
   <code><a href=#the-article-element>article</a></code> elements represent articles that are in
@@ -12286,8 +12311,25 @@
   element (q.v. the <code><a href=#the-address-element>address</a></code> element) does not apply to
   nested <code><a href=#the-article-element>article</a></code> elements.</p>
 
+  <p>The <dfn id=attr-article-cite title=attr-article-cite><code>cite</code></dfn>
+  attribute may be used if the content of the article was taken from
+  another page (e.g. syndicating content from multiple sources on one
+  page). The attribute, if present, must contain a <a href=#valid-url>valid
+  URL</a> referencing the original source. <span class=impl>To
+  obtain the corresponding citation link, the value of the attribute
+  must be <a href=#resolve-a-url title="resolve a url">resolved</a> relative to the
+  element. User agents should allow users to follow such citation
+  links.</span></p>
 
+  <div class=impl>
 
+  <p>The <dfn id=dom-article-cite title=dom-article-cite><code>cite</code></dfn> DOM
+  attribute must <a href=#reflect>reflect</a> the element's <code title=attr-article-cite><a href=#attr-article-cite>cite</a></code> content attribute.</p>
+
+  </div>
+
+
+
   <h4 id=the-aside-element><span class=secno>4.4.5 </span>The <dfn><code>aside</code></dfn> element</h4>
 
   <dl class=element><dt>Categories</dt>
@@ -16621,16 +16663,13 @@
   pointing to the specific part of that document that discusses the
   change.</p>
 
-  <div class=impl>
-
   <p>If the <code title=attr-mod-cite><a href=#attr-mod-cite>cite</a></code> attribute is
   present, it must be a <a href=#valid-url>valid URL</a> that explains the
-  change. To obtain the corresponding citation link, the value of the
-  attribute must be <a href=#resolve-a-url title="resolve a url">resolved</a>
-  relative to the element. User agents should allow users to follow
-  such citation links.</p>
+  change. <span class=impl>To obtain the corresponding citation
+  link, the value of the attribute must be <a href=#resolve-a-url title="resolve a
+  url">resolved</a> relative to the element. User agents should
+  allow users to follow such citation links.</span></p>
 
-  </div>
 
   <p>The <dfn id=attr-mod-datetime title=attr-mod-datetime><code>datetime</code></dfn>
   attribute may be used to specify the time and date of the change.</p>
@@ -64403,8 +64442,8 @@
   <p>User agents are expected to allow users to <a href=#navigate>navigate</a>
   <a href=#browsing-context title="browsing context">browsing contexts</a> to the
   resources <a href=#resolve-a-url title="resolve a url">indicated</a> by the <code title="">cite</code> attributes on <code><a href=#the-q-element>q</a></code>,
-  <code><a href=#the-blockquote-element>blockquote</a></code>, <code><a href=#the-ins-element>ins</a></code>, and <code><a href=#the-del-element>del</a></code>
-  elements.</p>
+  <code><a href=#the-blockquote-element>blockquote</a></code>, <code><a href=#the-section-element>section</a></code>, <code><a href=#the-article-element>article</a></code>,
+  <code><a href=#the-ins-element>ins</a></code>, and <code><a href=#the-del-element>del</a></code> elements.</p>
 
   <p>User agents are expected to surface <a href=#hyperlink title=hyperlink>hyperlinks</a> created by <code><a href=#the-link-element>link</a></code>
   elements in their user interface.</p>

Modified: source
===================================================================
--- source	2009-05-04 06:10:31 UTC (rev 3068)
+++ source	2009-05-06 23:07:38 UTC (rev 3069)
@@ -4378,9 +4378,10 @@
 
    </dd>
 
-   <dt>If the element is a <code>blockquote</code>, <code>q</code>,
-   <code>ins</code>, or <code>del</code> element with a <code
-   title="">cite</code> attribute</dt>
+   <dt>If the element is a <code>q</code>, <code>blockquote</code>,
+   <code>section</code>, <code>article</code>, <code>ins</code>, or
+   <code>del</code> element with a <code title="">cite</code>
+   attribute</dt>
 
    <dd>
 
@@ -12971,8 +12972,13 @@
    <dd><span>Flow content</span>.</dd>
    <dt>Content attributes:</dt>
    <dd><span>Global attributes</span></dd>
+   <dd><code title="attr-section-cite">cite</code></dd>
    <dt>DOM interface:</dt>
-   <dd>Uses <code>HTMLElement</code>.</dd>
+   <dd>
+<pre class="idl">interface <dfn>HTMLSectionElement</dfn> : <span>HTMLElement</span> {
+           attribute DOMString <span title="dom-section-cite">cite</span>;
+};</pre>
+   </dd>
   </dl>
 
   <p>The <code>section</code> element <span>represents</span> a
@@ -12985,6 +12991,24 @@
   sections of a thesis. A Web site's home page could be split into
   sections for an introduction, news items, contact information.</p>
 
+  <p>The <dfn title="attr-section-cite"><code>cite</code></dfn>
+  attribute may be used if the content of the section was taken from
+  another page (e.g. syndicating content from multiple sources on one
+  page). The attribute, if present, must contain a <span>valid
+  URL</span> referencing the original source. <span class="impl">To
+  obtain the corresponding citation link, the value of the attribute
+  must be <span title="resolve a url">resolved</span> relative to the
+  element. User agents should allow users to follow such citation
+  links.</span></p>
+
+  <div class="impl">
+
+  <p>The <dfn title="dom-section-cite"><code>cite</code></dfn> DOM
+  attribute must <span>reflect</span> the element's <code
+  title="attr-section-cite">cite</code> content attribute.</p>
+
+  </div>
+
   <div class="example">
 
    <p>In the following example, we see an article (part of a larger
@@ -13089,11 +13113,14 @@
    <dd><span>Flow content</span>.</dd>
    <dt>Content attributes:</dt>
    <dd><span>Global attributes</span></dd>
-<!--
-XXX attributes to give the date authored, date published
--->
+   <dd><code title="attr-article-cite">cite</code></dd>
+   <!-- v2 attributes to give the date authored, date published, name of author, etc -->
    <dt>DOM interface:</dt>
-   <dd>Uses <code>HTMLElement</code>.</dd>
+   <dd>
+<pre class="idl">interface <dfn>HTMLArticleElement</dfn> : <span>HTMLElement</span> {
+           attribute DOMString <span title="dom-article-cite">cite</span>;
+};</pre>
+   </dd>
   </dl>
 
   <p>The <code>article</code> element <span>represents</span> a
@@ -13108,9 +13135,7 @@
   However, the element is still associated with its ancestors; for
   instance, contact information that <a
   href="#applyToSection">applies</a> to a parent <code>body</code>
-  element still covers the <code>article</code> as well.</p> <!-- XXX
-  or should we apply the rules in the last paragraph to all articles?
-  -->
+  element still covers the <code>article</code> as well.</p>
 
   <p>When <code>article</code> elements are nested, the inner
   <code>article</code> elements represent articles that are in
@@ -13124,8 +13149,26 @@
   element (q.v. the <code>address</code> element) does not apply to
   nested <code>article</code> elements.</p>
 
+  <p>The <dfn title="attr-article-cite"><code>cite</code></dfn>
+  attribute may be used if the content of the article was taken from
+  another page (e.g. syndicating content from multiple sources on one
+  page). The attribute, if present, must contain a <span>valid
+  URL</span> referencing the original source. <span class="impl">To
+  obtain the corresponding citation link, the value of the attribute
+  must be <span title="resolve a url">resolved</span> relative to the
+  element. User agents should allow users to follow such citation
+  links.</span></p>
 
+  <div class="impl">
 
+  <p>The <dfn title="dom-article-cite"><code>cite</code></dfn> DOM
+  attribute must <span>reflect</span> the element's <code
+  title="attr-article-cite">cite</code> content attribute.</p>
+
+  </div>
+
+
+
   <h4>The <dfn><code>aside</code></dfn> element</h4>
 
   <dl class="element">
@@ -17837,16 +17880,13 @@
   pointing to the specific part of that document that discusses the
   change.</p>
 
-  <div class="impl">
-
   <p>If the <code title="attr-mod-cite">cite</code> attribute is
   present, it must be a <span>valid URL</span> that explains the
-  change. To obtain the corresponding citation link, the value of the
-  attribute must be <span title="resolve a url">resolved</span>
-  relative to the element. User agents should allow users to follow
-  such citation links.</p>
+  change. <span class="impl">To obtain the corresponding citation
+  link, the value of the attribute must be <span title="resolve a
+  url">resolved</span> relative to the element. User agents should
+  allow users to follow such citation links.</span></p>
 
-  </div>
 
   <p>The <dfn title="attr-mod-datetime"><code>datetime</code></dfn>
   attribute may be used to specify the time and date of the change.</p>
@@ -75599,8 +75639,8 @@
   <span title="browsing context">browsing contexts</span> to the
   resources <span title="resolve a url">indicated</span> by the <code
   title="">cite</code> attributes on <code>q</code>,
-  <code>blockquote</code>, <code>ins</code>, and <code>del</code>
-  elements.</p>
+  <code>blockquote</code>, <code>section</code>, <code>article</code>,
+  <code>ins</code>, and <code>del</code> elements.</p>
 
   <p>User agents are expected to surface <span
   title="hyperlink">hyperlinks</span> created by <code>link</code>




More information about the Commit-Watchers mailing list