Skip to content

Commit 0c82068

Browse files
committed
[css-ui-4] Remove "do no impement" warning, replace with note
Closes w3c#1250
1 parent 810ea34 commit 0c82068

File tree

1 file changed

+37
-48
lines changed

1 file changed

+37
-48
lines changed

css-ui-4/Overview.bs

Lines changed: 37 additions & 48 deletions
Original file line numberDiff line numberDiff line change
@@ -1749,17 +1749,37 @@ so this specification allows flexibility.
17491749

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

1752-
<div class=issue>
1753-
<strong>This is a work-in-progress, not cleared for shipping</strong> (see <a href="https://github.com/w3c/csswg-drafts/issues/1250">Github issue 1250</a>).
1752+
<pre class="propdef">
1753+
Name: appearance
1754+
Value: ''appearance/none'' | ''auto'' | ''button'' | ''textfield'' | ''menulist-button'' | <<compat-auto>>
1755+
Initial: none
1756+
Applies To: all elements
1757+
Inherited: no
1758+
Computed value: specified keyword
1759+
Animation type: discrete
1760+
</pre>
1761+
1762+
While the way most elements in a document look can be fully controlled by CSS,
1763+
controls are typically rendered by UAs using native UI controls of the host operating system,
1764+
which can neither be replicated nor styled using CSS.
17541765

1755-
This previously existed as a prefixed form in most browsers.
1766+
This specification introduces the 'appearance' property
1767+
to provide some control over this behavior.
1768+
In particular, using ''appearance: none'' allows authors
1769+
to suppress the native style of controls,
1770+
so that CSS can be used to restyle them.
1771+
1772+
<details class=note>
1773+
<summary>Note on the history of this feature</summary>
1774+
1775+
This previously existed in prefixed form in most browsers.
17561776
Before standardization, in addition to none,
17571777
the possible values were a very long list of all the ways an element could look;
17581778
each value being responsible for giving form control their specific look and feel.
17591779
This list was different across browsers.
17601780

1761-
We concluded this was impractical to standardize,
1762-
in part because many apply to pseudo-elements that other browsers don't have,
1781+
The CSS Working Group concluded this was impractical to standardize,
1782+
in part because many values applied to pseudo-elements that other browsers don't have,
17631783
as they construct form elements differently,
17641784
and which should not be standardized,
17651785
since the ability to make for controls look substantially different on different platforms
@@ -1769,7 +1789,8 @@ so this specification allows flexibility.
17691789
into any (other) arbitrary form control
17701790
is considered a misfeature.
17711791

1772-
Instead, we'd just have an "auto" value that makes form controls look like whatever they need,
1792+
Instead, the design being specified
1793+
is based on just having an "auto" value that makes form controls look like whatever they need,
17731794
and a "none" value that suppresses "native" look.
17741795

17751796
However, there is evidence that this alone is not web compatible,
@@ -1779,49 +1800,17 @@ so this specification allows flexibility.
17791800
input[type=checkbox] { appearance: checkbox; }
17801801
</code></pre>
17811802

1782-
This Work-In-Progress specification is a compromise between the two,
1803+
The design specified here is a compromise between the two,
17831804
preserving the simplicity of the ''none | auto'' model
1784-
while maintaining compatibility with existing content.
1785-
</div>
1786-
1787-
While the way most elements in a document look can be fully controlled by CSS,
1788-
controls are typically rendered by UAs using native UI controls of the host operating system,
1789-
which can neither be replicated nor styled using CSS.
1790-
1791-
This specification introduces the 'appearance' property
1792-
to provide some control over this behavior.
1793-
In particular, using ''appearance: none'' allows authors
1794-
to suppress the native style of controls,
1795-
so that CSS can be used to restyle them.
1796-
1797-
<pre class="propdef">
1798-
Name: appearance
1799-
Value: ''appearance/none'' | ''auto'' | ''button'' | ''textfield'' | ''menulist-button'' | <<compat-auto>>
1800-
Initial: none
1801-
Applies To: all elements
1802-
Inherited: no
1803-
Computed value: specified keyword
1804-
Animation type: discrete
1805-
</pre>
1806-
1807-
<div class="note">
1808-
Note: This specification intentionally refrains from making the appearance
1809-
of all possible form controls and sub-controls available as values,
1810-
as had previously been attempted by earlier proposals for this property
1811-
and by several UA vendors in experimental implementations.
1812-
Experience has shown that such a list would be very long and not practical to maintain,
1813-
and UAs would need to add non-standard values
1814-
to account for the behavior of non-standard pseudo-elements
1815-
sometimes used to implement form controls.
1816-
Moreover, many values of such an enumeration only make sense
1817-
on a single element or pseudo-element,
1818-
and are never used outside of the UA stylesheet.
1819-
The ability provided by this approach to turn any arbitrary element
1820-
into any arbitrary form control or subcontrol
1821-
was also a significant source of complexity,
1822-
despite being not particularly useful.
1823-
The model provided by this specification is deliberately simpler.
1824-
</div>
1805+
while maintaining compatibility with existing content
1806+
via a few additional keywords.
1807+
1808+
The precise list of keywords needed for compatibility
1809+
and their exact behavior
1810+
is likely to be refined in future version of this specification
1811+
to better handle compatibility with existing content.
1812+
The CSS-WG welcomes relevant feedback.
1813+
</details>
18251814

18261815
<dl dfn-type=value dfn-for=appearance>
18271816
<dt><dfn>none</dfn>

0 commit comments

Comments
 (0)