---
title: "`scroll-behavior`"
description: "Делаем прокрутку на странице плавной."
url: "https://doka.guide/css/scroll-behavior/"
section: "CSS"
createdAt: "2021-10-27"
updatedAt: "2025-09-02"
baseline: [{"group":"scroll-behavior","features":["css.properties.scroll-behavior","css.properties.scroll-behavior.auto","css.properties.scroll-behavior.smooth"]}]
authors: ["vaiil"]
related: ["js/element-scrollto", "css/scroll-padding", "css/scrollbar-gutter"]
source: "https://github.com/doka-guide/content/blob/main/css/scroll-behavior/index.md"
license: "CC BY-NC-SA 4.0"
---

# `scroll-behavior`

## Кратко

Управляет поведением прокрутки внутри блока. Значение `smooth` делает её плавной.

## Пример

```css
html {
  scroll-behavior: smooth;
}
```

## Как понять

При переходе по [якорной ссылке](/html/a/) браузер мгновенно _прыгает_ к целевому блоку. То же самое происходит, если изменять положение полосы прокрутки [при помощи JS](/js/element-scrollto/). Чтобы изменить стандартное поведение можно использовать значение `smooth`. Оно сделает прокрутку плавной. Но в остальных ситуациях, например, при прокрутке пользователем колёсика мышки, свойство `scroll-behavior` не повлияет на поведение браузера.

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

Возможные значения `scroll-behavior`:

- `auto` — значение по умолчанию, мгновенная прокрутка;
- `smooth` — плавная прокрутка.

<iframe title="Варианты значений" src="https://doka.guide/css/scroll-behavior/demos/values/" height="200" sandbox></iframe>

## Подсказки

💡 Если вы хотите указать `scroll-behavior` для всей страницы, указывайте его для селектора `html`. Для селектора `body` свойство не сработает.

💡 Значение `scroll-behavior` не наследуется — его нужно указывать для каждого блока с собственной полосой прокрутки.

💡 Браузер сам управляет скоростью и временем плавной прокрутки, сейчас нет способа на это влиять.

## На практике: Татьяна Фокина

🛠 Пользователи могут по какой-то причине отключить анимацию в системе. Например, их укачивает от плавной прокрутки на странице с большим количеством контента. Чтобы этого не произошло, можно использовать директиву [`@media`](/css/media/) с проверкой значения `prefers-reduced-motion` в условии и анимировать прокрутку только тогда, когда пользователь не отключил анимацию.

```css
@media (prefers-reduced-motion: no-preference) {
  .smooth-scroll {
    scroll-behavior: smooth;
  }
}
```

