NOTE: The current preferred location for bug reports is the GitHub issue tracker.
Bug 556 - Add cite='' attribute to <section> and <article>.
Add cite='' attribute to <section> and <article>.
Status: RESOLVED INTENTIONAL
Product: Validator.nu
Classification: Unclassified
Component: HTML5 schema
HEAD
All All
: P2 normal
Assigned To: Henri Sivonen
http://svn.whatwg.org/webapps/source?...
Depends on:
Blocks:
  Show dependency treegraph
 
Reported: 2009-05-27 14:31 CEST by Henri Sivonen
Modified: 2009-05-27 15:13 CEST (History)
0 users

See Also:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Henri Sivonen 2009-05-27 14:31:23 CEST
Index: source
===================================================================
--- source	(revision 3068)
+++ source	(revision 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,6 +13149,24 @@
   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>
@@ -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>