Skip to content

Commit 636be6b

Browse files
author
Tantek Çelik
committed
some CSSWG doc template updates,
remove explicit normative statements, grammar fixes, incorporate :indeterminate defn per dependencies overview/expectation and update/simplify dependencies accordingly, drop ::selection as dropped from Selectors, add explicit at-risk notes inline with such features.
1 parent b0f0e5b commit 636be6b

2 files changed

Lines changed: 295 additions & 154 deletions

File tree

‎css3-ui/Overview.html‎

Lines changed: 84 additions & 73 deletions
Original file line numberDiff line numberDiff line change
@@ -42,15 +42,15 @@
4242
src="http://www.w3.org/Icons/w3c_home" width=72> </a>
4343
<h1>CSS Basic User Interface Module Level 3</h1>
4444

45-
<h2 class="no-num no-toc" id=longstatus-date>W3C Working Draft 11 January
45+
<h2 class="no-num no-toc" id=longstatus-date>W3C Working Draft 12 January
4646
2012</h2>
4747

4848
<dl>
4949
<dt>This version:</dt>
5050
<!-- TR "This version". Update "WD" below as needed to CR/PR/REC -->
5151

52-
<dd><a href="http://www.w3.org/TR/2012/WD-css3-ui-20120111">
53-
http://www.w3.org/TR/2012/WD-css3-ui-20120111</a></dd>
52+
<dd><a href="http://www.w3.org/TR/2012/WD-css3-ui-20120112">
53+
http://www.w3.org/TR/2012/WD-css3-ui-20120112</a></dd>
5454
<!-- editor's draft "This version" -->
5555
<!-- <dd><a href="http://dev.w3.org/csswg/css3-ui/">
5656
http://dev.w3.org/csswg/css3-ui/</a>
@@ -61,20 +61,28 @@ <h2 class="no-num no-toc" id=longstatus-date>W3C Working Draft 11 January
6161
<dd><a
6262
href="http://www.w3.org/TR/css3-ui">http://www.w3.org/TR/css3-ui</a>
6363

64-
<dt>Latest editor's draft:
64+
<dt>Editor's draft:
6565

6666
<dd><a
6767
href="http://dev.w3.org/csswg/css3-ui/">http://dev.w3.org/csswg/css3-ui/</a>
6868

69+
<dt>Previous version:
70+
71+
<dd><a href="http://www.w3.org/TR/2004/CR-css3-ui-20040511/"
72+
rel=previous>http://www.w3.org/TR/2004/CR-css3-ui-20040511/</a>
73+
6974
<dt>Issues list:
7075

7176
<dd><a
7277
href="http://wiki.csswg.org/spec/css3-ui">http://wiki.csswg.org/spec/css3-ui</a>
7378

74-
<dt>Previous version:
79+
<dt>Discussion:
7580

7681
<dd><a
77-
href="http://www.w3.org/TR/2004/CR-css3-ui-20040511/">http://www.w3.org/TR/2004/CR-css3-ui-20040511/</a>
82+
href="mailto:www-style@w3.org?subject=%5Bcss3-ui%5D%20feedback">www-style@w3.org</a>
83+
with subject line &ldquo;<kbd>[css3-ui] <var>&hellip; message topic
84+
&hellip;</var></kbd>&rdquo; (<a
85+
href="http://lists.w3.org/Archives/Public/www-style/">archives</a>)
7886

7987
<dt>Editor:
8088

@@ -283,7 +291,8 @@ <h3 class="no-num no-toc" id=atrisk>Features at risk</h3>
283291
284292
Not at risk:
285293
<li>CSS2.1: :hover :active :focus</li>
286-
<li>Selectors: :enabled :disabled :checked :indeterminate ::selection</li>
294+
<li>Selectors: :enabled :disabled :checked</li>
295+
<li>:indeterminate implemented by FF3.6, IE9, Opera 10.6, Saf3</li>
287296
288297
<li>box-sizing implemented by IE5/Mac, Opera
289298
-moz-box-sizing implemented by Mozilla
@@ -402,9 +411,7 @@ <h2 class="no-num no-toc" id=contents>Table of contents</h2>
402411
<li><a href="#classes-of-products"><span class=secno>2.2. </span>Classes
403412
of products</a>
404413

405-
<li><a href="#profiles"><span class=secno>2.3. </span>Profiles</a>
406-
407-
<li><a href="#extensions"><span class=secno>2.4. </span>Extensions</a>
414+
<li><a href="#extensions"><span class=secno>2.3. </span>Extensions</a>
408415
</ul>
409416

