FFFF simplify title "CSS Styling Attributes Level 1" to "CSS Style Attribu… · w3c/csswg-drafts@3e183f9 · GitHub
Skip to content

Commit 3e183f9

Browse files
author
Tantek Çelik
committed
simplify title "CSS Styling Attributes Level 1" to "CSS Style Attributes" to reduce chance of unnecessary developer confusion (why "styling" vs "style"?). Make respective changes in body text. Add parenthetical note that style attribute may be named 'style' or something else.
1 parent f96b416 commit 3e183f9

1 file changed

Lines changed: 355 additions & 3 deletions

File tree

css-style-attr/Overview.html

Lines changed: 355 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,355 @@
1-
<title>Error</title>
2-
<h1>Error</h1>
3-
<p>Incorrect query: missing or illegal field "method"
1+
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN">
2+
<html lang="en"><head>
3+
4+
5+
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type">
6+
7+
<title>CSS Style Attributes</title>
8+
<link href="Overview_files/default.html" rel="stylesheet" type="text/css">
9+
<link href="Overview_files/W3C-ED.css" rel="stylesheet" type="text/css">
10+
11+
</head><body>
12+
<div class="head"> <!--begin-logo-->
13+
<p><a href="http://www.w3.org/"><img alt="W3C" src="Overview_files/w3c_home.png" height="48" width="72"></a> <!--end-logo-->
14+
15+
</p><h1>CSS Style Attributes</h1>
16+
17+
<h2 class="no-num no-toc" id="longstatus-date">Editor's Draft 13 September
18+
2010</h2>
19+
20+
<dl>
21+
<dt>This version:</dt>
22+
<!-- <dd><dd><a href="http://www.w3.org/TR/2010/WD-css-style-attr-20100913/">http://www.w3.org/TR/2010/WD-css-style-attr-20100913/</a></dd> -->
23+
24+
<dd><a href="http://dev.w3.org/csswg/css-style-attr/">http://dev.w3.org/csswg/css-style-attr/</a>
25+
26+
27+
</dd><dt>Latest version:
28+
29+
</dt><dd><a href="http://www.w3.org/TR/css-style-attr">http://www.w3.org/TR/css-style-attr</a>
30+
31+
32+
</dd><dt>Previous version:
33+
34+
</dt><dd><a href="http://www.w3.org/TR/2010/WD-css-style-attr-20100121/">http://www.w3.org/TR/2010/WD-css-style-attr-20100121/</a>
35+
36+
37+
</dd><dt>Editors:
38+
39+
</dt><dd class="vcard"><a class="fn url" href="http://tantek.com/" lang="tr">Tantek Çelik</a> (<span class="company role url">invited
40+
expert</span>, and before at <a href="http://www.microsoft.com/">Microsoft Corporation</a>) &lt;<a class="email" href="mailto:tantek@cs.stanford.edu">tantek@cs.stanford.edu</a>&gt;
41+
42+
</dd><dd class="vcard"><a class="fn n url" href="http://fantasai.inkedblade.net/contact"><span class="given-name">Elika</span> <abbr class="additional-name">J.</abbr>
43+
<span class="family-name">Etemad</span></a> (<span class="company
44+
role">invited expert</span>)
45+
46+
</dd><dt>Previous Editors:
47+
48+
</dt><dd class="vcard"><a class="fn url" href="http://www.w3.org/People/Bos/">Bert Bos</a> (<a class="org" href="http://www.w3.org/">W3C</a>), &lt;<a class="email" href="mailto:bert@w3.org">bert@w3.org</a>&gt;
49+
50+
</dd><dd class="vcard"><span class="fn"< 2851 span class=pl-kos>>Marc Attinasi</span> (<span class="org">AOL/Netscape</span>), &lt;<a class="email" href="mailto:attinasi@netscape.com">attinasi@netscape.com</a>&gt;
51+
</dd></dl>
52+
<!--begin-copyright-->
53+
<p class="copyright"><a href="http://www.w3.org/Consortium/Legal/ipr-notice#Copyright" rel="license">Copyright</a> © 2010 <a href="http://www.w3.org/"><acronym title="World Wide Web
54+
Consortium">W3C</acronym></a><sup>®</sup> (<a href="http://www.csail.mit.edu/"><acronym title="Massachusetts Institute
55+
of Technology">MIT</acronym></a>, <a href="http://www.ercim.eu/"><acronym title="European Research Consortium for Informatics and
56+
Mathematics">ERCIM</acronym></a>, <a href="http://www.keio.ac.jp/">Keio</a>), All Rights Reserved. W3C <a href="http://www.w3.org/Consortium/Legal/ipr-notice#Legal_Disclaimer">liability</a>,
57+
<a href="http://www.w3.org/Consortium/Legal/ipr-notice#W3C_Trademarks">trademark</a>
58+
and <a href="http://www.w3.org/Consortium/Legal/copyright-documents">document
59+
use</a> rules apply.</p>
60+
<!--end-copyright-->
61+
<hr title="Separator for header">
62+
</div>
63+
64+
<h2 class="no-num no-toc" id="abstract">Abstract</h2>
65+
66+
<p>Markup languages such as HTML <a href="#HTML401" rel="biblioentry">[HTML401]<!--{{HTML401}}--></a> and SVG <a href="#SVG11" rel="biblioentry">[SVG11]<!--{{SVG11}}--></a> provide a style attribute on
67+
most elements, to hold inline style information that applies to those
68+
elements. One of the possible style sheet languages is CSS. This draft
69+
describes the B3F3 syntax and interpretation of the CSS fragment that can be
70+
used in such style attributes.
71+
72+
</p><h2 class="no-num no-toc" id="status">Status of this document</h2>
73+
<!--begin-status-->
74+
75+
<p>This is a public copy of the editors' draft. It is provided for
76+
discussion only and may change at any moment. Its publication here does
77+
not imply endorsement of its contents by W3C. Don't cite this document
78+
other than as work in progress.
79+
80+
</p><p>The (<a href="http://lists.w3.org/Archives/Public/www-style/">archived</a>) public
81+
mailing list <a href="mailto:www-style@w3.org?Subject=%5Bcss-style-attr%5D%20PUT%20SUBJECT%20HERE">
82+
www-style@w3.org</a> (see <a href="http://www.w3.org/Mail/Request">instructions</a>) is preferred for
83+
discussion of this specification. When sending e-mail, please put the text
84+
“css-style-attr” in the subject, preferably like this:
85+
“[<!---->css-style-attr<!---->] <em>…summary of
86+
comment…</em>
87+
88+
</p><p>This document was produced by the <a href="http://cgi.w3.org/Style/CSS/members">CSS
89+
Working Group</a> (part of the <a href="http://cgi.w3.org/Style/">Style Activity</a>).
90+
91+
</p><p>This document was produced by a group operating under the <a href="http://cgi.w3.org/Consortium/Patent-Policy-20040205/">5 February 2004 W3C Patent
92+
Policy</a>. W3C maintains a <a href="http://cgi.w3.org/2004/01/pp-impl/32061/status" rel="disclosure">public list of any patent disclosures</a> made in
93+
connection with the deliverables of the group; that page also includes
94+
instructions for disclosing a patent. An individual who has actual
95+
knowledge of a patent which the individual believes contains <a href="http://cgi.w3.org/Consortium/Patent-Policy-20040205/#def-essential">Essential
96+
Claim(s)</a> must disclose the information in accordance with <a href="http://cgi.w3.org/Consortium/Patent-Policy-20040205/#sec-Disclosure">section 6 of the
97+
W3C Patent Policy</a>.</p>
98+
<!--end-status-->
99+
100+
<p>For this specification to exit the CR stage, the following conditions
101+
shall be met:
102+
103+
</p><ol>
104+
<li>
105+
<p>There must be at least two interoperable implementations. For the
106+
purposes of this criterion, we define the following terms:</p>
107+
108+
<dl>
109+
<dt>interoperable
110+
111+
</dt><dd>
112+
<p>passing the respective test case(s) in the <a href="http://www.w3.org/Style/CSS/Test/">CSS test suite</a>, or, if
113+
the implementation is not a Web browser, an equivalent test. Every
114+
relevant test in the test suite should have an equivalent test created
115+
if such a user agent (UA) is to be used to claim interoperability. In
116+
addition if such a UA is to be used to claim interoperability, then
117+
there must one or more additional UAs which can also pass those
118+
equivalent tests in the same way for the purpose of interoperability.
119+
The equivalent tests must be made publicly available for the purposes
120+
of peer review.</p>
121+
122+
</dd><dt>implementation
123+
124+
</dt><dd>
125+
<p>a user agent which:</p>
126+
127+
<ol>
128+
<li>implements the specification.
129+
130+
</li><li>is available (i.e. publicly downloadable or available through some
131+
other public point of sale mechanism). This is the "show me"
132+
requirement.
133+
134+
</li><li>is shipped, or is a "nightly build" (i.e., a development version
135+
for the next release), but is not experimental (i.e., a version
136+
specifically designed to pass the test suite and not intended for
137+
daily usage going forward).
138+
</li></ol>
139+
</dd></dl>
140+
141+
</li><li>
142+
<p>A minimum of three months of the CR period must elapse. That is, this
143+
specification will not exit CR before (DATE OF PUBLICATION PLUS THREE
144+
MONTHS). When the specification exits CR, an implementation report will
145+
be published. At this point, no such report exists.</p>
146+
</li></ol>
147+
148+
<p>A CSS Style Attributes <a href="http://www.w3.org/Style/CSS/Test/">Test
149+
Suite</a> will be developed during the Candidate Recommendation phase of
150+
this CSS Style Attributes specification.
151+
152+
</p><h2 class="no-num no-toc" id="contents">Table of contents</h2>
153+
<!--begin-toc-->
154+
155+
<ul class="toc">
156+
<li><a href="#intro"><span class="secno">1. </span>Introduction</a>
157+
158+
</li><li><a href="#conformance"><span class="secno">2. </span>Conformance</a>
159+
160+
</li><li><a href="#syntax"><span class="secno">3. </span>Syntax and Parsing</a>
161+
162+
</li><li><a href="#interpret"><span class="secno">4. </span>Cascading and
163+
Interpretation</a>
164+
165+
</li><li><a href="#ack"><span class="secno">5. </span>Acknowledgments</a>
166+
167+
</li><li><a href="#references"><span class="secno">6. </span>References </a>
168+
<ul class="toc">
169+
<li class="no-num"><a href="#normative-references">Normative
170+
references</a>
171+
172+
</li><li class="no-num"><a href="#informative-references">Informative
173+
references</a>
174+
</li></ul>
175+
</li></ul>
176+
<!--end-toc-->
177+
178+
<h2 id="intro"><span class="secno">1. </span>Introduction</h2>
179+
180+
<p>Some document formats have a <dfn id="style-attribute">style
181+
attribute</dfn> to permit the author to directly apply style information
182+
to specific elements in documents. If a document format defines a style
183+
attribute (whether named ‘<code class="property">style</code>
184+
or something else) and the attribute accepts CSS as its value, then this
185+
specification defines that <dfn id="style-attribute0">style
186+
attribute</dfn>’s syntax and interpretation.
187+
188+
</p><div class="example">
189+
<p>The following example shows the use of the <code>style</code> attribute
190+
in HTML <a href="#HTML401" rel="biblioentry">[HTML401]<!--{{HTML401}}--></a>:</p>
191+
192+
<pre>&lt;p style="<em>color: #090; line-height: 1.2</em>"&gt;...&lt;/p&gt;</pre>
193+
</div>
194+
195+
<h2 id="conformance"><span class="secno">2. </span>Conformance</h2>
196+
197+
<p>A document or implementation cannot conform to CSS Style Attributes
198+
alone, but can claim conformance to CSS Style Attributes if it satisfies
199+
the conformance requirements in this specification when implementing CSS
200+
together with style attribute handling as defined in a document language
201+
that has one or more CSS style attributes.
202+
203+
</p><p>Conformance to CSS Style Attributes is defined for two classes:
204+
205+
</p><dl>
206+
<dt><dfn id="document">document</dfn>
207+
208+
</dt><dd>A document represented in a document language that defines a style
209+
attribute for one or more of its elements.
210+
211+
</dd><dt><dfn id="interpreter">interpreter</dfn>
212+
213+
</dt><dd>Someone or something that interprets the semantics of a document and
214+
its associated style information. (Most CSS <a href="http://www.w3.org/TR/CSS21/conform.html#user-agent">user agents</a>
215+
fall under this category.)
216+
</dd></dl>
217+
218+
<p>The conformance requirements are expressed with a combination of
219+
descriptive assertions and RFC 2119 terminology. The key words "MUST",
220+
"MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT",
221+
"RECOMMENDED", "MAY", and "OPTIONAL" in the normative parts of this
222+
document are to be interpreted as described in RFC 2119. However, for
223+
readability, these words do not appear in all uppercase letters in this
224+
specification. All of the text of this specification is normative except
225+
sections explicitly marked as non-normative, examples, and notes. <a href="#RFC2119" rel="biblioentry">[RFC2119]<!--{{!RFC2119}}--></a>
226+
227+
</p><p>Examples in this specification are introduced with the words "for
228+
example" or are set apart from the normative text with
229+
<code>class="example"</code>, like this:
230+
231+
</p><div class="example">
232+
<p>This is an example of an informative example.</p>
233+
</div>
234+
235+
<p>Informative notes begin with the word "Note" and are set apart from the
236+
normative text with <code>class="note"</code>, like this:
237+
238+
</p><p class="note">Note, this is an informative note.
239+
240+
</p><h2 id="syntax"><span class="secno">3. </span>Syntax and Parsing</h2>
241+
242+
<p>The value of the style attribute must match the syntax of the contents
243+
of a CSS <a href="http://www.w3.org/TR/CSS21/syndata.html#rule-sets">declaration
244+
block</a> (excluding the delimiting braces), whose formal grammar is given
245+
below in the terms and conventions of the <a href="http://www.w3.org/TR/CSS21/syndata.html#syntax">CSS core
246+
grammar</a>:
247+
248+
</p><pre>declaration-list
249+
: S* declaration? [ ';' S* declaration? ]*
250+
;
251+
</pre>
252+
253+
<p class="note">Note that following the CSS2.1 convention, comment tokens are
254+
not shown in the rule above.
255+
256+
</p><p>The interpreter must parse the style attribute's value using the same
257+
forward-compatible parsing rules that apply to parsing declaration block
258+
contents in a normal CSS style sheet. See <a href="http://www.w3.org/TR/CSS21/syndata.html">chapter 4 of the CSS2.1
259+
specification</a> for details. <a href="#CSS21" rel="biblioentry">[CSS21]<!--{{!CSS21}}--></a>
260+
261+
</p><p class="note">Note that because there is no open brace delimiting the
262+
declaration list in the CSS style attribute syntax, a close brace
263+
(<code>}</code>) in the style attribute's value does not terminate the
264+
style data: it is merely an invalid token.
265+
266+
</p><h2 id="interpret"><span class="secno">4. </span>Cascading and Interpretation</h2>
267+
268+
<p>The declarations in a style attribute apply to the element to which the
269+
attribute belongs. In the cascade, these declarations are considered to
270+
have author origin and a specificity higher than any selector. CSS2.1 <a href="http://www.w3.org/TR/CSS21/cascade.html#specificity">defines</a> how
271+
style sheets and style attributes are cascaded together. <a href="#CSS21" rel="biblioentry">[CSS21]<!--{{!CSS21}}--></a> Relative URLs in the style
272+
data must be resolved relative to the style attribute's element (or to the
273+
document if per-element resolution is not defined) when the attribute's
274+
value is parsed<!-- so dynamic changes to
275+
the base URL don't affect the CSS ~Hixie -->.
276+
277+
278+
</p><p>Aside from the differences in cascading, the declarations in a style
279+
attribute must be interpreted exactly as if they were given in a CSS style
280+
rule that applies to the element.
281+
282+
</p><p>The CSS Working Group strongly recommends that document languages do not
283+
allow multiple CSS style attributes on a single element. If a document
284+
language allows multiple CSS style attributes, each must be parsed
285+
independently and treated as a separate style rule, the ordering of which
286+
should be defined by the document language, else is undefined.
287+
288+
</p><h2 id="ack"><span class="secno">5. </span>Acknowledgments</h2>
289+
290+
<p>Thanks to feedback from <span class="vcard"><span class="fn">Daniel
291+
Glazman</span></span>, <span class="vcard"><span class="fn">Ian
292+
Hickson</span></span>, <span class="vcard"><span class="fn n"><span class="given-name">Eric</span> <abbr class="additional-name">A.</abbr> <span class="family-name">Meyer</span></span></span>, <span class="vcard"><span class="fn">Björn Höhrmann</span></span>.
293+
294+
</p><h2 id="references"><span class="secno">6. </span>References</h2>
295+
296+
<h3 class="no-num" id="normative-references">Normative references</h3>
297+
<!--begin-normative-->
298+
<!-- Sorted by label -->
299+
300+
<dl class="bibliography">
301+
<dt style="display: none;"><!-- keeps the doc valid if the DL is empty -->
302+
<!---->
303+
304+
</dt><dt id="CSS21">[CSS21]
305+
306+
</dt><dd>Bert Bos; et al. <a href="http://www.w3.org/TR/2009/CR-CSS2-20090908"><cite>Cascading Style
307+
Sheets Level 2 Revision 1 (CSS 2.1) Specification.</cite></a> 8 September
308+
2009. W3C Candidate Recommendation. (Work in progress.) URL: <a href="http://www.w3.org/TR/2009/CR-CSS2-20090908">http://www.w3.org/TR/2009/CR-CSS2-20090908</a>
309+
</dd>
310+
<!---->
311+
312+
<dt id="RFC2119">[RFC2119]
313+
314+
</dt><dd>S. Bradner. <a href="http://www.ietf.org/rfc/rfc2119.txt"><cite>Key
315+
words for use in RFCs to Indicate Requirement Levels.</cite></a> Internet
316+
RFC 2119. URL: <a href="http://www.ietf.org/rfc/rfc2119.txt">http://www.ietf.org/rfc/rfc2119.txt</a>
317+
</dd>
318+
<!---->
319+
</dl>
320+
<!--end-normative-->
321+
322+
<h3 class="no-num" id="informative-references">Informative references</h3>
323+
<!--begin-informative-->
324+
<!-- Sorted by label -->
325+
326+
<dl class="bibliography">
327+
<dt style="display: none;"><!-- keeps the doc valid if the DL is empty -->
328+
<!---->
329+
330+
</dt><dt id="HTML401">[HTML401]
331+
332+
</dt><dd>David Raggett; Ian Jacobs; Arnaud Le Hors. <a href="http://www.w3.org/TR/1999/REC-html401-19991224"><cite>HTML 4.01
333+
Specification.</cite></a> 24 December 1999. W3C Recommendation. URL: <a href="http://www.w3.org/TR/1999/REC-html401-19991224">http://www.w3.org/TR/1999/REC-html401-19991224</a>
334+
</dd>
335+
<!---->
336+
337+
<dt id="SVG11">[SVG11]
338+
339+
</dt><dd>Erik Dahlström; et al. <a href="http://www.w3.org/TR/2010/WD-SVG11-20100622"><cite>Scalable Vector
340+
Graphics (SVG) 1.1 (Second Edition).</cite></a> 22 June 2010. W3C Working
341+
Draft. (Work in progress.) URL: <a href="http://www.w3.org/TR/2010/WD-SVG11-20100622">http://www.w3.org/TR/2010/WD-SVG11-20100622</a>
342+
</dd>
343+
<!---->
344+
</dl>
345+
<!--end-informative-->
346+
<!-- Keep this comment at the end of the file
347+
Local variables:
348+
mode: sgml
349+
sgml-declaration:"~/SGML/HTML4.decl"
350+
sgml-default-doctype-name:"html"
351+
sgml-minimize-attributes:t
352+
sgml-nofill-elements:("pre" "style" "br")
353+
End:
354+
-->
355+
</body></html>

0 commit comments

Comments
 (0)