💎一站式轻松地调用各大LLM模型接口,支持GPT4、智谱、星火、月之暗面及文生图 广告
scroll-view 可滚动视图区域。 | 属性名 | 类型 | 默认值 | 说明 | | --- | --- | --- | --- | |scroll-x |Boolean| false |允许横向滚动 | | scroll-y|Boolean |false |允许纵向滚动| | upper-threshold| Number|50|距顶部/左边多远时(单位px),触发 scrolltoupper 事件| | ower-threshold |Number| 50| 距底部/右边多远时(单位px),触发 scrolltolower 事件| | scroll-top | Number | |设置竖向滚动条位置| | scroll-left | Number | |设置横向滚动条位置| | scroll-into-view |String | |值应为某子元素id(id不能以数字开头)。设置哪个方向可滚动,则在哪个方向滚动到该元素| | scroll-with-animation | Boolean | false| 在设置滚动条位置时使用动画过渡| | enable-back-to-top | Boolean | false | iOS点击顶部状态栏、安卓双击标题栏时,滚动条返回顶部,只支持竖向| | bindscrolltoupper | EventHandle | |滚动到顶部/左边,会触发 scrolltoupper 事件| | bindscrolltolower | EventHandle | |滚动到底部/右边,会触发 scrolltolower 事件| | bindscroll | EventHandle | | 滚动时触发,event.detail = {scrollLeft, scrollTop, scrollHeight, scrollWidth, deltaX, deltaY}| >使用竖向滚动时,需要给<scroll-view/>一个固定高度,通过 WXSS 设置 height。 示例代码: ``` <view class="section"> <view class="section__title">vertical scroll</view> <scroll-view scroll-y style="height: 200px;" bindscrolltoupper="upper" bindscrolltolower="lower" bindscroll="scroll" scroll-into-view="{{toView}}" scroll-top="{{scrollTop}}"> <view id="green" class="scroll-view-item bc_green"></view> <view id="red" class="scroll-view-item bc_red"></view> <view id="yellow" class="scroll-view-item bc_yellow"></view> <view id="blue" class="scroll-view-item bc_blue"></view> </scroll-view> <view class="btn-area"> <button size="mini" bindtap="tap">click me to scroll into view </button> <button size="mini" bindtap="tapMove">click me to scroll</button> </view> </view> <view class="section section_gap"> <view class="section__title">horizontal scroll</view> <scroll-view class="scroll-view_H" scroll-x style="width: 100%"> <view id="green" class="scroll-view-item_H bc_green"></view> <view id="red" class="scroll-view-item_H bc_red"></view> <view id="yellow" class="scroll-view-item_H bc_yellow"></view> <view id="blue" class="scroll-view-item_H bc_blue"></view> </scroll-view> </view> ``` ``` var order = ['red', 'yellow', 'blue', 'green', 'red'] Page({ data: { toView: 'red', scrollTop: 100 }, upper: function(e) { console.log(e) }, lower: function(e) { console.log(e) }, scroll: function(e) { console.log(e) }, tap: function(e) { for (var i = 0; i < order.length; ++i) { if (order[i] === this.data.toView) { this.setData({ toView: order[i + 1] }) break } } }, tapMove: function(e) { this.setData({ scrollTop: this.data.scrollTop + 10 }) } }) ``` ![](https://box.kancloud.cn/723eb37abbe87649188830e471b5c97b_371x624.png) >Bug & Tip 1. tip: 请勿在 scroll-view 中使用 textarea、map、canvas、video 组件 2. tip: scroll-into-view 的优先级高于 scroll-top 3. tip: 在滚动 scroll-view 时会阻止页面回弹,所以在 scroll-view 中滚动,是无法触发 onPullDownRefresh 4. tip: 若要使用下拉刷新,请使用页面的滚动,而不是 scroll-view ,这样也能通过点击顶部状态栏回到页面顶部