410417
<li><a href="#dependencies-on-other-modules"><span class=secno>3.
@@ -419,19 +426,23 @@ <h2 class="no-num no-toc" id=contents>Table of contents</h2>
419426
<li><a href="#active"><span class=secno>4.1.1. </span>:active
420427
details</a>
421428

422-
<li><a href="#pseudo-default"><span class=secno>4.1.2.
429+
<li><a href="#indeterminate"><span class=secno>4.1.2. </span> The
430+
indeterminate-value pseudo-class &lsquo;<code
431+
class=css>:indeterminate</code>&rsquo;</a>
432+
433+
<li><a href="#pseudo-default"><span class=secno>4.1.3.
423434
</span>:default</a>
424435

425-
<li><a href="#pseudo-validity"><span class=secno>4.1.3.
436+
<li><a href="#pseudo-validity"><span class=secno>4.1.4.
426437
</span><span>:valid</span> and <span>:invalid</span></a>
427438

428-
<li><a href="#pseudo-range"><span class=secno>4.1.4.
439+
<li><a href="#pseudo-range"><span class=secno>4.1.5.
429440
</span><span>:in-range</span> and <span>:out-of-range</span></a>
430441

431-
<li><a href="#pseudo-required-value"><span class=secno>4.1.5.
442+
<li><a href="#pseudo-required-value"><span class=secno>4.1.6.
432443
</span><span>:required</span> and <span>:optional</span></a>
433444

434-
<li><a href="#pseudo-ro-rw"><span class=secno>4.1.6.
445+
<li><a href="#pseudo-ro-rw"><span class=secno>4.1.7.
435446
</span><span>:read-only</span> and <span>:read-write</span></a>
436447
</ul>
437448

@@ -570,8 +581,6 @@ <h2 class="no-num no-toc" id=contents>Table of contents</h2>
570581

571582
<h2 id=intro><span class=secno>1. </span>Introduction</h2>
572583

573-
<p>This section is <em>normative</em>.
574-
575584
<p> CSS3 is a set of modules, divided up and profiled in order to simplify
576585
the specification, and to allow implementors the flexibility of supporting
577586
the particular modules appropriate for their implementations.
@@ -618,8 +627,6 @@ <h3 id=purpose><span class=secno>1.1. </span>Purpose</h3>
618627

619628
<h2 id=conformance><span class=secno>2. </span>Conformance</h2>
620629

621-
<p>This section is <em>normative</em>.
622-
623630
<h3 id=definitions><span class=secno>2.1. </span>Definitions</h3>
624631

625632
<p>The key words <span class=index-def id=must title=MUST>"MUST"</span>,
@@ -663,17 +670,12 @@ <h3 id=classes-of-products><span class=secno>2.2. </span>Classes of
663670
content languages that contain forms controls or are intended for user
664671
interaction
665672

666-
<li>User agents that implement one or more levels, modules and or profiles
667-
of CSS (e.g. <a href="#CSS1" rel=biblioentry>[CSS1]<!--{{CSS1}}--></a>,
668-
<a href="#CSS21" rel=biblioentry>[CSS21]<!--{{!CSS21}}--></a>)
673+
<li>User agents that implement one or more levels or modules of CSS (e.g.
674+
<a href="#CSS1" rel=biblioentry>[CSS1]<!--{{CSS1}}--></a>, <a
675+
href="#CSS21" rel=biblioentry>[CSS21]<!--{{!CSS21}}--></a>)
669676
</ul>
670677

671-
<h3 id=profiles><span class=secno>2.3. </span>Profiles</h3>
672-
673-
<p>This specification contains a number of informative profiles. These
674-
profiles are not mandatory for conformance.
675-
676-
<h3 id=extensions><span class=secno>2.4. </span>Extensions</h3>
678+
<h3 id=extensions><span class=secno>2.3. </span>Extensions</h3>
677679

678680
<p>This specification does not define any explicit extension mechanisms. If
679681
an implementation needs to extend the functionality of this specification,
@@ -686,16 +688,7 @@ <h3 id=extensions><span class=secno>2.4. </span>Extensions</h3>
686688
<h2 id=dependencies-on-other-modules><span class=secno>3.
687689
</span>Dependencies on other modules</h2>
688690

689-
<p>This section is <em>normative</em>.
690-
691-
<p>This CSS3 module depends on the following other specifications. Some of
692-
these specifications may be in their "Candidate Recommendation" phase. If
693-
this module depends on feature or portion of such a specification which
694-
ends up being dropped during their "CR" phase(s), then such feature or
695-
portion thereof will be presumed to be incorporated into this
696-
specification. For example, if the ":indeterminate" selector was dropped
697-
from Selectors, then the definition and description of ":indeterminate"
698-
would be incorporated into the next draft of this specification.
691+
<p> This CSS3 module depends on the following other specifications.
699692

