Skip to content

Commit e330aa0

Browse files
committed
[css-forms-1][editorial] fixes for FPWD
1 parent 20724f3 commit e330aa0

File tree

1 file changed

+30
-20
lines changed

1 file changed

+30
-20
lines changed

css-forms-1/Overview.bs

+30-20
Original file line numberDiff line numberDiff line change
@@ -2,16 +2,26 @@
22
Title: CSS Form Control Styling Level 1
33
Shortname: css-forms-1
44
Repository: w3c/csswg-drafts
5+
Prepare for TR: yes
6+
Date: 2025-03-25
57
URL: https://drafts.csswg.org/css-forms-1
8+
TR: https://www.w3.org/TR/css-forms-1
69
Editor: Tim Nguyen, w3cid 137443, Apple Inc. https://apple.com/, [email protected]
710
Abstract: This CSS Module defines various ways of styling form controls and their different parts.
811
Group: csswg
9-
Status: UD
12+
Status: FPWD
1013
Work Status: Exploring
1114
Level: None
1215
Markup Shorthands: css yes, markdown yes
1316
</pre>
1417

18+
<pre class="link-defaults">
19+
spec:css-forms-1; type:selector; for:/; text:::field-text
20+
spec:css-forms-1; type:selector; for:/; text:::clear-icon
21+
spec:css-forms-1; type:value; for:/; text:::placeholder
22+
23+
</pre>
24+
1525
# Introduction # {#intro}
1626

1727
<em>This section is non-normative.</em>
@@ -28,7 +38,7 @@ Markup Shorthands: css yes, markdown yes
2838
implementing custom controls from scratch, which was a lot of work,
2939
hard to get right, and often broke either accessibility or platform conventions.
3040

31-
# Opting Into [=Basic Appearance=]: the ''appearance: base'' value
41+
# Opting Into [=Basic Appearance=]: the ''appearance: base'' value {#appearance}
3242

3343
ISSUE: Move definition of ''appearance'' here.
3444

@@ -71,7 +81,7 @@ Markup Shorthands: css yes, markdown yes
7181

