From 57b81f5690398c5bab6d058b16fba2522be146a9 Mon Sep 17 00:00:00 2001
From: A1lo <yin199909@aliyun.com>
Date: Sun, 22 Sep 2024 22:01:14 +0800
Subject: [PATCH] zh-cn: update the translation of `Window.scroll()` (#23732)

Co-authored-by: Jason Ren <40999116+jasonren0403@users.noreply.github.com>
---
 files/zh-cn/web/api/window/scroll/index.md | 49 +++++++++++++++++-----
 1 file changed, 38 insertions(+), 11 deletions(-)

diff --git a/files/zh-cn/web/api/window/scroll/index.md b/files/zh-cn/web/api/window/scroll/index.md
index 3d51190fc0edda..2a00f18996bfa6 100644
--- a/files/zh-cn/web/api/window/scroll/index.md
+++ b/files/zh-cn/web/api/window/scroll/index.md
@@ -1,34 +1,49 @@
 ---
-title: Window.scroll()
+title: Window：scroll() 方法
 slug: Web/API/Window/scroll
+l10n:
+  sourceCommit: 20c51db7895b1b6f41d4fa90e71830f4b6678eea
 ---
 
 {{APIRef}}
 
-滚动窗口至文档中的特定位置。
+**`Window.scroll()`** 方法滚动窗口至文档中的特定位置。
 
 ## 语法
 
 ```js-nolint
-scroll(x-coord, y-coord)
+scroll(xCoord, yCoord)
 scroll(options)
 ```
 
 ### 参数
 
-- `x-coord` 值表示你想要置于左上角的像素点的横坐标。
-- `y-coord` 值表示你想要置于左上角的像素点的纵坐标。
-
-\- 或者 -
-
-- `options` 值是一个 {{domxref("ScrollToOptions")}} 字典
+- `xCoord`
+  - : 你想要在左上角显示的文档水平轴像素。
+- `yCoord`
+  - : 你想要在左上角显示的文档垂直轴像素。
+- `options`
+  - : 包含以下属性的对象：
+    - `top`
+      - : 指定沿 Y 轴滚动窗口或元素的像素数。
+    - `left`
+      - : 指定沿 X 轴滚动窗口或元素的像素数。
+    - `behavior`
+      - : 确定滚动是即时完成还是以平滑动画进行。该选项是一个字符串，必须取以下值之一：
+        - `smooth`：滚动应该平滑地进行动画展示
+        - `instant`：滚动应在一次跳转中即时完成
+        - `auto`：滚动行为由 {{cssxref("scroll-behavior")}} 的计算值来决定
+
+### 返回值
+
+无（{{jsxref("undefined")}}）。
 
 ## 示例
 
 ```html
 <!-- 把纵轴上第 100 个像素置于窗口顶部 -->
 
-<button onClick="scroll(0, 100);">点击以向下滚动 100 像素</button>
+<button onclick="scroll(0, 100);">点击以向下滚动到第 100 个像素</button>
 ```
 
 使用 `options`:
@@ -43,8 +58,20 @@ window.scroll({
 
 ## 备注
 
-[window.scrollTo](/zh-CN/docs/Web/API/Window/scrollTo) 实际上和该方法是相同的。想要重复地滚动某个距离，请使用 [window.scrollBy](/zh-CN/docs/Web/API/Window/scrollBy). 参见 [window.scrollByLines](/zh-CN/docs/Web/API/Window/scrollByLines), [window.scrollByPages](/zh-CN/docs/Web/API/Window/scrollByPages).
+{{domxref("Window.scrollTo()")}} 实际上和该方法是相同的。有关相对滚动，请参见 {{domxref("Window.scrollBy()")}}、{{domxref("Window.scrollByLines()")}} 和 {{domxref("Window.scrollByPages()")}}。
+
+有关滚动元素，请参见 {{domxref("Element.scrollTop")}} 和 {{domxref("Element.scrollLeft")}}。
 
 ## 规范
 
 {{Specifications}}
+
+## 浏览器兼容性
+
+{{Compat}}
+
+## 参见
+
+- {{domxref("Window.scrollByLines()")}}
+- {{domxref("Window.scrollByPages()")}}
+- {{domxref("Element.scrollIntoView()")}}