700693
<ul>
701694
<li><a href="#SELECT" rel=biblioentry>[SELECT]<!--{{!SELECT}}--></a>
@@ -736,8 +729,6 @@ <h2 id=dependencies-on-other-modules><span class=secno>3.
736729
<h2 id=user-interface-selectors><span class=secno>4. </span>User Interface
737730
Selectors</h2>
738731

739-
<p>This section is <em>normative</em>.
740-
741732
<h3 id=pseudo-classes><span class=secno>4.1. </span>User interface states:
742733
pseudo-classes</h3>
743734

@@ -784,6 +775,22 @@ <h4 id=active><span class=secno>4.1.1. </span>:active details</h4>
784775
clarified to apply only to the primary or primary activation button
785776
(typically the "left" mouse button), and any aliases thereof.
786777

778+
<h4 id=indeterminate><span class=secno>4.1.2. </span> The
779+
indeterminate-value pseudo-class &lsquo;<code
780+
class=css>:indeterminate</code>&rsquo;</h4>
781+
782+
<p>The <code>:indeterminate</code> pseudo-class applies to UI elements
783+
whose value is in an indeterminate state. For example, radio and checkbox
784+
elements can be toggled between checked and unchecked states, but are
785+
sometimes in an indeterminate state, neither checked nor unchecked.
786+
Similarly a progress meter can be in an indeterminate state when the
787+
percent completion is unknown.
788+
789+
<p>Like the <code>:checked</code> pseudo-class, <code>:indeterminate</code>
790+
applies to all media. Components of a radio-group initialized with no
791+
pre-selected choice, for example, would be <code>:indeterminate</code>
792+
even in a static display.
793+
787794
<h4 class="no-num no-toc" id=new-user-interface-state-pseudo-classes>New
788795
user interface state pseudo-classes</h4>
789796

@@ -816,18 +823,18 @@ <h4 class="no-num no-toc" id=new-user-interface-state-pseudo-classes>New
816823
XForms <a href="#XFORMS11"
817824
rel=biblioentry>[XFORMS11]<!--{{XFORMS11}}--></a>.
818825

819-
<h4 id=pseudo-default><span class=secno>4.1.2. </span>:default</h4>
826+
<h4 id=pseudo-default><span class=secno>4.1.3. </span>:default</h4>
820827

821828
<p>The :default selector applies to the one or more UI elements that are
822-
the default among a set of similar elements. Typically applies to context
823-
menu items, buttons and select lists/menus.
829+
the default among a set of similar elements. This selector typically
830+
applies to context menu items, buttons, and select lists/menus.
824831

825832
<p> One example is the default submit button among a set of buttons.
826833
Another example is the default option from a popup menu. Multiple elements
827834
in a select-many group could have multiple :default elements, like a
828835
selection of pizza toppings for example.
829836

830-
<h4 id=pseudo-validity><span class=secno>4.1.3. </span><span
837+
<h4 id=pseudo-validity><span class=secno>4.1.4. </span><span
831838
id=pseudo-valid>:valid</span> and <span id=pseudo-invalid>:invalid</span></h4>
832839

833840
<p>An element is :valid or :invalid when it is, respectively, valid or
@@ -838,7 +845,7 @@ <h4 id=pseudo-validity><span class=secno>4.1.3. </span><span
838845
from an element which otherwise has no constraints. Such an element would
839846
always be :valid.
840847

841-
<h4 id=pseudo-range><span class=secno>4.1.4. </span><span
848+
<h4 id=pseudo-range><span class=secno>4.1.5. </span><span
842849
id=pseudo-in-range>:in-range</span> and <span
843850
id=pseudo-out-of-range>:out-of-range</span></h4>
844851

@@ -853,7 +860,7 @@ <h4 id=pseudo-range><span class=secno>4.1.4. </span><span
853860
a value of "E" that happens to be presented as a popup menu that only has
854861
choices "A", "B" and "C".
855862

856-
<h4 id=pseudo-required-value><span class=secno>4.1.5. </span><span
863+
<h4 id=pseudo-required-value><span class=secno>4.1.6. </span><span
857864
id=pseudo-required>:required</span> and <span
858865
id=pseudo-optional>:optional</span></h4>
859866

@@ -862,7 +869,7 @@ <h4 id=pseudo-required-value><span class=secno>4.1.5. </span><span
862869
submitted. Elements that are not form elements are neither required nor
863870
optional.
864871

