Skip to content

Commit 295a8b1

Browse files
committed
[css-values] Relax unnecessary restrictions on <custom-ident> per <http://lists.w3.org/Archives/Public/www-style/2014Mar/0120.html>.
1 parent e9e696a commit 295a8b1

2 files changed

Lines changed: 47 additions & 18 deletions

File tree

css-values/Overview.html

Lines changed: 30 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@
1111
rel=dcterms.rights>
1212
<meta content="CSS Values and Units Module Level 3" name=dcterms.title>
1313
<meta content=text name=dcterms.type>
14-
<meta content=2013-12-18 name=dcterms.date>
14+
<meta content=2014-03-06 name=dcterms.date>
1515
<meta content="Håkon Wium Lie" name=dcterms.creator>
1616
<meta content="Tab Atkins" name=dcterms.creator>
1717
<meta content="Elika J. Etemad" name=dcterms.creator>
@@ -42,11 +42,11 @@
4242
<h1 class=p-name>CSS Values and Units Module Level 3</h1>
4343

4444
<h2 class="no-num no-toc">Editor's Draft <span class=dt-updated><span
45-
class=value title=20131218>18 December 2013</span></span></h2>
45+
class=value title=20140306> 6 March 2014</span></span></h2>
4646

4747
<dl>
4848
<dt>This version:</dt>
49-
<!--<dd><a class="u-url" href="http://dev.w3.org/csswg/css-values/">http://www.w3.org/TR/2013/CR-css3-values-20131218/</a></dd>-->
49+
<!--<dd><a class="u-url" href="http://dev.w3.org/csswg/css-values/">http://www.w3.org/TR/2014/CR-css3-values-20140306/</a></dd>-->
5050

