# myScrollView可滑动view

提示

myScrollView组件是uniapp中比较基础的组件.可以实现x轴/y轴的滚动.

# 基本使用


<template>
  <view>
    <myScrollView height="300" scrollY>
      <myView v-for="(item,index) in 10" :key="index" background="red" marginBottom="10" width="100" height="100">
      </myView>
    </myScrollView>
  </view>
</template>

# Props属性

参数 说明 类型 默认值
scrollX 允许横向滚动 Boolean false
scrollY 允许纵向滚动 Boolean false
upperThreshold 距顶部/左边多远时(单位px),触发 scrolltoupper 事件 Number\String 50
lowerThreshold 距底部/右边多远时(单位px),触发 scrolltolower 事件 Number\String 50
scrollTop 设置竖向滚动条位置 Number\String ''
scrollLeft 设置横向滚动条位置 Number\String ''
scrollIntoView 值应为某子元素id(id不能以数字开头)。设置哪个方向可滚动,则在哪个方向滚动到该元素 String ''
scrollWithAnimation 在设置滚动条位置时使用动画过渡 Boolean false
enableBackToTop iOS点击顶部状态栏、安卓双击标题栏时,滚动条返回顶部,只支持竖向 app-nvue,微信小程序 Boolean false
showScrollbar 控制是否出现滚动条 App-nvue 2.1.5+ Boolean false
refresherEnabled 开启自定义下拉刷新 Boolean false
refresherThreshold 设置自定义下拉刷新阈值 Number\String 45
refresherDefaultStyle 设置自定义下拉刷新默认样式,支持设置 black,white,none,none 表示不使用默认样式 String 'black'
refresherBackground 设置自定义下拉刷新区域背景颜色 String '#FFF'
refresherTriggered 设置当前下拉刷新状态,true 表示下拉刷新已经被触发,false 表示下拉刷新未被触发 Boolean false
enableFlex 启用 flexbox 布局。开启后,当前节点声明了 display: flex 就会成为 flex container,并作用于其孩子节点。 微信小程序 2.7.3 Boolean false
scrollAnchoring 开启 scroll anchoring 特性,即控制滚动位置不随内容变化而抖动,仅在 iOS 下生效,安卓下可参考 CSS overflow-anchor 属性。 微信小程序 2.8.2 Boolean false
width scrollX为真的时候需要设置宽度 Number\String ''
height scrollY为真的时候需要设置高度 Number\String ''
margin 外边距 Number\String ''
marginLeft 距离左侧 Number\String ''
marginRight 距离右侧 Number\String ''
marginTop 距离顶部 Number\String ''
marginBottom 距离下边 Number\String ''
background 背景 String ''
customStyle 自定义样式 Object {}

# Event事件

事件名 说明 回调参数
scrolltoupper 滚动到顶部/左边,会触发 scrolltoupper 事件
scrolltolower 滚动到底部/右边,会触发 scrolltolower 事件
scroll 滚动时触发,event.detail = {scrollLeft, scrollTop, scrollHeight, scrollWidth, deltaX, deltaY}
refresherpulling 自定义下拉刷新控件被下拉 H5、app-vue 2.5.12+,微信小程序基础库2.10.1+
refresherrefresh 自定义下拉刷新被触发 H5、app-vue 2.5.12+,微信小程序基础库2.10.1+
refresherrestore 自定义下拉刷新被复位 H5、app-vue 2.5.12+,微信小程序基础库2.10.1+
refresherabort 自定义下拉刷新被中止
confirm 点击滚动栏