865-
<h4 id=pseudo-ro-rw><span class=secno>4.1.6. </span><span
872+
<h4 id=pseudo-ro-rw><span class=secno>4.1.7. </span><span
866873
id=pseudo-read-only>:read-only</span> and <span
867874
id=pseudo-read-write>:read-write</span></h4>
868875

@@ -875,20 +882,7 @@ <h4 id=pseudo-ro-rw><span class=secno>4.1.6. </span><span
875882
<h3 id=pseudo-elements><span class=secno>4.2. </span>User interface element
876883
fragments: pseudo-elements</h3>
877884

878-
<p>Selectors (<a href="#SELECT"
879-
rel=biblioentry>[SELECT]<!--{{!SELECT}}--></a>, section 7.3) also defines
880-
one user interface element fragment selector:
881-
882-
<ul>
883-
<li id=pseudo-selection><a
884-
href="http://www.w3.org/TR/css3-selectors/#selection">::selection</a>
885-
</ul>
886-
887-
<p>This pseudo-element is included in this specification as defined by <a
888-
href="#SELECT" rel=biblioentry>[SELECT]<!--{{!SELECT}}--></a> by
889-
reference.
890-
891-
<p>In addition to the above-mentioned pseudo-element, this specification
885+
<p> In addition to the above-mentioned pseudo-element, this specification
892886
introduces four new pseudo-elements to provide access to additional user
893887
interface element fragments.
894888

@@ -906,6 +900,9 @@ <h3 id=pseudo-elements><span class=secno>4.2. </span>User interface element
906900
user interface fragments as defined by XForms <a href="#XFORMS11"
907901
rel=biblioentry>[XFORMS11]<!--{{XFORMS11}}--></a>.
908902

903+
<p class=note> Note: The ::value, ::choices, ::repeat-item, and
904+
::repeat-index pseudo-elements are all at risk.
905+
909906
<h4 id=pseudo-value><span class=secno>4.2.1. </span>::value</h4>
910907

911908
<p>A form element may contain both a label for its data value, and the data
@@ -1066,8 +1063,6 @@ <h4 id=pseudo-repeat-index><span class=secno>4.2.4. </span>::repeat-index</h4>
10661063

10671064
<h2 id=element-icons><span class=secno>5. </span>Element icons</h2>
10681065

1069-
<p>This section is <em>normative</em>.
1070-
10711066
<h3 id=content-property-addition><span class=secno>5.1. </span><span
10721067
class=property>&lsquo;<a href="#content"><code
10731068
class=property>content</code></a>&rsquo;</span> property addition</h3>
@@ -1131,6 +1126,9 @@ <h3 id=content-property-addition><span class=secno>5.1. </span><span
11311126
rel=biblioentry>[CSS3GENCON]<!--{{CSS3GENCON}}--></a> will include and
11321127
superset this functionality. </em>
11331128

1129+
<p class=note> Note: The &lsquo;<a href="#icon"><code
1130+
class=property>icon</code></a>&rsquo; value is at risk.
1131+
11341132
<h3 id=icon-property><span class=secno>5.2. </span><span
11351133
class=property>&lsquo;<a href="#icon"><code
11361134
class=property>icon</code></a>&rsquo;</span> property</h3>
@@ -1231,9 +1229,10 @@ <h4 class="no-num no-toc" id=representing-elements-with-icons>Representing
12311229
</code></pre>
12321230
</div>
12331231

1234-
<h2 id=box-model-addition><span class=secno>6. </span>Box Model addition</h2>
1232+
<p class=note> Note: The &lsquo;<a href="#icon"><code
1233+
class=property>icon</code></a>&rsquo; property is at risk.
12351234

1236-
<p>This section is <em>normative</em>.
1235+
<h2 id=box-model-addition><span class=secno>6. </span>Box Model addition</h2>
12371236

12381237
<h3 id=box-sizing><span class=secno>6.1. </span><span
12391238
class=property>&lsquo;<a href="#box-sizing0"><code
@@ -1381,9 +1380,10 @@ <h5 class="no-num no-toc" id=sample-html-fragment>sample HTML fragment:</h5>
13811380
class=property>box-sizing</code></a>&rsquo;</span>.</div>
13821381
</div>
13831382

1384-
<h2 id=outline-properties><span class=secno>7. </span>Outline properties</h2>
1383+
<p class=note> Note: The &lsquo;<code
1384+
class=property>padding-box</code>&rsquo; value is at risk.
13851385

1386-
<p>This section is <em>normative</em>.
1386+
<h2 id=outline-properties><span class=secno>7. </span>Outline properties</h2>
13871387

