Bugzilla – Bug 556
Add cite='' attribute to <section> and <article>.
Last modified: 2009-05-27 15:13:51 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>