Skip to content

Commit b0cbb66

Browse files
committed
[css-scrollbars] Editorial improvements to notes and advisements about scrollbar-width: none
See w3c#3315
1 parent 43a73ff commit b0cbb66

File tree

1 file changed

+20
-8
lines changed

1 file changed

+20
-8
lines changed

css-scrollbars-1/Overview.bs

Lines changed: 20 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -206,19 +206,31 @@ which cannot be reasonably made thinner.
206206
In such cases, this value will behave as ''scrollbar-width/auto''.
207207
</dd>
208208
<dt><dfn>none</dfn></dt>
209-
<dd>implementations must not display any scrollbar, however the element's scrollability is not affected.
209+
<dd>Implementations must not display any scrollbar,
210+
however the element's scrollability by other means is not affected.
211+
212+
<div class=advisement>
213+
Using this value can prevent mouse-only users from being able to scroll.
214+
Authors should ensure that mouse-only users can still reach hidden content,
215+
even if they have no scrollwheel.
216+
</div>
217+
218+
<div class=advisement>
219+
Authors that use ''scrollbar-width/none'' should provide an alternative/equivalent visual hint that
220+
scrolling is possible and there is more content.
221+
</div>
222+
223+
Note: For situations where an element is to be scrolled <em>only</em> by programmatic means,
224+
and not by direct user manipulation,
225+
authors should use ''overflow: hidden'' instead of ''scrollbar-width: none''.
226+
210227
</dd>
211228
</dl>
212229

213230
UAs must apply the 'scrollbar-width' value set on the root element to the viewport.
214231

215-
Authors that use ''scrollbar-width/none'' should provide an alternative/equivalent visual hint that
216-
scrolling is possible and there is more content.
217-
For situations where an element is going to be scrolled by other means instead of direct user manipulation
218-
(e.g. programmatically), authors should use ''overflow: hidden'' instead of ''scrollbar-width/none''.
219-
220-
Note: Unlike 'overflow' (and overflow-*) properties,
221-
a scrollbar-width value set on the HTML body element is not propagated to the viewport.
232+
Note: Unlike the 'overflow' property (and its longhands),
233+
a 'scrollbar-width' value set on the HTML <{body}> element is not propagated to the viewport.
222234

223235
Note: This specification does not define the exact position or shape of the scrollbar,
224236
or any animation thereof, such as fading or sliding in/out of view.

0 commit comments

Comments
 (0)