7282
For HTML form controls specifically, these principles are applied through the required user agent stylesheet defined in [[#basic-appearance-stylesheet]].
7383

74-
## Examples
84+
## Examples {#ex-appearance}
7585

7686
ISSUE: Refine these examples through implementation, experimentation, bikeshedding and improvements to the user agent stylesheet.
7787

@@ -87,14 +97,14 @@ Markup Shorthands: css yes, markdown yes
8797

8898
NOTE: The form layout used by the following examples is not detailed.
8999

90-
### Default User Agent Colors
100+
### Default User Agent Colors {#colors}
91101

92102
Here are the [=basic appearance=] colors inheriting respectively the default light and dark mode colors from the root element:
93103

94104
<img src="images/base-screenshot.png" style="width: 50%; height: auto;" alt="Screenshot of the basic appearance with a light color scheme">
95105
<img src="images/base-screenshot-dark.png" style="width: 50%; height: auto;" alt="Screenshot of the basic appearance with a dark color scheme">
96106

97-
### Color/Font Customization
107+
### Color/Font Customization {#custom}
98108

99109
Here are some examples of customization being done on top of the [=basic appearance=]:
100110

@@ -131,9 +141,9 @@ Markup Shorthands: css yes, markdown yes
131141
<img src="images/base-example-2.png" style="width: 100%; height: auto;" alt="Screenshot of a customized basic appearance with green text and a black background">
132142
</div>
133143

134-
# Styling Pickers
144+
# Styling Pickers {#pickers}
135145

136-
## The ''::picker()'' pseudo-element
146+
## The ''::picker()'' pseudo-element {#picker-pseudo}
137147

138148
The <dfn>::picker()</dfn> pseudo-element represents the part of the form control that pops out of the page.
139149

@@ -288,7 +298,7 @@ Markup Shorthands: css yes, markdown yes
288298

289299
ISSUE: Add illustrations.
290300

291-
## Picker Opener Icon: the ''::picker-icon'' pseudo-element
301+
## Picker Opener Icon: the ''::picker-icon'' pseudo-element {#picker-icon}
292302

293303
The <dfn>::picker-icon</dfn> pseudo-element represents the part of the control that represents the icon denoting the presence of the picker.
294304
It is only generated when the [=originating element=] has [=basic appearance=] and if it opens a picker.
@@ -312,7 +322,7 @@ Markup Shorthands: css yes, markdown yes
312322
<pre class="lang-css">::file-selector-button { border: 3px solid green }</pre>
313323
</div>
314324

315-
## Styling Checkmarks: the ''::checkmark'' pseudo-element
325+
## Styling Checkmarks: the ''::checkmark'' pseudo-element {#checkmark}
316326

317327
The <dfn>::checkmark</dfn> pseudo-element represents an indicator of whether the item is checked, and is present on checkboxes, radios, and option elements.
318328

@@ -387,7 +397,7 @@ Markup Shorthands: css yes, markdown yes
387397
## Styling Parts for Text Fields: the ''::field-text'' and ''::clear-icon'' pseudo-elements ## {#field-pseudos}
388398

389399
<dl export>
390-
<dt><dfn>''::placeholder''</dfn>
400+
<dt><dfn>::placeholder</dfn>
391401
<dd>
392402
The ''::placeholder'' pseudo-element represents
393403
the portion of the <{input}> that contains the placeholder text.
@@ -560,7 +570,7 @@ Markup Shorthands: css yes, markdown yes
560570

561571
# Pseudo-Classes # {#pseudo-classes}
562572

563-
## Targeting Different Meter States: the '':low-value'' / '':high-value'' / '':optimal-value'' pseudo-classes
573+
## Targeting Different Meter States: the '':low-value'' / '':high-value'' / '':optimal-value'' pseudo-classes {#meter-values}
564574

565575
ISSUE(11336): Make sure this is able to replicate UA logic.
566576

@@ -572,11 +582,11 @@ Markup Shorthands: css yes, markdown yes
572582

573583
The <dfn>:optimal-value</dfn> pseudo-class matches on a <{meter}> element when its value is in the range determined by the `optimum` / `low` / `high` HTML attributes.
574584

575-
## Targeting Selects that are Listboxes
585+
## Targeting Selects that are Listboxes {#selects-listboxes}
576586

577587
ISSUE(7422): Define something.
578588

579-
# The ''control-value()'' function
589+
# The ''control-value()'' function {#control-value}
580590

581591
ISSUE: This is not ready for implementation, file an issue regarding this.
582592

@@ -654,7 +664,7 @@ Markup Shorthands: css yes, markdown yes
654664

655665
ISSUE(11837): Color input styles need refining.
656666

657-
## Basics
667+
## Basics {#stylesheet-basics}
658668

659669
```css
660670
input,
@@ -671,7 +681,7 @@ progress {
671681
}
672682
```
673683

674-
## Layout
684+
## Layout {#stylesheet-layout}
675685
```css
676686
input:not([type=file], [type=range]),
677687
textarea,
@@ -686,7 +696,7 @@ progress {
686696
}
687697
```
688698

689-
## Sliders
699+
## Sliders {#stylesheet-sliders}
690700

691701
ISSUE: Refine meter, progress, switch and range input styling.
692702

@@ -710,7 +720,7 @@ ISSUE: Refine meter, progress, switch and range input styling.
710720
}
711721
```
712722

713-
## Checkboxes & radios
723+
## Checkboxes & radios {#stylesheet-checkbox-radio}
714724

715725
```css
716726
input:is([type=checkbox]:not([switch]), [type=radio]) {
@@ -738,7 +748,7 @@ input[type=radio]:checked::checkmark {
738748
width: 100%;
739749
}
740750
```
741-
## Selects & buttons
751+
## Selects & buttons {#stylesheet-select-button}
742752

743753
```css
744754
select {
@@ -900,7 +910,7 @@ select::picker-icon {
900910
block-start span-inline-start;
901911
}
902912
```
903-
<h2 class="no-num non-normative" id="changes">Appendix B: Explorations</h2>
913+
<h2 class="no-num non-normative" id="explorations">Appendix B: Explorations</h2>
904914
905915
## Basic Styling Proposals ## {#ideas}
906916
@@ -1039,7 +1049,7 @@ Issue: Insert &lt;select> and &lt;datalist> styling proposal and/or whiteboard p
10391049
All options are contain:paint and BFCs.
10401050
10411051
1042-
## Input UI Examples ## {#examples}
1052+
## Input UI Examples ## {#ui-examples}
10431053
10441054
10451055
This section catalogues as many input UI examples as we can screenshot,

0 commit comments

Comments
 (0)