Skip to content

Commit 3672fd3

Browse files
committed
Add issue about naming.
1 parent 4debe7e commit 3672fd3

2 files changed

Lines changed: 11 additions & 2 deletions

File tree

css-variables/Overview.html

Lines changed: 9 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -22,14 +22,14 @@
2222

2323
<h1>CSS Variables Module Level 1</h1>
2424

25-
<h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 11 February
25+
<h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 28 February
2626
2012</h2>
2727

2828
<dl>
2929
<dt>This version:
3030

3131
<dd><a
32-
href="http://www.w3.org/TR/2012/ED-css-variables-20120211/">http://dev.w3.org/csswg/css-variables/</a>
32+
href="http://www.w3.org/TR/2012/ED-css-variables-20120228/">http://dev.w3.org/csswg/css-variables/</a>
3333
<!--<dt>Latest version:
3434
<dd><a href="http://www.w3.org/TR/css-variables/">http://www.w3.org/TR/css-variables/</a>-->
3535

@@ -285,6 +285,13 @@ <h2 id=defining-variables><span class=secno>2. </span> Defining Variables
285285
to them beyond the bare minimum that comes from them being valid
286286
properties.
287287

288+
<p class=issue>I'm using data-foo for their rough parallel (in terms of
289+
being completely user-extensible) with the data-* attributes in HTML.
290+
Might another name be better? Suggestions so far are "var-foo", "$foo",
291+
and "var(foo)" (the latter two are intended to directly resemble the usage
292+
of the variable). Obviously, usage of the variable should match, as
293+
"var(foo)" or "$foo" or whatever.
294+
288295
<p>The valid possible values of a data property are almost completely
289296
unrestricted. A data property can contain anything that is valid according
290297
to the <code>value</code> production in the <a

css-variables/Overview.src.html

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -113,6 +113,8 @@ <h2 id="defining-variables">
113113

114114
<p><em>Any</em> property name starting with the prefix "data-" is a <i>data property</i>. Data properties are defined to be valid but meaningless as they are meant solely for allowing authors to pass custom data around their page, similar to the <a href="http://www.whatwg.org/specs/web-apps/current-work/multipage/elements.html#embedding-custom-non-visible-data-with-the-data-*-attributes">custom data attributes</a> in HTML. Other specifications and user agents must not assign a particular meaning to data properties or attach a specific effect to them beyond the bare minimum that comes from them being valid properties.</p>
115115

116+
<p class='issue'>I'm using data-foo for their rough parallel (in terms of being completely user-extensible) with the data-* attributes in HTML. Might another name be better? Suggestions so far are "var-foo", "$foo", and "var(foo)" (the latter two are intended to directly resemble the usage of the variable). Obviously, usage of the variable should match, as "var(foo)" or "$foo" or whatever.</p>
117+
116118
<p>The valid possible values of a data property are almost completely unrestricted. A data property can contain anything that is valid according to the <code>value</code> production in the <a href="http://www.w3.org/TR/CSS2/syndata.html#tokenization">CSS Core Grammar</a>. The values do not have to correspond to any existing CSS values, as they are not evaluated except to replace variables occuring within them until they are actually referenced in a normal property with a variable.</p>
117119

118120
<p>This specification reserves the use of all function tokens starting with the prefix "data" within data properties. Authors must not use any such functions except as defined in this specification or future updates. If a data property contains such a function, it must match the grammar defined in this specification or future updates; the use of such a function that does not follow the grammar, or that utilizes such a function that is not yet defined, makes the data property invalid and it must be ignored.</p>

0 commit comments

Comments
 (0)