[ru] update Web/API/Window/scrollBy translation

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()")}}.
 
 ## Спецификации