---
title: "`scrollbar-width`"
description: "Изменяем ширину полосы прокрутки."
url: "https://doka.guide/css/scrollbar-width/"
section: "CSS"
createdAt: "2022-12-07"
updatedAt: "2026-09-01"
baseline: [{"group":"scrollbar-width","features":["css.properties.scrollbar-width","css.properties.scrollbar-width.auto","css.properties.scrollbar-width.none","css.properties.scrollbar-width.thin"]}]
authors: ["xpleesid"]
related: ["css/overflow", "css/scroll-padding", "css/web-colors"]
source: "https://github.com/doka-guide/content/blob/main/css/scrollbar-width/index.md"
license: "CC BY-NC-SA 4.0"
---

# `scrollbar-width`

## Кратко

`scrollbar-width` позволяет изменить ширину полосы прокрутки.

<aside>

На данный момент `scrollbar-width` поддерживается всеми браузерами, кроме Safari ([Can I Use](https://caniuse.com/mdn-css_properties_scrollbar-width)).

Также во всех демо мы зададим ползунку скроллбара белый цвет при помощи [`scrollbar-color`](/css/scrollbar-color/), чтобы он лучше выделялся на тёмном фоне.

</aside>

## Пример

```css
html {
  scrollbar-width: thin;
}
```

<iframe title="Тонкий скроллбар" src="https://doka.guide/css/scrollbar-width/demos/basic/" height="400"></iframe>

![Тонкий скроллбар](https://doka.guide/css/scrollbar-width/images/basic.png)
Пример того, как это выглядит в Firefox

## Как пишется

У `scrollbar-width` есть 3 возможных значения:

1. `auto` — дефолтное значение. Браузер отрисует обычный скроллбар.
1. `thin` — браузер отрисует тонкий скроллбар.
1. `none` — скроллбар не будет отрисован. При этом контент по-прежнему можно будет прокрутить.

Вот как они выглядят рядом:

<iframe title="Разные значения ширины скроллбара" src="https://doka.guide/css/scrollbar-width/demos/multiple/" height="400"></iframe>

![Разные значения ширины скроллбара](https://doka.guide/css/scrollbar-width/images/multiple.png)
Пример того, как скроллбары с разной шириной выглядят в Firefox

Значение `none` не рекомендуется использовать. Мы должны явно дать пользователю понять что контент в каком-то блоке выходит за его границы, и ему нужно пролистать, чтобы увидеть остальное. Если просто убрать скроллбар, то это только запутает пользователей. К тому же если пользователь использует только мышь, то этот контент может оказаться недоступным (вдруг у него сломалось колесо прокрутки).

В целом, с шириной полосы прокрутки нужно обращаться очень осторожно. Даже если просто сделать её тоньше, мы можем создать проблемы с доступностью — пользователям буквально сложнее попасть мышью в тонкий ползунок. Убирая ползунок совсем, мы должны не допускать того, чтобы контент за пределами видимой области стал недоступен.

