- From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
- Date: Tue, 02 Jun 2009 02:57:09 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/spec In directory hutz:/tmp/cvs-serv23463 Modified Files: Overview.html Log Message: Make xml:lang requirements more clear. (bug 6949) (whatwg r3175) Index: Overview.html =================================================================== RCS file: /sources/public/html5/spec/Overview.html,v retrieving revision 1.2328 retrieving revision 1.2329 diff -u -d -r1.2328 -r1.2329 --- Overview.html 2 Jun 2009 02:37:52 -0000 1.2328 +++ Overview.html 2 Jun 2009 02:57:06 -0000 1.2329 @@ -385,8 +385,7 @@ <ol> <li><a href="#the-id-attribute"><span class="secno">3.3.3.1 </span>The <code>id</code> attribute</a></li> <li><a href="#the-title-attribute"><span class="secno">3.3.3.2 </span>The <code>title</code> attribute</a></li> - <li><a href="#the-lang-and-xml:lang-attributes"><span class="secno">3.3.3.3 </span>The <code>lang</code> and <code>xml:lang</code> - attributes</a></li> + <li><a href="#the-lang-and-xml:lang-attributes"><span class="secno">3.3.3.3 </span>The <code title="attr-lang">lang</code> and <code title="attr-xml-lang">xml:lang</code> attributes</a></li> <li><a href="#the-xml:base-attribute-xml-only"><span class="secno">3.3.3.4 </span>The <code>xml:base</code> attribute (XML only)</a></li> <li><a href="#the-dir-attribute"><span class="secno">3.3.3.5 </span>The <code>dir</code> attribute</a></li> @@ -7256,7 +7255,7 @@ attribute.<h3 id="elements"><span class="secno">3.3 </span>Elements</h3><h4 id="semantics-0"><span class="secno">3.3.1 </span>Semantics</h4><p>Elements, attributes, and attribute values in HTML are defined (by this specification) to have certain meanings (semantics). For example, the <code><a href="#the-ol-element">ol</a></code> element represents an ordered list, and - the <code title="attr-lang"><a href="#the-lang-and-xml:lang-attributes">lang</a></code> attribute represents the + the <code title="attr-lang"><a href="#attr-lang">lang</a></code> attribute represents the language of the content.<p>Authors must not use elements, attributes, and attribute values for purposes other than their appropriate intended semantic purpose.<div class="example"> @@ -7461,7 +7460,7 @@ <li><code title="attr-id"><a href="#the-id-attribute">id</a></code></li> <li><code title="attr-item"><a href="#items:-the-item-attribute">item</a></code></li> <li><code title="attr-hidden"><a href="#the-hidden-attribute">hidden</a></code></li> - <li><code title="attr-lang"><a href="#the-lang-and-xml:lang-attributes">lang</a></code></li> + <li><code title="attr-lang"><a href="#attr-lang">lang</a></code></li> <li><code title="attr-itemprop"><a href="#names:-the-itemprop-attribute">itemprop</a></code></li> <li><code title="attr-spellcheck"><a href="#attr-spellcheck">spellcheck</a></code></li> <li><code title="attr-style"><a href="#the-style-attribute">style</a></code></li> @@ -7602,45 +7601,51 @@ must <a href="#reflect">reflect</a> the <code title="attr-title"><a href="#the-title-attribute">title</a></code> content attribute.</p> - </div><h5 id="the-lang-and-xml:lang-attributes"><span class="secno">3.3.3.3 </span>The <dfn title="attr-lang"><code>lang</code></dfn> and <dfn title="attr-xml-lang"><code>xml:lang</code></dfn> - attributes</h5><p>The <code title="attr-lang"><a href="#the-lang-and-xml:lang-attributes">lang</a></code> attribute specifies the - primary <dfn id="language">language</dfn> for the element's contents and for any - of the element's attributes that contain text. Its value must be a - valid RFC 3066 language code, or the empty string. <a href="#references">[RFC3066]</a><p>The <code title="attr-xml-lang"><a href="#the-lang-and-xml:lang-attributes">xml:lang</a></code> attribute (that - is, the <code title="">lang</code> attribute with the <code title="">xml</code> prefix in the <code title="">http://www.w3.org/XML/1998/namespace</code> namespace) is - defined in XML. <a href="#references">[XML]</a><p>If these attributes are omitted from an element, then the + </div><h5 id="the-lang-and-xml:lang-attributes"><span class="secno">3.3.3.3 </span>The <code title="attr-lang"><a href="#attr-lang">lang</a></code> and <code title="attr-xml-lang"><a href="#attr-xml-lang">xml:lang</a></code> attributes</h5><p>The <dfn id="attr-lang" title="attr-lang"><code>lang</code></dfn> attribute (in + no namespace) specifies the primary <dfn id="language">language</dfn> for the + element's contents and for any of the element's attributes that + contain text. Its value must be a valid RFC 3066 language code, or + the empty string. <a href="#references">[RFC3066]</a><p>The <dfn id="attr-xml-lang" title="attr-xml-lang"><code title="">lang</code></dfn> + attribute in the <a href="#xml-namespace">XML namespace</a> is defined in XML. <a href="#references">[XML]</a><p>If these attributes are omitted from an element, then the language of this element is the same as the language of its parent element, if any. Setting the attribute to the empty string indicates that the primary language is unknown.</p><!-- UA conformance - requires for this are below --><p>The <code title="attr-lang"><a href="#the-lang-and-xml:lang-attributes">lang</a></code> attribute may be used on - any <a href="#html-elements" title="HTML elements">HTML element</a>.<p>The <code title="attr-xml-lang"><a href="#the-lang-and-xml:lang-attributes">xml:lang</a></code> attribute may be - used on <a href="#html-elements">HTML elements</a> in <a href="#xml-documents">XML documents</a>, as - well as elements in other namespaces if the relevant specifications - allow it (in particular, MathML and SVG allow <code title="attr-xml-lang"><a href="#the-lang-and-xml:lang-attributes">xml:lang</a></code> attributes to be specified on - their elements). If both the <code title="attr-lang"><a href="#the-lang-and-xml:lang-attributes">lang</a></code> - attribute and the <code title="attr-xml-lang"><a href="#the-lang-and-xml:lang-attributes">xml:lang</a></code> - attribute are specified on the same element, they must have exactly - the same value when compared in an <a href="#ascii-case-insensitive">ASCII - case-insensitive</a> manner.<p>Authors must not use the <code title="attr-xml-lang"><a href="#the-lang-and-xml:lang-attributes">xml:lang</a></code> attribute (that is, the <code title="">lang</code> attribute with the <code title="">xml</code> - prefix in the <code title="">http://www.w3.org/XML/1998/namespace</code> namespace) in - <a href="#html-documents">HTML documents</a>. To ease migration to and from XHTML, - authors may specify an attribute in no namespace with no prefix and - with the localname <code title="">xml:lang</code> on <a href="#html-elements">HTML - elements</a> in <a href="#html-documents">HTML documents</a>, but such attributes - must only be specified if a <code title="attr-lang"><a href="#the-lang-and-xml:lang-attributes">lang</a></code> - attribute is also specified, and both attributes must have the same + requires for this are below --><p>The <code title="attr-lang"><a href="#attr-lang">lang</a></code> attribute in no namespace + may be used on any <a href="#html-elements" title="HTML elements">HTML + element</a>.<p>The <a href="#attr-xml-lang" title="attr-xml-lang"><code title="">lang</code> + attribute in the <span>XML namespace</span></a> may be used on + <a href="#html-elements">HTML elements</a> in <a href="#xml-documents">XML documents</a>, as well as + elements in other namespaces if the relevant specifications allow it + (in particular, MathML and SVG allow <a href="#attr-xml-lang" title="attr-xml-lang"><code title="">lang</code> attributes in the + <span>XML namespace</span></a> to be specified on their + elements). If both the <code title="attr-lang"><a href="#attr-lang">lang</a></code> attribute + in no namespace and the <a href="#attr-xml-lang" title="attr-xml-lang"><code title="">lang</code> attribute in the <span>XML + namespace</span></a> are specified on the same element, they must + have exactly the same value when compared in an <a href="#ascii-case-insensitive">ASCII + case-insensitive</a> manner.<p>Authors must not use the <a href="#attr-xml-lang" title="attr-xml-lang"><code title="">lang</code> attribute in the <span>XML + namespace</span></a> in <a href="#html-documents">HTML documents</a>. To ease + migration to and from XHTML, authors may specify an attribute in no + namespace with no prefix and with the literal localname "<code title="">xml:lang</code>" on <a href="#html-elements">HTML elements</a> in + <a href="#html-documents">HTML documents</a>, but such attributes must only be + specified if a <code title="attr-lang"><a href="#attr-lang">lang</a></code> attribute in no + namespace is also specified, and both attributes must have the same value when compared in an <a href="#ascii-case-insensitive">ASCII case-insensitive</a> manner.<div class="impl"> <hr><p>To determine the language of a node, user agents must look at the nearest ancestor element (including the element itself if the node - is an element) that has an <code title="attr-xml-lang"><a href="#the-lang-and-xml:lang-attributes">xml:lang</a></code> attribute set or is an <a href="#html-elements" title="HTML elements">HTML element</a> and has a <code title="attr-lang"><a href="#the-lang-and-xml:lang-attributes">lang</a></code> attribute set. That attribute - specifies the language of the node.</p> + is an element) that has a <a href="#attr-xml-lang" title="attr-xml-lang"><code title="">lang</code> attribute in the <span>XML + namespace</span></a> set or is an <a href="#html-elements" title="HTML + elements">HTML element</a> and has a <code title="attr-lang"><a href="#attr-lang">lang</a></code> in no namespace attribute set. That + attribute specifies the language of the node.</p> - <p>If both the <code title="attr-xml-lang"><a href="#the-lang-and-xml:lang-attributes">xml:lang</a></code> attribute - and the <code title="attr-lang"><a href="#the-lang-and-xml:lang-attributes">lang</a></code> attribute are set on an - element, user agents must use the <code title="attr-xml-lang"><a href="#the-lang-and-xml:lang-attributes">xml:lang</a></code> attribute, and the <code title="attr-lang"><a href="#the-lang-and-xml:lang-attributes">lang</a></code> attribute must be <a href="#ignore" title="ignore">ignored</a> for the purposes of determining the - element's language.</p> + <p>If both the <code title="attr-lang"><a href="#attr-lang">lang</a></code> attribute in no + namespace and the <a href="#attr-xml-lang" title="attr-xml-lang"><code title="">lang</code> attribute in the <span>XML + namespace</span></a> are set on an element, user agents must use + the <a href="#attr-xml-lang" title="attr-xml-lang"><code title="">lang</code> attribute + in the <span>XML namespace</span></a>, and the <code title="attr-lang"><a href="#attr-lang">lang</a></code> attribute in no namespace must be + <a href="#ignore" title="ignore">ignored</a> for the purposes of determining + the element's language.</p> <p>If no explicit language is given for the <a href="#root-element">root element</a>, but there is a <a href="#document-wide-default-language">document-wide default @@ -7664,8 +7669,8 @@ rendering-level concern.)--></p> <hr><p>The <dfn id="dom-lang" title="dom-lang"><code>lang</code></dfn> DOM attribute - must <a href="#reflect">reflect</a> the <code title="attr-lang"><a href="#the-lang-and-xml:lang-attributes">lang</a></code> - content attribute.</p> + must <a href="#reflect">reflect</a> the <code title="attr-lang"><a href="#attr-lang">lang</a></code> + content attribute in no namespace.</p> </div><h5 id="the-xml:base-attribute-xml-only"><span class="secno">3.3.3.4 </span>The <dfn title="attr-xml-base"><code>xml:base</code></dfn> attribute (XML only)</h5><p>The <code title="attr-xml-base"><a href="#the-xml:base-attribute-xml-only">xml:base</a></code> attribute is @@ -14418,7 +14423,7 @@ <dd>Uses <code><a href="#htmlelement">HTMLElement</a></code>.</dd> </dl><p>The <code><a href="#the-span-element">span</a></code> element doesn't mean anything on its own, but can be useful when used together with other attributes, - e.g. <code title="attr-class"><a href="#classes">class</a></code>, <code title="attr-lang"><a href="#the-lang-and-xml:lang-attributes">lang</a></code>, or <code title="attr-dir"><a href="#the-dir-attribute">dir</a></code>. It <a href="#represents">represents</a> its + e.g. <code title="attr-class"><a href="#classes">class</a></code>, <code title="attr-lang"><a href="#attr-lang">lang</a></code>, or <code title="attr-dir"><a href="#the-dir-attribute">dir</a></code>. It <a href="#represents">represents</a> its children.<h4 id="the-i-element"><span class="secno">4.6.19 </span>The <dfn><code>i</code></dfn> element</h4><dl class="element"><dt>Categories</dt> <dd><a href="#flow-content-0">Flow content</a>.</dd> <dd><a href="#phrasing-content-0">Phrasing content</a>.</dd> @@ -14436,7 +14441,9 @@ idiomatic phrase from another language, a thought, a ship name, or some other prose whose typical typographic presentation is italicized.<p>Terms in languages different from the main text should be - annotated with <code title="attr-lang"><a href="#the-lang-and-xml:lang-attributes">lang</a></code> attributes (<code title="attr-xml-lang"><a href="#the-lang-and-xml:lang-attributes">xml:lang</a></code> in XML).<div class="example"> + annotated with <code title="attr-lang"><a href="#attr-lang">lang</a></code> attributes (or, + in XML, <a href="#attr-xml-lang" title="attr-xml-lang"><code title="">lang</code> + attributes in the <span>XML namespace</span></a>).<div class="example"> <p>The examples below show uses of the <code><a href="#the-i-element">i</a></code> element:</p> <pre><p>The <i class="taxonomy">Felis silvestris catus</i> is cute.</p> <p>The term <i>prose content</i> is defined above.</p> @@ -36050,7 +36057,7 @@ <dt>DOM interface:</dt> <dd>Uses <code><a href="#htmlelement">HTMLElement</a></code>.</dd> </dl><p>The <code><a href="#the-div-element">div</a></code> element has no special meaning at all. It - <a href="#represents">represents</a> its children. It can be used with the <code title="attr-class"><a href="#classes">class</a></code>, <code title="attr-lang"><a href="#the-lang-and-xml:lang-attributes">lang</a></code>/<code title="attr-xml-lang"><a href="#the-lang-and-xml:lang-attributes">xml:lang</a></code>, and <code title="attr-title"><a href="#the-title-attribute">title</a></code> attributes to mark up semantics + <a href="#represents">represents</a> its children. It can be used with the <code title="attr-class"><a href="#classes">class</a></code>, <code title="attr-lang"><a href="#attr-lang">lang</a></code>, and <code title="attr-title"><a href="#the-title-attribute">title</a></code> attributes to mark up semantics common to a group of consecutive elements.<p class="XXX">Allowing <code><a href="#the-div-element">div</a></code> elements to contain phrasing content makes it easy for authors to abuse <code><a href="#the-div-element">div</a></code>, using it with the <code>class=""</code> attribute @@ -55517,7 +55524,8 @@ corresponding cell in the third column, and the namespace being the namespace given in the corresponding cell in the fourth column. (This fixes the use of namespaced attributes, in particular - <code title="">xml:lang</code>.)</p> + <a href="#attr-xml-lang" title="attr-xml-lang"><code title="">lang</code> attributes in + the <span>XML namespace</span></a>.)</p> <table><thead><tr><th> Attribute name <th> Prefix <th> Local name <th> Namespace <tbody><tr><td> <code title="">xlink:actuate</code> <td> <code title="">xlink</code> <td> <code title="">actuate</code> <td> <a href="#xlink-namespace">XLink namespace</a>
Received on Tuesday, 2 June 2009 02:57:17 UTC