Skip to content

Commit d08e4ee

Browse files
authored
scrollbar-width dl dfn-for, length in dl
fix dl dfn-for, and explicitly list all values for scrollbar-width in dl
1 parent 3fb269d commit d08e4ee

File tree

1 file changed

+18
-18
lines changed

1 file changed

+18
-18
lines changed

css-scrollbars-1/Overview.bs

+18-18
Original file line numberDiff line numberDiff line change
@@ -33,8 +33,6 @@ and as has been increasingly adopted
3333
on the web since Windows IE 5.5 introduced it in 2000.
3434
[Note: Add citations of examples from Bugzilla 77790 and webcompat].
3535

36-
Should we add scrollbar width? (<a href="https://github.com/w3c/csswg-drafts/issues/1958">Issue 1958</a>)
37-
3836
Out of scope:
3937
<a href="https://www.w3.org/wiki/Css-scrollbars#Why_not_pseudos">pseudo-elements for selecting specific parts of a scrollbar are unnecesssary</a>
4038
for the documented use-cases and are thus out of scope for this specification.
@@ -76,11 +74,14 @@ Note: Unlike 'overflow' (and overflow-*) properties,
7674
scrollbar-* values set on the HTML body element are not propagated to the viewport.
7775

7876
<dl dfn-type="value" dfn-for="scrollbar-face-color">
79-
<dt><dfn>auto</dfn>
77+
<dt><dfn>auto</dfn></dt>
8078
<dd>default platform rendering for that portion of the scrollbar, in the absence of any other
81-
related scrollbar color properties. See details below for which scrollbar color are related to which.
82-
<dt><dfn><<color>></dfn>
79+
related scrollbar color properties.
80+
See details below for which scrollbar color are related to which.
81+
</dd>
82+
<dt><dfn><<color>></dfn></dt>
8383
<dd>apply the color to that portion of the scrollbar, and potentially other portions of the scrollbar.
84+
</dd>
8485
</dl>
8586

8687
Details:
@@ -138,27 +139,26 @@ Media: visual
138139
</pre>
139140

140141
This property allows the author to set the maximum thickness of an element’s scrollbars when they are shown.
141-
Negative <<length>> values are not allowed.
142-
143-
When a user agent displays one or more scrollbars for an element,
144-
the thickness of those scrollbars must be no more than the computed 'scrollbar-width' value.
145-
146-
<dl for=scrollbar-width>
147142

143+
<dl dfn-type="value" dfn-for=scrollbar-width>
148144
<dt><dfn >''auto''</dfn></dt>
149-
<dd>implementations must use the default platform scrollbar width.</dd>
150-
145+
<dd>implementations must use the default platform scrollbar width.
146+
</dd>
151147
<dt><dfn for=scrollbar-width>''thin''</dfn></dt>
152148
<dd>implementations must use either a thin scrollbar width variant on platforms that provide that option,
153-
or display a scrollbar thinner than the default platform scrollbar width.</dd>
154-
155-
</dl>
156-
157-
Note: If scrollbar-width computes to 0, the element’s scrollbars are hidden,
149+
or display a scrollbar thinner than the default platform scrollbar width.
150+
</dd>
151+
<dt><dfn><<length>></dfn></dt>
152+
<dd>When a user agent displays one or more scrollbars for an element,
153+
the thickness of those scrollbars must be no more than the computed 'scrollbar-width' length value.
154+
Negative <<length>> values are not allowed. If scrollbar-width computes to 0, the element’s scrollbars are hidden,
158155
however its scrollability is not affected.
156+
</dd>
157+
</dl>
159158

160159
Note: There is working group disagreement about whether to allow length values,
161160
or only have keywords (auto, thin, none), or drop the scrollbar-width property altogether.
161+
(<a href="https://github.com/w3c/csswg-drafts/issues/1958">Issue 1958</a>)
162162

163163
UAs must apply the scrollbar-width value set on the root element to the viewport.
164164

0 commit comments

Comments
 (0)