- From: poot <cvsmail@w3.org>
- Date: Wed, 26 Jan 2011 18:49:54 -0500
- To: public-html-diffs@w3.org
eliot: Rewrote Attribute Values based on mail feedback http://dev.w3.org/cvsweb/html5/html-xhtml-author-guide/html-xhtml-authoring-guide.html?r1=1.53&r2=1.54&f=h =================================================================== RCS file: /sources/public/html5/html-xhtml-author-guide/html-xhtml-authoring-guide.html,v retrieving revision 1.53 retrieving revision 1.54 diff -u -d -r1.53 -r1.54 --- html-xhtml-authoring-guide.html 13 Jan 2011 22:19:55 -0000 1.53 +++ html-xhtml-authoring-guide.html 26 Jan 2011 23:48:32 -0000 1.54 @@ -4,465 +4,8 @@ <head> <title>Polyglot Markup: HTML-Compatible XHTML Documents</title> <meta name="GENERATOR" content="MSHTML 8.00.7600.16588"/> - <style type="text/css"> - - /* --- INLINES --- */ - em.rfc2119 { - text-transform: lowercase; - font-variant: small-caps; - font-style: normal; - color: #900; - } - - h1 acronym, h2 acronym, h3 acronym, h4 acronym, h5 acronym, h6 acronym, a acronym, - h1 abbr, h2 abbr, h3 abbr, h4 abbr, h5 abbr, h6 abbr, a abbr { - border: none; - } - - dfn { - font-weight: bold; - } - - a.internalDFN { - color: inherit; - border-bottom: medium solid #99c; - text-decoration: none; - } - - a.externalDFN { - color: inherit; - border-bottom: medium dotted #ccc; - text-decoration: none; - } - - a.bibref { - text-decoration: none; - } - - code { - color: #ff4500; - } - - - /* --- WEB IDL --- */ - pre.idl { - border-top: 1px solid #90b8de; - border-bottom: 1px solid #90b8de; - padding: 1em; - line-height: 120%; - } - - pre.idl::before { - content: "WebIDL"; - display: block; - width: 150px; - background: #90b8de; - color: #fff; - font-family: initial; - padding: 3px; - font-weight: bold; - margin: -1em 0 1em -1em; - } - - .idlType { - color: #ff4500; - font-weight: bold; - text-decoration: none; - } - - /*.idlModule*/ - /*.idlModuleID*/ - /*.idlInterface*/ - .idlInterfaceID { - font-weight: bold; - color: #005a9c; - } - - .idlSuperclass { - font-style: italic; - color: #005a9c; - } - - /*.idlAttribute*/ - .idlAttrType, .idlFieldType { - color: #005a9c; - } - .idlAttrName, .idlFieldName { - color: #ff4500; - } - .idlAttrName a, .idlFieldName a { - color: #ff4500; - border-bottom: 1px dotted #ff4500; - text-decoration: none; - } - - /*.idlMethod*/ - .idlMethType { - color: #005a9c; - } - .idlMethName { - color: #ff4500; - } - .idlMethName a { - color: #ff4500; - border-bottom: 1px dotted #ff4500; - text-decoration: none; - } - - /*.idlParam*/ - .idlParamType { - color: #005a9c; - } - .idlParamName { - font-style: italic; - } - - .extAttr { - color: #666; - } - - /*.idlConst*/ - .idlConstType { - color: #005a9c; - } - .idlConstName { - color: #ff4500; - } - .idlConstName a { - color: #ff4500; - border-bottom: 1px dotted #ff4500; - text-decoration: none; - } - - /*.idlException*/ - .idlExceptionID { - font-weight: bold; - color: #c00; - } - - .idlTypedefID, .idlTypedefType { - color: #005a9c; - } - - .idlRaises, .idlRaises a.idlType, .idlRaises a.idlType code, .excName a, .excName a code { - color: #c00; - font-weight: normal; - } - - .excName a { - font-family: monospace; - } - - .idlRaises a.idlType, .excName a.idlType { - border-bottom: 1px dotted #c00; - } - - .excGetSetTrue, .excGetSetFalse, .prmNullTrue, .prmNullFalse, .prmOptTrue, .prmOptFalse { - width: 45px; - text-align: center; - } - .excGetSetTrue, .prmNullTrue, .prmOptTrue { color: #0c0; } - .excGetSetFalse, .prmNullFalse, .prmOptFalse { color: #c00; } - - .idlImplements a { - font-weight: bold; - } - - dl.attributes, dl.methods, dl.constants, dl.fields { - margin-left: 2em; - } - - .attributes dt, .methods dt, .constants dt, .fields dt { - font-weight: normal; - } - - .attributes dt code, .methods dt code, .constants dt code, .fields dt code { - font-weight: bold; - color: #000; - font-family: monospace; - } - - .attributes dt code, .fields dt code { - background: #ffffd2; - } - - .attributes dt .idlAttrType code, .fields dt .idlFieldType code { - color: #005a9c; - background: transparent; - font-family: inherit; - font-weight: normal; - font-style: italic; - } - - .methods dt code { - background: #d9e6f8; - } - - .constants dt code { - background: #ddffd2; - } - - .attributes dd, .methods dd, .constants dd, .fields dd { - margin-bottom: 1em; - } - - table.parameters, table.exceptions { - border-spacing: 0; - border-collapse: collapse; - margin: 0.5em 0; - width: 100%; - } - table.parameters { border-bottom: 1px solid #90b8de; } - table.exceptions { border-bottom: 1px solid #deb890; } - - .parameters th, .exceptions th { - color: #fff; - padding: 3px 5px; - text-align: left; - font-family: initial; - font-weight: normal; - text-shadow: #666 1px 1px 0; - } - .parameters th { background: #90b8de; } - .exceptions th { background: #deb890; } - - .parameters td, .exceptions td { - padding: 3px 10px; - border-top: 1px solid #ddd; - vertical-align: top; - } - - .parameters tr:first-child td, .exceptions tr:first-child td { - border-top: none; - } - - .parameters td.prmName, .exceptions td.excName, .exceptions td.excCodeName { - width: 100px; - } - - .parameters td.prmType { - width: 120px; - } - - table.exceptions table { - border-spacing: 0; - border-collapse: collapse; - width: 100%; - } - - /* --- TOC --- */ - .toc a { - text-decoration: none; - } - - a .secno { - color: #000; - } - - /* --- TABLE --- */ - table.simple { - border-spacing: 0; - border-collapse: collapse; - border-bottom: 3px solid #005a9c; - } - - .simple th { - background: #005a9c; - color: #fff; - padding: 3px 5px; - text-align: left; - } - - .simple th[scope="row"] { - background: inherit; - color: inherit; - border-top: 1px solid #ddd; - } - - .simple td { - padding: 3px 10px; - border-top: 1px solid #ddd; - } - - .simple tr:nth-child(even) { - background: #f0f6ff; - } - - /* --- DL --- */ - .section dd > p:first-child { - margin-top: 0; - } - - .section dd > p:last-child { - margin-bottom: 0; - } - - .section dd { - margin-bottom: 1em; - } - - .section dl.attrs dd, .section dl.eldef dd { - margin-bottom: 0; - } - - /* --- EXAMPLES --- */ - pre.example { - border-top: 1px solid #ff4500; - border-bottom: 1px solid #ff4500; - padding: 1em; - margin-top: 1em; - } - - pre.example::before { - content: "Example"; - display: block; - width: 150px; - background: #ff4500; - color: #fff; - font-family: initial; - padding: 3px; - font-weight: bold; - margin: -1em 0 1em -1em; - } - - /* --- EDITORIAL NOTES --- */ - .issue { - padding: 1em; - margin: 1em 0em 0em; - border: 1px solid #f00; - background: #ffc; - } - - .issue::before { - content: "Issue"; - display: block; - width: 150px; - margin: -1.5em 0 0.5em 0; - font-weight: bold; - border: 1px solid #f00; - background: #fff; - padding: 3px 1em; - } - - .note { - margin: 1em 0em 0em; - padding: 1em; - border: 2px solid #cff6d9; - background: #e2fff0; - } - - .note::before { - content: "Note"; - display: block; - width: 150px; - margin: -1.5em 0 0.5em 0; - font-weight: bold; - border: 1px solid #cff6d9; - background: #fff; - padding: 3px 1em; - } - - /* --- Best Practices --- */ - div.practice { - border: solid #bebebe 1px; - margin: 2em 1em 1em 2em; - } - - span.practicelab { - margin: 1.5em 0.5em 1em 1em; - font-weight: bold; - font-style: italic; - } - - span.practicelab { background: #dfffff; } - - span.practicelab { - position: relative; - padding: 0 0.5em; - top: -1.5em; - } - - p.practicedesc { - margin: 1.5em 0.5em 1em 1em; - } - - @media screen { - p.practicedesc { - position: relative; - top: -2em; - padding: 0; - margin: 1.5em 0.5em -1em 1em; - } - - /* --- SYNTAX HIGHLIGHTING --- */ - pre.sh_sourceCode { - background-color: white; - color: black; - font-style: normal; - font-weight: normal; - } - - pre.sh_sourceCode .sh_keyword { color: #005a9c; font-weight: bold; } /* language keywords */ - pre.sh_sourceCode .sh_type { color: #666; } /* basic types */ - pre.sh_sourceCode .sh_usertype { color: teal; } /* user defined types */ - pre.sh_sourceCode .sh_string { color: red; font-family: monospace; } /* strings and chars */ - pre.sh_sourceCode .sh_regexp { color: orange; font-family: monospace; } /* regular expressions */ - pre.sh_sourceCode .sh_specialchar { color: #ffc0cb; font-family: monospace; } /* e.g., \n, \t, \\ */ - pre.sh_sourceCode .sh_comment { color: #A52A2A; font-style: italic; } /* comments */ - pre.sh_sourceCode .sh_number { color: purple; } /* literal numbers */ - pre.sh_sourceCode .sh_preproc { color: #00008B; font-weight: bold; } /* e.g., #include, import */ - pre.sh_sourceCode .sh_symbol { color: blue; } /* e.g., *, + */ - pre.sh_sourceCode .sh_function { color: black; font-weight: bold; } /* function calls and declarations */ - pre.sh_sourceCode .sh_cbracket { color: red; } /* block brackets (e.g., {, }) */ - pre.sh_sourceCode .sh_todo { font-weight: bold; background-color: #00FFFF; } /* TODO and FIXME */ - - /* Predefined variables and functions (for instance glsl) */ - pre.sh_sourceCode .sh_predef_var { color: #00008B; } - pre.sh_sourceCode .sh_predef_func { color: #00008B; font-weight: bold; } - - /* for OOP */ - pre.sh_sourceCode .sh_classname { color: teal; } - - /* line numbers (not yet implemented) */ - pre.sh_sourceCode .sh_linenum { display: none; } - - /* Internet related */ - pre.sh_sourceCode .sh_url { color: blue; text-decoration: underline; font-family: monospace; } - - /* for ChangeLog and Log files */ - pre.sh_sourceCode .sh_date { color: blue; font-weight: bold; } - pre.sh_sourceCode .sh_time, pre.sh_sourceCode .sh_file { color: #00008B; font-weight: bold; } - pre.sh_sourceCode .sh_ip, pre.sh_sourceCode .sh_name { color: #006400; } - - /* for Prolog, Perl... */ - pre.sh_sourceCode .sh_variable { color: #006400; } - - /* for LaTeX */ - pre.sh_sourceCode .sh_italics { color: #006400; font-style: italic; } - pre.sh_sourceCode .sh_bold { color: #006400; font-weight: bold; } - pre.sh_sourceCode .sh_underline { color: #006400; text-decoration: underline; } - pre.sh_sourceCode .sh_fixed { color: green; font-family: monospace; } - pre.sh_sourceCode .sh_argument { color: #006400; } - pre.sh_sourceCode .sh_optionalargument { color: purple; } - pre.sh_sourceCode .sh_math { color: orange; } - pre.sh_sourceCode .sh_bibtex { color: blue; } - - /* for diffs */ - pre.sh_sourceCode .sh_oldfile { color: orange; } - pre.sh_sourceCode .sh_newfile { color: #006400; } - pre.sh_sourceCode .sh_difflines { color: blue; } - - /* for css */ - pre.sh_sourceCode .sh_selector { color: purple; } - pre.sh_sourceCode .sh_property { color: blue; } - pre.sh_sourceCode .sh_value { color: #006400; font-style: italic; } - - /* other */ - pre.sh_sourceCode .sh_section { color: black; font-weight: bold; } - pre.sh_sourceCode .sh_paren { color: red; } - pre.sh_sourceCode .sh_attribute { color: #006400; } - </style> <link rel="stylesheet" type="text/css" href="http://www.w3.org/StyleSheets/TR/W3C-ED"/> + <link rel="stylesheet" type="text/css" href="http://dev.w3.org/2009/dap/ReSpec.js/css/respec.css"/> </head> <body style="display: inherit;"> @@ -471,7 +14,7 @@ <a href="http://www.w3.org/"><img height="48" width="72" alt="W3C" src="http://www.w3.org/Icons/w3c_home"/></a> </p> <h1 class="title" id="title">Polyglot Markup: HTML-Compatible XHTML Documents</h1> - <h2 id="w3c-editor-s-draft-05-january-2011">W3C Editor's Draft 13 January 2011</h2> + <h2 id="w3c-editor-s-draft-05-january-2011">W3C Editor's Draft 26 January 2011</h2> <dl> <dt>This version:</dt> <dd><a href="http://dev.w3.org/html5/html-xhtml-author-guide/html-xhtml-authoring-guide.html">http://dev.w3.org/html5/html-xhtml-author-guide/html-xhtml-authoring-guide.html</a></dd> @@ -898,7 +441,7 @@ <!--End section: Element Names--> </div> - + <div id="attribute-names" class="section"> <h4><span class="secno">6.3.2 </span>Attribute Names</h4> <p><a class="internalDFN" href="#dfn-polyglot-markup" title="polyglot markup">Polyglot markup</a> uses the correct case for attribute names.</p> @@ -977,71 +520,51 @@ <!--End section: Attribute Names--> </div> + <div id="attribute-values" class="section"> <h4><span class="secno">6.3.3 </span>Attribute Values</h4> <p> - <a class="internalDFN" href="#dfn-polyglot-markup" title="polyglot markup">Polyglot markup</a> - requires the case used for characters in the values of the following -attributes to be consistent between markup, DOM APIs, and CSS + For characters in attribute values, <a class="internalDFN" href="#dfn-polyglot-markup">polyglot markup</a> maintains case consistency between markup, DOM APIs, and CSS when these attributes are used on HTML elements. - This is because XML is case sensitive, but the values of these -attributes are treated as case insensitive in HTML when matched via CSS -selectors - (See <a href="http://dev.w3.org/html5/spec/links.html#selectors">4.14.1 Case-sensitivity</a>, in the HTML5 specification). [<cite><a href="#bib-HTML5" rel="biblioentry" class="bibref">HTML5</a></cite>] - In addition, <a class="internalDFN" href="#dfn-polyglot-markup">polyglot markup</a> - respects the case sensitivity of all other attribute values and for -non-ASCII characters in the values of the attributes listed. - Note that other specifications, such as RDFa, may place additional -restrictions on the allowed values of certain attributes. </p> - <ul> - <li><code>accept</code></li> - <li><code>accept-charset</code></li> - <li><code>align</code></li> - <li><code>alink</code></li> - <li><code>axis</code></li> - <li><code>bgcolor</code></li> - <li><code>charset</code></li> - <li><code>checked</code></li> - <li><code>clear</code></li> - <li><code>codetype</code></li> - <li><code>color</code></li> - <li><code>compact</code></li> - <li><code>declare</code></li> - <li><code>defer</code></li> - <li><code>dir</code></li> - <li><code>direction</code></li> - <li><code>disabled</code></li> - <li><code>enctype</code></li> - <li><code>face</code></li> - <li><code>frame</code></li> - <li><code>hreflang</code></li> - <li><code>http-equiv</code></li> - <li><code>lang</code></li> - <li><code>language</code></li> - <li><code>link</code></li> - <li><code>media</code></li> - <li><code>method</code></li> - <li><code>multiple</code></li> - <li><code>nohref</code></li> - <li><code>noresize</code></li> - <li><code>noshade</code></li> - <li><code>nowrap</code></li> - <li><code>readonly</code></li> - <li><code>rel</code></li> - <li><code>rev</code></li> - <li><code>rules</code></li> - <li><code>scope</code></li> - <li><code>scrolling</code></li> - <li><code>selected</code></li> - <li><code>shape</code></li> - <li><code>target</code></li> - <li><code>text</code></li> - <li><code>type</code></li> - <li><code>valign</code></li> - <li><code>valuetype</code></li> - <li><code>vlink</code></li> - </ul> + <p> + <a class="internalDFN" href="#dfn-polyglot-markup" title="polyglot markup">Polyglot markup</a> maintains case consistency for values on the following attributes, which occur on + MIME types, language tags, charsets, booleans, media queries, and keywords. + Though not required, an easy way to maintain case-consistency is to use only lower case values for these attributes. + <a class="internalDFN" href="#dfn-polyglot-markup" title="polyglot markup">Polyglot markup</a> maintains case consistency for these values + because, for the purpose of selector matching, attribute values in XML are all treated case sensitively; + however, HTML treats the values of these attributes as case insensitive + (See <a href="http://dev.w3.org/html5/spec/links.html#selectors">4.14.1 Case-sensitivity</a>, in the HTML5 specification). [<cite><a href="#bib-HTML5" rel="biblioentry" class="bibref">HTML5</a></cite>] + + </p> + <ul> + <li><code>accept</code></li> + <li><code>accept-charset</code></li> + <li><code>charset</code></li> + <li><code>checked</code></li> + <li><code>defer</code></li> + <li><code>dir</code></li> + <li><code>direction</code></li> + <li><code>disabled</code></li> + <li><code>enctype</code></li> + <li><code>hreflang</code></li> + <li><code>http-equiv</code></li> + <li><code>lang</code></li> + <li><code>media</code></li> + <li><code>method</code></li> + <li><code>multiple</code></li> + <li><code>readonly</code></li> + <li><code>rel</code> (for values that do not contain a colon)</li> + <li><code>scope</code></li> + <li><code>selected</code></li> + <li><code>shape</code></li> + <li><code>target</code> (keywords only; browsing context names are case-sensitive)</li> + <li><code>type</code> (on <code>a</code>, <code>link</code>, <code>object</code>, <code>script</code>, or <code>style</code> elements)</li> + <li><code>type</code> (on input)</li> + </ul> + <p> + Note that other specifications, such as RDFa, may place additional restrictions on the allowed values of certain attributes. + </p> <!--End section: Attribute Values--> </div> <!--End section: Case-Sensitivity--> @@ -1434,7 +957,6 @@ <!--End section: Example Document--> </div> - <div id="acknowledgements" class="appendix section"> <!--OddPage--><h2><span class="secno">A. </span>Acknowledgements</h2> <p>
Received on Wednesday, 26 January 2011 23:49:56 UTC