@@ -206,19 +206,31 @@ which cannot be reasonably made thinner.
206206In 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
213230UAs 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
223235Note: This specification does not define the exact position or shape of the scrollbar,
224236or any animation thereof, such as fading or sliding in/out of view.
0 commit comments