You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: css-ui-4/Overview.bs
+25-31
Original file line number
Diff line number
Diff line change
@@ -2227,7 +2227,7 @@ Switching appearance: the 'appearance' property</h3>
2227
2227
<a>widgets</a> are typically rendered by UAs using native UI controls of the host operating system,
2228
2228
which can neither be replicated nor styled using CSS.
2229
2229
2230
-
The term <dfn export>widget</dfn> in this specification denotes elements that can have <dfn export>native appearance</dfn>,
2230
+
The term <dfn export>widget</dfn> in this specification denotes [=replaced=]elements that can have <dfn export>native appearance</dfn>,
2231
2231
meaning that they are rendered like analogous native widgets or controls of the host operating system or platform,
2232
2232
or with a look and feel not otherwise expressible in CSS.
2233
2233
It is up to the host language (e.g., HTML [[HTML]]) to define which elements can have <a>native appearance</a>.
@@ -2310,14 +2310,14 @@ Switching appearance: the 'appearance' property</h3>
2310
2310
2311
2311
<dt><dfn>auto</dfn>
2312
2312
<dd>
2313
-
Elements representing <a>widgets</a> should have the <a>native appearance</a> of that widget,
2314
-
if the <a>properties that disable native appearance for widgets</a> are not in effect.
2315
-
See [[#appearance-disabling-properties]].
2313
+
The element's box is laid out like a regular replaced element.
2316
2314
2317
-
The host language is responsible for defining
2318
-
which elements represent which <a>widgets</a>.
2315
+
Within that box, elements representing <a>widgets</a> should have the <a>native appearance</a> of that widget.
2319
2316
2320
-
Elements other than <a>widgets</a> must be rendered as for ''appearance/none''.
2317
+
The host language is responsible for defining
2318
+
which elements represent which <a>widgets</a>.
2319
+
2320
+
Elements other than <a>widgets</a> must be rendered as for ''appearance/none''.
2321
2321
2322
2322
<dt><dfn>base</dfn>
2323
2323
<dd>
@@ -2417,42 +2417,36 @@ Switching appearance: the 'appearance' property</h3>
2417
2417
and activating (for example by clicking) the element would toggle the state as usual.
2418
2418
</div>
2419
2419
2420
-
User agents may [=disregard=] some CSS properties
2421
-
on[=widgets=] rendered with their [=native appearance=]
2420
+
User agents may [=disregard=] some CSS properties used to size and paint the contents
2421
+
of[=widgets=] rendered with their [=native appearance=]
2422
2422
to ensure that the intended appearance is preserved,
2423
2423
or because these properties may not be meaningful for the chosen appearance.
2424
+
2424
2425
<dfn>Disregarding</dfn> a property means that
2425
2426
the user agent treats it as if it didn't [=apply to=] the widget in question.
2426
2427
Nevertheless,
2427
2428
unless an explicit exception is specified (for compatibility reasons),
2428
2429
the user agent must still determine the [=computed value=] of any [=disregarded=] property
2429
2430
according to the usual rules.
2430
-
However, the following properties must not be [=disregarded=]:
2431
2431
2432
+
In more detail, the rules for disregarding properties for [=natively rendered=] widgets are:
2432
2433
<ul>
2433
-
<li>'appearance'
2434
-
<li>'display' (the [=inner display type=] may be ignored)
2435
-
<li>'visibility'
2436
-
<li>'position'
2437
-
<li>'top'
2438
-
<li>'right'
2439
-
<li>'bottom'
2440
-
<li>'left'
2441
-
<li>'float'
2442
-
<li>'clear'
2443
-
<li>'margin' and related long-hand properties
2444
-
<li>'unicode-bidi'
2445
-
<li>'direction'
2446
-
<li>'cursor'
2447
-
<li>'z-index'
2434
+
<li> CSS properties that impact the box sizing or position of the widget's box (such as the [=sizing properties=]),
2435
+
or their visual appearance outside of the box (such as 'transform', 'filter' or 'box-shadow'), must be applied to
2436
+
[=widgets=] rendered with their [=native appearance=]. The widget's box participates in the rest of layout like any other replaced element.
2437
+
<li> Properties that affect the internal box model sizing of the widget's box (such as 'box-sizing', 'padding', 'border' or 'margin') may be disregarded when needed.
2438
+
<li> Other properties that affect painting (like 'background-color') may be disregarded when needed.
2439
+
<li> User agents should take into account CSS properties that affect writing modes or font-related properties when possible,
2440
+
when rendering text within the widget.
2441
+
<li> The 'object-fit' property does not apply.
2448
2442
</ul>
2449
2443
2450
-
Issue: Are there more properties that should be included in this list?
2451
-
Should we remove some?
2452
-
Should we whitelist the properties that are ok to ignore instead of
2453
-
blacklisting those that are not?
2454
-
Either way, UAs do ignore some properties when rendering <a>widgets</a>,
2455
-
so this specification needs to say something about this.
2444
+
<div class=example>
2445
+
Some user agents respect the 'border' and 'padding' CSS properties for a <select> rendered with [=native appearance=], but
2446
+
not for <input type=checkbox>.
2447
+
</div>
2448
+
2449
+
Native rendering of widgets may overflow the size of its box if its intrinsic sizing exceeds that size.
2456
2450
2457
2451
For compatibility with legacy content, UAs must also support <dfn property export>-webkit-appearance</dfn>
0 commit comments