Skip to content

Commit 56cd156

Browse files
committed
[css-ui] Editorial: Use "control" instead of "form control"
Fixes #3970.
1 parent d38e270 commit 56cd156

File tree

1 file changed

+15
-15
lines changed

1 file changed

+15
-15
lines changed

css-ui-4/Overview.bs

+15-15
Original file line numberDiff line numberDiff line change
@@ -1745,7 +1745,7 @@ without adverse consequences to compatibility,
17451745
so this specification allows flexibility.
17461746

17471747

1748-
<h2 id="form-styling">Form Control Styling</h2>
1748+
<h2 id="control-styling" oldids="form-styling">Control Styling</h2>
17491749

17501750
<h3 id="appearance-switching" caniuse="css-appearance">Switching appearance</h3>
17511751

@@ -1785,13 +1785,13 @@ so this specification allows flexibility.
17851785
</div>
17861786

17871787
While the way most elements in a document look can be fully controlled by CSS,
1788-
form controls are typically rendered by UAs using native UI controls of the host operating system,
1788+
controls are typically rendered by UAs using native UI controls of the host operating system,
17891789
which can neither be replicated nor styled using CSS.
17901790

17911791
This specification introduces the 'appearance' property
17921792
to provide some control over this behavior.
17931793
In particular, using ''appearance: none'' allows authors
1794-
to suppress the native style of form controls,
1794+
to suppress the native style of controls,
17951795
so that CSS can be used to restyle them.
17961796

17971797
<pre class="propdef">
@@ -1827,17 +1827,17 @@ Animation type: discrete
18271827
<dt><dfn>none</dfn>
18281828
<dd>
18291829
The element is rendered following the usual rules of CSS.
1830-
Replaced elements other than form controls are not affected by this,
1830+
Replaced elements other than controls are not affected by this,
18311831
and remain replaced elements.
1832-
Form controls are <em>not</em> made to look like native controls of the host operating system.
1832+
Controls are <em>not</em> made to look like native controls of the host operating system.
18331833
See [[#appearance-decorative]] and [[#appearance-semantics]] for details.
18341834

18351835
<dt><dfn>auto</dfn>
18361836
<dd>
1837-
UAs may render form controls using native controls of the host operating system
1837+
UAs may render controls using native controls of the host operating system
18381838
or with a look and feel not otherwise expressible in CSS.
18391839

1840-
Elements other than form controls must be rendered as if ''appearance/none'' had been specified.
1840+
Elements other than controls must be rendered as if ''appearance/none'' had been specified.
18411841

18421842
<dt><dfn>button</dfn>
18431843
<dd>
@@ -1883,7 +1883,7 @@ Animation type: discrete
18831883
some of these values need to be promoted to being full blown values
18841884
with effects on arbitrary elements like ''button'',
18851885
or that
1886-
some of these values need to have some side effects on some form controls.
1886+
some of these values need to have some side effects on some controls.
18871887
18881888
18891889
</dl>
@@ -1914,7 +1914,7 @@ Animation type: discrete
19141914
and activating (for example by clicking) the element would toggle the state as usual.
19151915
</div>
19161916

1917-
On form control elements where the computed value is ''appearance/auto'' or one of the <<compat>> values,
1917+
On controls where the computed value is ''appearance/auto'' or one of the <<compat>> values,
19181918
and on any element where the computed value is ''appearance/button'',
19191919
UAs may disregard some CSS properties
19201920
to ensure that the intended appearance is preserved,
@@ -1943,7 +1943,7 @@ Issue: Are there more properties should include in this list?
19431943
Should we remove some?
19441944
Should whitelist the properties that are ok to ignore instead of
19451945
blacklisting those that are not?
1946-
Either way, UAs do ignore some properties when rendering form controls,
1946+
Either way, UAs do ignore some properties when rendering controls,
19471947
so this specification needs to say something about this.
19481948

19491949
For compatibility with legacy content, UAs must also support <dfn property export>-webkit-appearance</dfn>
@@ -1952,7 +1952,7 @@ as a [=legacy name alias=] of 'appearance'.
19521952
<h4 id=appearance-decorative>
19531953
Effects of 'appearance' on Decorative Aspects of Elements</h4>
19541954

1955-
All decorative visual aspects of a form control which are not caused by a CSS style rule
1955+
All decorative visual aspects of a control which are not caused by a CSS style rule
19561956
must be suppressed when the appearance is changed using 'appearance',
19571957
even if the UA's internal representation for this element
19581958
was composed of multiple elements or pseudo elements combined together.
@@ -1965,14 +1965,14 @@ was composed of multiple elements or pseudo elements combined together.
19651965
</div>
19661966

19671967
UAs should include in their User Agent stylesheet style rules
1968-
to give form controls a recognizable shape when 'appearance' is ''appearance/none''.
1968+
to give controls a recognizable shape when 'appearance' is ''appearance/none''.
19691969

19701970
Note: Authors may therefore need to override these UA style rules to get the styling
19711971
they intended.
19721972

19731973
<div class=advisement>
19741974
Authors may find it convenient to use ''all: unset'',
1975-
to get fully unstyled form control elements
1975+
to get fully unstyled controls
19761976
which they can then style as they want without interference from the browser's UA stylesheet.
19771977
However, this also suppresses the focus indicators provided by the same UA stylesheet.
19781978
In order avoid damaging accessibility,
@@ -1983,7 +1983,7 @@ they intended.
19831983
<h4 id=appearance-semantics>
19841984
Effects of 'appearance' on Semantic Aspects of Elements</h4>
19851985

1986-
UAs must preserve aspects of the form control
1986+
UAs must preserve aspects of the control
19871987
which are necessary to operate the control with its original semantics.
19881988
The UA may however give them a different look and feel
19891989
as long as it remains possible to operate the control.
@@ -2042,7 +2042,7 @@ that are typical of the element whose appearance it acquires.
20422042
</div>
20432043

20442044
<h3 id=control-specific-rules>
2045-
Form Control Specific Rules</h3>
2045+
Control Specific Rules</h3>
20462046

20472047
Issue: Maybe some or all of this section
20482048
should be moved to the [[HTML]] spec

0 commit comments

Comments
 (0)