5151
<dd><a class=u-url
5252
href="http://dev.w3.org/csswg/css-values/">http://dev.w3.org/csswg/css-values/</a>
@@ -97,7 +97,7 @@ <h2 class="no-num no-toc">Editor's Draft <span class=dt-updated><span
9797
<!--begin-copyright-->
9898
<p class=copyright><a
9999
href="http://www.w3.org/Consortium/Legal/ipr-notice#Copyright"
100-
rel=license>Copyright</a> © 2013 <a href="http://www.w3.org/"><abbr
100+
rel=license>Copyright</a> © 2014 <a href="http://www.w3.org/"><abbr
101101
title="World Wide Web Consortium">W3C</abbr></a><sup>®</sup> (<a
102102
href="http://www.csail.mit.edu/"><abbr
103103
title="Massachusetts Institute of Technology">MIT</abbr></a>, <a
@@ -680,19 +680,35 @@ <h3 id=custom-idents><span class=secno>3.2. </span> Author-defined
680680
<p> Some properties accept arbitrary author-defined identifiers as a
681681
component value. This generic data type is denoted by <dfn
682682
id=identifier-value><var>&lt;custom-ident></var></dfn>, and represents any
683-
valid CSS <a href="#identifier"><i>identifier</i></a> that does not
684-
otherwise appear as a pre-defined keyword in that property's value
683+
valid CSS <a href="#identifier"><i>identifier</i></a> that would not be
684+
misinterpreted as a pre-defined keyword in that property's value
685685
definition. Such identifiers are fully case-sensitive, even in the ASCII
686686
range (e.g. ‘<code class=css>example</code>’ and ‘<code
687687
class=css>EXAMPLE</code>’ are two different, unrelated user-defined
688688
identifiers).
689689

690690
<p> The <a href="#common-keywords">CSS-wide keywords</a> are not valid <a
691-
href="#identifier-value"><var>&lt;custom-ident>s</var></a>. The ‘<code
691+
href="#identifier-value"><var>&lt;custom-ident></var></a>s. The ‘<code
692692
class=css>default</code>’ keyword is reserved and is also not a valid <a
693-
href="#identifier-value"><var>&lt;custom-ident>s</var></a>.
694-
695-
<p> Reserved keywords are reserved in all ASCII case permutations.
693+
href="#identifier-value"><var>&lt;custom-ident></var></a>.
694+
695+
<p> Specifications using ‘<a href="#identifier-value"><code
696+
class=css>&lt;custom-ident></code></a>’ should specify clearly what
697+
other keywords are excluded from <a
698+
href="#identifier-value"><var>&lt;custom-ident></var></a>—for example by
699+
saying that any pre-defined keywords in that property's value definition
700+
are excluded. As a general rule, an identifier that could be interpreted
701+
as a pre-defined keyword in any position or multiplication of the <a
702+
href="#identifier-value"><var>&lt;custom-ident></var></a> component value
703+
is excluded, and is invalid as a <a
704+
href="#identifier-value"><var>&lt;custom-ident></var></a> matching to that
705+
component value even in positions where its use would be technically
706+
unambiguous. For example, if a keyword could be misparsed when specified
707+
as the first item of a ‘<a href="#identifier-value"><code
708+
class=css><var>&lt;custom-ident></var>+</code></a>’ list, it is invalid
709+
when specified in any position in that list.
710+
711+
<p> Excluded keywords are excluded in all ASCII case permutations.
696712

697713
<h3 id=strings><span class=secno>3.3. </span> Quoted Strings: the ‘<a
698714
href="#string-value"><code class=css>&lt;string></code></a>’ type</h3>
@@ -2440,10 +2456,10 @@ <h3 class=no-num id=normative-references>Normative references</h3>
24402456
<dt id=ref-CSS3BG>[CSS3BG]
24412457

24422458
<dd>Bert Bos; Elika J. Etemad; Brad Kemper. <a
2443-
href="http://www.w3.org/TR/2012/CR-css3-background-20120724/"><cite>CSS
2444-
Backgrounds and Borders Module Level 3.</cite></a> 24 July 2012. W3C
2445-
Candidate Recommendation. (Work in progress.) URL: <a
2446-
href="http://www.w3.org/TR/2012/CR-css3-background-20120724/">http://www.w3.org/TR/2012/CR-css3-background-20120724/</a>
2459+
href="http://www.w3.org/TR/2014/WD-css3-background-20140204/"><cite>CSS
2460+
Backgrounds and Borders Module Level 3.</cite></a> 4 February 2014. W3C
2461+
Last Call Working Draft. (Work in progress.) URL: <a
2462+
href="http://www.w3.org/TR/2014/WD-css3-background-20140204/">http://www.w3.org/TR/2014/WD-css3-background-20140204/</a>
24472463
</dd>
24482464
<!---->
24492465

css-values/Overview.src.html

Lines changed: 17 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -358,18 +358,31 @@ <h3 id='custom-idents'>
358358
Some properties accept arbitrary author-defined identifiers as a component value.
359359
This generic data type is denoted by <dfn id="identifier-value"><var>&lt;custom-ident></var></dfn>,
360360
and represents any valid CSS <i>identifier</i>
361-
that does not otherwise appear as a pre-defined keyword in that property's value definition.
361+
that would not be misinterpreted as a pre-defined keyword in that property's value definition.
362362
Such identifiers are fully case-sensitive,
363363
even in the ASCII range
364364
(e.g. ''example'' and ''EXAMPLE'' are two different, unrelated user-defined identifiers).
365365

366366
<p>
367-
The <a href='#common-keywords'>CSS-wide keywords</a> are not valid <var>&lt;custom-ident>s</var>.
367+
The <a href='#common-keywords'>CSS-wide keywords</a> are not valid <var>&lt;custom-ident></var>s.
368368
The ''default'' keyword is reserved
369-
and is also not a valid <var>&lt;custom-ident>s</var>.
369+
and is also not a valid <var>&lt;custom-ident></var>.
370370

371371
<p>
372-
Reserved keywords are reserved in all ASCII case permutations.
372+
Specifications using ''&lt;custom-ident>'' should specify clearly
373+
what other keywords are excluded from <var>&lt;custom-ident></var>&mdash;for
374+
example by saying that any pre-defined keywords in that property's value definition are excluded.
375+
As a general rule, an identifier that could be interpreted as a pre-defined keyword
376+
in any position or multiplication of the <var>&lt;custom-ident></var> component value
377+
is excluded,
378+
and is invalid as a <var>&lt;custom-ident></var> matching to that component value
379+
even in positions where its use would be technically unambiguous.
380+
For example, if a keyword could be misparsed when specified
381+
as the first item of a ''<var>&lt;custom-ident></var>+'' list,
382+
it is invalid when specified in any position in that list.
383+
384+
<p>
385+
Excluded keywords are excluded in all ASCII case permutations.
373386

374387

375388
<h3 id="strings">

0 commit comments

Comments
 (0)