13881388
<p>At times, style sheet authors may want to create outlines around visual
13891389
objects such as buttons, active form fields, image maps, etc., to make
@@ -1797,8 +1797,6 @@ <h3 id=outline-offset><span class=secno>7.5. </span><span
17971797
<h2 id=resizing-amp-overflow><span class=secno>8. </span>Resizing &amp;
17981798
Overflow</h2>
17991799

1800-
<p>This section is <em>normative</em>.
1801-
18021800
<p>CSS2.1 provides a mechanism for controlling the appearance of a
18031801
scrolling mechanism (e.g. scrollbars) on block container elements. This
18041802
specification adds to that a mechanism for controlling user resizability
@@ -2257,8 +2255,6 @@ <h5 class="no-num no-toc" id=sample-css-for-a-div>sample CSS for a div:</h5>
22572255
<h2 id=pointing-devices-and-keyboards><span class=secno>9. </span>Pointing
22582256
Devices and Keyboards</h2>
22592257

2260-
<p>This section is <em>normative</em>.
2261-
22622258
<h3 id=pointer-interaction><span class=secno>9.1. </span>Pointer
22632259
interaction</h3>
22642260

@@ -2660,6 +2656,9 @@ <h4 id=nav-index><span class=secno>9.2.1. </span>Sequential navigation
26602656
The key combination "shift-tab" is often used for reverse sequential
26612657
navigation.
26622658

2659+
<p class=note> Note: The &lsquo;<a href="#nav-index0"><code
2660+
class=property>nav-index</code></a>&rsquo; property is at risk.
2661+
26632662
<h4 id=nav-dir><span class=secno>9.2.2. </span>Directional focus
26642663
navigation: the <span class=property>&lsquo;<a href="#nav-up"><code
26652664
class=property>nav-up</code></a>&rsquo;</span>, <span
@@ -2807,6 +2806,13 @@ <h5 class="no-num no-toc" id=example-positioned-buttons>Example:
28072806
relate reasonably to the specified layout.</p>
28082807
</div>
28092808

2809+
<p class=note> Note: The &lsquo;<a href="#nav-up"><code
2810+
class=property>nav-up</code></a>&rsquo;, &lsquo;<a href="#nav-right"><code
2811+
class=property>nav-right</code></a>&rsquo;, &lsquo;<a
2812+
href="#nav-down"><code class=property>nav-down</code></a>&rsquo;, and
2813+
&lsquo;<a href="#nav-left"><code class=property>nav-left</code></a>&rsquo;
2814+
properties are at risk.
2815+
28102816
<h4 id=input-method-editor><span class=secno>9.2.3. </span>Input method
28112817
editor: the <span class=property>&lsquo;<a href="#ime-mode"><code
28122818
class=property>ime-mode</code></a>&rsquo;</span> property</h4>
@@ -2918,6 +2924,9 @@ <h5 class="no-num no-toc" id=example-user-preference>Example: user
29182924
prevent extended characters from passing through a form. Even with IME
29192925
disabled, users can still paste extended characters into a form's fields.
29202926

2927+
<p class=note> Note: The &lsquo;<a href="#ime-mode"><code
2928+
class=property>ime-mode</code></a>&rsquo; property is at risk.
2929+
29212930
<hr title="Separator from footer">
29222931

29232932
<h2 class=no-num id=acknowledgments>Appendix A. Acknowledgments</h2>
@@ -2933,8 +2942,6 @@ <h2 class=no-num id=acknowledgments>Appendix A. Acknowledgments</h2>
29332942

29342943
<h2 class=no-num id=references>Appendix B. Bibiliography</h2>
29352944

2936-
<p>This appendix is <em>normative</em>.
2937-
29382945
<h3 class="no-num no-toc" id=normative-references>Normative References</h3>
29392946
<!--begin-normative-->
29402947
<!-- Sorted by label -->
@@ -3190,6 +3197,10 @@ <h3 class=no-num id=changes-list>List of substantial changes</h3>
31903197
property, and system fonts / extension of the &lsquo;<code
31913198
class=property>font</code>&rsquo; property shorthand.
31923199

3200+
<li>The ::selection pseudo-element has been dropped since it was dropped
3201+
from Selectors after testing found interoperability problems and further
3202+
details to explore/define.
3203+
31933204
<li>&lsquo;<a href="#box-sizing0"><code class=css><span
31943205
class=property>box-sizing</span></code></a>&rsquo; property. Added
31953206
&lsquo;<code class=property>padding-box</code>&rsquo; value.

0 commit comments

Comments
 (0)