From 9e68ab723b9e1486b2420b8d439ce05b5856be32 Mon Sep 17 00:00:00 2001
From: Leonid Vinogradov <win.leon@protonmail.com>
Date: Sun, 25 Aug 2024 01:27:08 +0300
Subject: [PATCH] [ru] update 'Web/API/Window/scrollBy' translation

---
 files/ru/web/api/window/scrollby/index.md | 60 +++++++++++++++++------
 1 file changed, 46 insertions(+), 14 deletions(-)

diff --git a/files/ru/web/api/window/scrollby/index.md b/files/ru/web/api/window/scrollby/index.md
index ae7b652510e17b..a927f714dc8fd5 100644
--- a/files/ru/web/api/window/scrollby/index.md
+++ b/files/ru/web/api/window/scrollby/index.md
@@ -1,37 +1,69 @@
 ---
-title: Window.scrollBy()
+title: "Window: метод scrollBy()"
 slug: Web/API/Window/scrollBy
+l10n:
+  sourceCommit: 62cedc63226017e9e7d0718b6fea3529ca8dbf37
 ---
 
-{{ APIRef() }}
+{{APIRef}}
 
-## Описание
-
-Прокручивает документ на указанные величины.
+Метод **`Window.scrollBy()`** прокручивает документ в окне на указанную величину.
 
 ## Синтаксис
 
-```
-window.scrollBy(X, Y);
+```js-nolint
+scrollBy(x-coord, y-coord)
+scrollBy(options)
 ```
 
 ### Параметры
 
-- `X` - смещение в пикселях по горизонтали.
-- `Y` - смещение в пикселях по вертикали.
+- `x-coord` смещение в пикселях по горизонтали.
+- `y-coord` смещение в пикселях по вертикали.
 
-Положительные значения приведут к прокрутке страницы вправо и вниз. Отрицательные координаты прокрутят страницу влево и вверх.
+\- или -
 
-## Пример
+- `options`
 
-```
-// Прокрутка на один экран вертикально вниз.
+  - : Объект, содержащий следующие свойства:
+    - `top`
+      - : Указывает количество пикселей по оси Y для прокрутки окна или элемента.
+    - `left`
+      - : Указывает количество пикселей по оси X для прокрутки окна или элемента.
+    - `behavior`
+      - : Указывает, нужно ли анимировать прокрутку плавно (`smooth`), быстрым перемещением (`instant`) или предоставить выбор браузеру (`auto`, по умолчанию).
+
+### Возвращаемое значение
+
+Нет ({{jsxref("undefined")}}).
+
+## Примеры
+
+Для прокрутки вниз страницы:
+
+```js
 window.scrollBy(0, window.innerHeight);
 ```
 
+Для прокрутки вверх:
+
+```js
+window.scrollBy(0, -window.innerHeight);
+```
+
+С использованием `options`:
+
+```js
+window.scrollBy({
+  top: 100,
+  left: 100,
+  behavior: "smooth",
+});
+```
+
 ## Примечания
 
-[window.scrollBy](/ru/docs/DOM/Window.scrollBy) прокручивает страницу на указанное количество пикселей, в то время как метод [window.scroll](/ru/docs/DOM/Window.scroll) указывает абсолютную позицию в документе, на которую надо сместиться. Смотрите также [window.scrollByLines](/ru/docs/DOM/Window.scrollByLines), [window.scrollByPages](/ru/docs/DOM/Window.scrollByPages)
+`window.scrollBy()` прокручивает страницу на указанное количество пикселей, в то время как метод {{domxref("window.scroll()")}} прокручивает к абсолютной позиции в документе. Смотрите также {{domxref("window.scrollByLines()")}} и {{domxref("window.scrollByPages()")}}.
 
 ## Спецификации