1# Web页面显示内容滚动 2<!--Kit: ArkWeb--> 3<!--Subsystem: Web--> 4<!--Owner: @zourongchun--> 5<!--Designer: @zhufenghao--> 6<!--Tester: @ghiker--> 7<!--Adviser: @HelloCrease--> 8 9当Web页面的内容高度或宽度超过可视区域时,页面才能滚动。Web页面滚动有多种方式,包括使用外接设备、ArkTS侧接口调用和js侧接口调用。 10 11## 使用外接设备控制Web页面滚动 12 13可以使用以下方式,通过触屏、触摸板和鼠标滚动控制Web页面滚动。 14+ 使用触屏控制Web页面滚动:支持在触摸屏上单指上下左右滑动可以控制页面滚动。 15+ 使用触摸板控制Web页面滚动:支持在笔记本触摸板或者外接触摸板双指上下左右滑动,可以控制页面滚动。 16+ 使用控制鼠标滚轮控制Web页面滚动:支持用鼠标滚轮上下滑动来控制页面滚动。 17 18## 调用ArkTS侧接口控制Web页面滚动 19+ [scrollTo](../reference/apis-arkweb/arkts-apis-webview-WebviewController.md#scrollto):在指定时间内,将页面滚动到指定的绝对位置。 20 21 返回页面顶部。 22 ```ts 23 this.controller.scrollTo(0, 0); 24 ``` 25+ [scrollBy](../reference/apis-arkweb/arkts-apis-webview-WebviewController.md#scrollby):在指定时间内将页面滚动指定的偏移量。 26 27 可以作为Web组件嵌套滚动中,控制Web组件滚动的接口,详见[滚动偏移量由滚动父组件统一派发](web-nested-scrolling.md#滚动偏移量由滚动父组件统一派发)。 28 29+ [pageUp](../reference/apis-arkweb/arkts-apis-webview-WebviewController.md#pageup):将Webview的内容向上滚动半个视框大小或者跳转到页面最顶部,通过top入参控制。 30+ [pageDown](../reference/apis-arkweb/arkts-apis-webview-WebviewController.md#pagedown):将Webview的内容向下滚动半个视框大小或者跳转到页面最底部,通过bottom入参控制。 31## 调用js侧接口控制Web页面滚动 32+ scrollBy:相对当前滚动位置滚动一定距离(正数向下/右,负数向上/左)。 33 34 ```javascript 35 window.scrollBy(deltaX, deltaY);//deltaX是元素要在横轴上滚动的距离,deltaY是元素要在纵轴上滚动的距离。 36 ``` 37 渐进式滚动(如“阅读更多”按钮)。 38 ```javascript 39 document.getElementById("read-more").addEventListener("click", ()=>{ 40 window.scrollBy(0, 300); 41 }) 42 ``` 43+ scrollTo:将页面滚动到绝对坐标位置。 44 ```javascript 45 window.scrollTo(x, y);//X是你想要显示在左上角的元素沿水平轴的像素,Y是你想要显示在左上角的元素沿垂直轴的像素。 46 ``` 47 (1) 返回页面顶部。 48 ```javascript 49 window.scrollTo(0, 0); 50 ``` 51 (2) 跳转到页面特定位置。 52 ```javascript 53 window.scrollTo(0, 500); //滚动到某个固定像素位置(如:500px) 54 ```