css-style-attr/Overview.src.html

Sat, 12 Dec 2009 00:13:32 +0000

author
Elika Etemad <fantasai.cvs@inkedblade.net>
date
Sat, 12 Dec 2009 00:13:32 +0000
changeset 1571
76ff35863a28
parent 1570
ec1f340dfe81
child 1610
ddebc39f6d33
permissions
-rwxr-xr-x

Add conformance requirements for multiple style attributes. Finish Conformance section.

fantasai@1564 1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN">
fantasai@1564 2 <html lang="en">
fantasai@1564 3 <head>
fantasai@1564 4 <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
fantasai@1564 5 <title>CSS Style Attribute Syntax Level 1</title>
fantasai@1564 6 <link rel="stylesheet" type="text/css" href="../default.css">
fantasai@1563 7
fantasai@1564 8 <link rel="stylesheet" type="text/css" href="http://www.w3.org/StyleSheets/TR/W3C-ED">
fantasai@1563 9 </head>
fantasai@1563 10
fantasai@1564 11 <div class="head">
fantasai@1564 12 <!--logo-->
fantasai@1563 13
fantasai@1569 14 <h1>CSS Style Attribute Syntax Level 1</h1>
fantasai@1563 15
fantasai@1564 16 <h2 class="no-num no-toc">[LONGSTATUS] [DATE]</h2>
fantasai@1564 17 <dl>
fantasai@1564 18 <dt>This version:</dt>
fantasai@1564 19 <!-- <dd><dd><a href="http://www.w3.org/TR/[YEAR]/WD-css-style-attr-[CDATE]/">http://www.w3.org/TR/[YEAR]/WD-css-style-attr-[CDATE]/</a></dd> -->
fantasai@1564 20 <dd><a href="http://dev.w3.org/csswg/css-style-attr/">http://dev.w3.org/csswg/css-style-attr/</a>
fantasai@1564 21 <dt>Latest version:
fantasai@1564 22 <dd><a href="http://www.w3.org/TR/css-style-attr">http://www.w3.org/TR/css-style-attr</a>
fantasai@1564 23 <dt>Previous version:
fantasai@1564 24 <dd><a href="http://www.w3.org/TR/2002/WD-css-style-attr-20020515">http://www.w3.org/TR/2002/WD-css-style-attr-20020515</a>
fantasai@1564 25 <dt>Editor:
fantasai@1564 26 <dd><a href="http://fantasai.inkedblade.net/contact/">Elika J. Etemad</a>
fantasai@1564 27 <dt>Previous Editors:
fantasai@1564 28 <dd><span lang="tr">Tantek &Ccedil;elik</span> (<a href="http://www.microsoft.com/">Microsoft</a>), &lt;<a href="mailto:tantekc@microsoft.com">tantekc@microsoft.com</a>&gt;
fantasai@1564 29 <dd><a href="http://www.w3.org/People/Bos/">Bert Bos</a> (<a href="http://www.w3.org/">W3C</a>), &lt;<a href="mailto:bert@w3.org">bert@w3.org</a>&gt;
fantasai@1564 30 <dd>Marc Attinasi (AOL/Netscape), &lt;<a href="mailto:attinasi@netscape.com">attinasi@netscape.com</a>&gt;
fantasai@1564 31 </dl>
fantasai@1564 32 <!--begin-copyright-->
fantasai@1564 33 <p>[Here will be included the file "../copyright.inc"]</p>
fantasai@1564 34 <!--end-copyright-->
fantasai@1563 35
fantasai@1563 36 <hr title="Separator for header">
fantasai@1563 37 </div>
fantasai@1563 38
fantasai@1563 39 <h2 class="no-num no-toc" id="abstract">Abstract</h2>
fantasai@1563 40
fantasai@1564 41 <p>Markup languages such as HTML and SVG provide a "style" attribute on most
fantasai@1564 42 elements, to hold a fragment of a style sheet that applies to those elements.
fantasai@1564 43 One of the possible style sheet languages is CSS. This draft describes the
fantasai@1564 44 syntax of the CSS fragment that can be used in the "style" attribute.
fantasai@1563 45
fantasai@1563 46 <h2 class="no-num no-toc" id="status">Status of this document</h2>
fantasai@1564 47 <!--status-->
fantasai@1563 48
fantasai@1564 49 <h2 class="no-num no-toc" id="contents">Table of contents</h2>
fantasai@1564 50 <!--toc-->
fantasai@1563 51
fantasai@1564 52 <h2 id="intro">Introduction</h2>
fantasai@1563 53
fantasai@1564 54 <p>Several XML-based document formats have a "style" attribute to permit the
fantasai@1564 55 author to directly apply style information to specific elements in documents.
fantasai@1564 56 If a document format defines a "style" attribute and the attribute accepts CSS
fantasai@1564 57 as its value, then this specification describes the attribute's syntax and
fantasai@1564 58 interpretation.
fantasai@1563 59
fantasai@1564 60 <div class="example">
fantasai@1564 61 <p>The following example shows the use of the <code>style</code> attribute
fantasai@1564 62 in HTML:</p>
fantasai@1564 63 <pre>&lt;p style="<em>color: #090; line-height: 1.2</em>"&gt;...&lt;/p&gt;</pre>
fantasai@1564 64 </div>
fantasai@1563 65
fantasai@1564 66 <h2 id="syntax">Syntax</h2>
fantasai@1563 67
fantasai@1564 68 <p>The syntax of the style attribute syntax is exactly the same as the
fantasai@1564 69 contents of a CSS
fantasai@1564 70 <a href="http://www.w3.org/TR/CSS21/syndata.html#rule-sets">declaration block</a>.
fantasai@1564 71 A close brace (<code>}</code>) in the style attribute value does not
fantasai@1564 72 terminate the style data; it is merely an invalid token.
fantasai@1563 73
fantasai@1564 74 <p>The same rules for forward-compatible parsing apply to the inline style
fantasai@1570 75 sheet as to a normal style sheet. See <a href="http://www.w3.org/TR/CSS21/syndata.html">chapter
fantasai@1564 76 4 of the CSS2.1 specification</a>. [[!CSS21]]
fantasai@1563 77
fantasai@1564 78 <h2 id="grammar">Grammar</h2>
fantasai@1563 79
fantasai@1563 80 <p>The syntax of the CSS fragment that is allowed in the HTML "style"
fantasai@1563 81 attribute can be formally specified as follows:
fantasai@1563 82
fantasai@1563 83 <pre>
fantasai@1563 84 inline-stylesheet
fantasai@1565 85 : S* declaration-list
fantasai@1563 86 ;
fantasai@1563 87
fantasai@1565 88 declaration-list
fantasai@1563 89 : declaration [ ';' S* declaration ]*
fantasai@1563 90 ;
fantasai@1563 91 </pre>
fantasai@1563 92
fantasai@1570 93 <p>Please refer to the grammar in <a href="http://www.w3.org/TR/CSS21/grammar.html">appendix D
fantasai@1564 94 of the CSS2.1 specification</a> [[!CSS21]] for the definition of the symbols
fantasai@1564 95 not defined here.
fantasai@1563 96
fantasai@1567 97 <h2 id="interpret">Cascading and Interpretation</h2>
fantasai@1563 98
fantasai@1564 99 <p>The declarations in a style attribute apply to the element to which
fantasai@1564 100 the attribute belongs. CSS2.1 <a href="/TR/CSS21/cascade.html#specificity">defines</a>
fantasai@1564 101 how style sheets and "style" attributes are cascaded together. [[!CSS21]]
fantasai@1568 102 Aside from the differences in cascading, the declarations in a style
fantasai@1566 103 attribute must be interpreted exactly as if they were given in a CSS
fantasai@1566 104 style rule applied to the element.
fantasai@1565 105
fantasai@1571 106 <p>The CSS Working Group strongly recommends that document languages do
fantasai@1571 107 not allow multiple style attributes on a single element. If a document
fantasai@1571 108 language allows multiple style attributes, each is parsed independently
fantasai@1571 109 and treated as a separate style rule, the ordering of which should be
fantasai@1571 110 defined by the document language, else is undefined.
fantasai@1571 111
fantasai@1565 112 <h2 id="conformance">Conformance</h2>
fantasai@1565 113
fantasai@1571 114 <p>A document or implementation cannot conform to CSS Style Attribute Syntax
fantasai@1571 115 Level 1 alone, but can claim conformance to CSS Style Attribute Syntax Level 1
fantasai@1571 116 if it satisfies the conformance requirements in this specification when
fantasai@1571 117 implementing CSS together with style attribute handling as defined in a
fantasai@1571 118 document language that has style attributes.</p>
fantasai@1571 119
fantasai@1571 120 <p>Conformance to CSS Style Attribute Syntax Level 1 is defined for two classes:
fantasai@1571 121 <dl>
fantasai@1571 122 <dt><dfn>document</dfn></dt>
fantasai@1571 123 <dd>A document represented in a document language that defines a style
fantasai@1571 124 attribute for one or more of its elements.
fantasai@1571 125 <dt><dfn>interpreter</dfn></dt>
fantasai@1571 126 <dd>Someone or something that interprets the semantics of a document and
fantasai@1571 127 its associated style information.
fantasai@1571 128 (Most CSS <a href="http://www.w3.org/TR/CSS21/conform.html#user-agent">user
fantasai@1571 129 agents</a> fall under this category.)</dd>
fantasai@1571 130 </dl>
fantasai@1571 131
fantasai@1565 132 <p>The conformance requirements are expressed with a combination of
fantasai@1565 133 descriptive assertions and RFC 2119 terminology. The key words "MUST",
fantasai@1565 134 "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT",
fantasai@1565 135 "RECOMMENDED", "MAY", and "OPTIONAL" in the normative parts of this
fantasai@1565 136 document are to be interpreted as described in RFC 2119.
fantasai@1565 137 However, for readability, these words do not appear in all uppercase
fantasai@1565 138 letters in this specification. All of the text of this specification is
fantasai@1565 139 normative except sections explicitly marked as non-normative, examples,
fantasai@1565 140 and notes. [[!RFC2119]]</p>
fantasai@1565 141
fantasai@1565 142 <p>Examples in this specification are introduced with the words "for example"
fantasai@1565 143 or are set apart from the normative text with <code>class="example"</code>,
fantasai@1565 144 like this:
fantasai@1565 145
fantasai@1565 146 <div class="example">
fantasai@1565 147 <p>This is an example of an informative example.</p>
fantasai@1565 148 </div>
fantasai@1565 149
fantasai@1565 150 <p>Informative notes begin with the word "Note" and are set apart from the
fantasai@1565 151 normative text with <code>class="note"</code>, like this:
fantasai@1565 152
fantasai@1565 153 <p class="note">Note, this is an informative note.</p>
fantasai@1565 154
fantasai@1564 155 <h2 id="ack">Acknowledgments</h2>
fantasai@1563 156
fantasai@1563 157 <p>Thanks to feedback from Daniel Glazman, Ian Hickson, Eric A. Meyer,
fantasai@1563 158 Bj&ouml;rn H&ouml;hrmann.
fantasai@1563 159
fantasai@1564 160 <h2 id="references">References
fantasai@1563 161
fantasai@1564 162 <h3 class="no-num" id="normative-references">Normative references</h3>
fantasai@1563 163
fantasai@1564 164 <!--begin-normative-->
fantasai@1564 165 <p>[Here will be inserted the file "normative.inc"]</p>
fantasai@1564 166 <!--end-normative-->
fantasai@1563 167
fantasai@1564 168 <h3 class="no-num" id="informative-references">Informative references</h3>
fantasai@1563 169
fantasai@1564 170 <!--begin-informative-->
fantasai@1564 171 <p>[Here will be inserted the file "informative.inc"]</p>
fantasai@1564 172 <!--end-informative-->
fantasai@1563 173
fantasai@1563 174 </body>
fantasai@1563 175 </html>
fantasai@1563 176 <!-- Keep this comment at the end of the file
fantasai@1563 177 Local variables:
fantasai@1563 178 mode: sgml
fantasai@1563 179 sgml-declaration:"~/SGML/HTML4.decl"
fantasai@1563 180 sgml-default-doctype-name:"html"
fantasai@1563 181 sgml-minimize-attributes:t
fantasai@1563 182 sgml-nofill-elements:("pre" "style" "br")
fantasai@1563 183 End:
fantasai@1563 184 -->

mercurial