diff options
author | MDN <actions@users.noreply.github.com> | 2021-09-21 00:49:44 +0000 |
---|---|---|
committer | MDN <actions@users.noreply.github.com> | 2021-09-21 00:49:44 +0000 |
commit | ae378c0aab28bc8ab71168c1ef3e33e4ea3845af (patch) | |
tree | 5b320a27c64cf2ae4f4049ee595f7ffb3260f26d /files/zh-cn/conflicting/web/api | |
parent | c7a8e3b8c7654ac1b9a8d88d2b10b9e43db3d071 (diff) | |
download | translated-content-ae378c0aab28bc8ab71168c1ef3e33e4ea3845af.tar.gz translated-content-ae378c0aab28bc8ab71168c1ef3e33e4ea3845af.tar.bz2 translated-content-ae378c0aab28bc8ab71168c1ef3e33e4ea3845af.zip |
[CRON] sync translated content
Diffstat (limited to 'files/zh-cn/conflicting/web/api')
-rw-r--r-- | files/zh-cn/conflicting/web/api/window/scroll/index.html | 73 |
1 files changed, 73 insertions, 0 deletions
diff --git a/files/zh-cn/conflicting/web/api/window/scroll/index.html b/files/zh-cn/conflicting/web/api/window/scroll/index.html new file mode 100644 index 0000000000..b564a07814 --- /dev/null +++ b/files/zh-cn/conflicting/web/api/window/scroll/index.html @@ -0,0 +1,73 @@ +--- +title: ScrollToOptions +slug: conflicting/Web/API/Window/scroll +translation_of: Web/API/ScrollToOptions +original_slug: Web/API/ScrollToOptions +--- +<div>{{ APIRef("CSSOM View") }}</div> + +<p class="summary">CSSOM View 规范的 <strong><code>ScrollToOptions</code></strong> 字典(dictionary)当中的属性用于指定一个元素应该滚动到哪里,以及滚动是否应该平滑。</p> + +<p>一个 <code>ScrollToOptions</code> 字典可以作为参数提供给下面的方法:</p> + +<ul> + <li>{{domxref("Window.scroll()")}}</li> + <li>{{domxref("Window.scrollBy()")}}</li> + <li>{{domxref("Window.scrollTo()")}}</li> + <li>{{domxref("Element.scroll()")}}</li> + <li>{{domxref("Element.scrollBy()")}}</li> + <li>{{domxref("Element.scrollTo()")}}</li> +</ul> + +<h2 id="属性">属性</h2> + +<dl> + <dt>{{domxref("ScrollToOptions.top")}}</dt> + <dd>指定 window 或元素 Y 轴方向滚动的像素数。</dd> + <dt>{{domxref("ScrollToOptions.left")}}</dt> + <dd>指定 window 或元素 X 轴方向滚动的像素数。</dd> + <dt>{{domxref("ScrollToOptions.behavior")}}</dt> + <dd>指定滚动是否应该平滑进行,还是立即跳到指定位置。该属性实际上定义在 <code>ScrollOptions</code> 字典上,它通过 <code>ScrollToOptions</code> 实现。</dd> +</dl> + +<h2 id="示例">示例</h2> + +<p>在我们的 <a href="https://github.com/mdn/dom-examples/tree/master/scrolltooptions">scrolltooptions </a>示例中(<a href="https://mdn.github.io/dom-examples/scrolltooptions/">在线查看 </a>),包含一个表单,允许用户输入三个值——两个数值表示 left 和 top 属性(即沿 X 和 Y 轴方向滚动后的位置),以及一个表示是否开启平滑滚动的复选框。</p> + +<p>当提交表单时,会运行事件监听器,该事件监听器会把输入的值写入 ScrollToOptions 字典,然后传入 {{domxref("Window.ScrollTo()")}} 方法,并调用:</p> + +<pre class="brush: js">form.addEventListener('submit', (e) => { + e.preventDefault(); + scrollOptions = { + left: leftInput.value, + top: topInput.value, + behavior: scrollInput.checked ? 'smooth' : 'auto' + } + + window.scrollTo(scrollOptions); +});</pre> + +<h2 id="规范">规范</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">Specification</th> + <th scope="col">Status</th> + <th scope="col">Comment</th> + </tr> + <tr> + <td>{{SpecName('CSSOM View', '#dictdef-scrolltooptions', 'ScrollToOptions')}}</td> + <td>{{Spec2('CSSOM View')}}</td> + <td></td> + </tr> + </tbody> +</table> + +<h2 id="浏览器兼容性">浏览器兼容性</h2> + +<div> + + +<p>{{Compat("api.ScrollToOptions", 10)}}</p> +</div> |