1.0.5 • Published 7 years ago

ly-scroll v1.0.5

Weekly downloads
-
License
ISC
Repository
-
Last release
7 years ago

功能:基于 better-scroll 封装的移动端滑动组件

注意1:使用前请先安装 npm install --save-dev better-scroll

注意2:使用 ly-scroll 外部必须有一个div容器定义可滑动区域大小,内部需要一个唯一子元素存放内容

例如:

  <div style="width: 100%; height: 400px" >
    <ly-scroll>
      <div>
        // 内容 scroll需要一个唯一子元素div存放内容
      </div>
    </ly-scroll>
  </div>

注意3:元素 margin 属性会对滚动区域造成影响,使用前请先 reset 样式,如body, ul 的 默认 margin 为 0

属性1:data 监听数据更新时同步更新滚动区域 例如:

    <ly-scroll :data="list" >
      <ul>
        <li v-for="item in list" >...</li>
      </ul>
    </ly-scroll>

属性2:pullup 是否启用上拉加载 默认 false, true 时监听事件 scrollToEnd 例如:

  <ly-scroll :pullup="open" @scrollToEnd="底部上拉时你想触发的事件" >
    // 内容
  </ly-scroll>
  ...
  data () {
    return {
      open: true,
    }
  },

属性3:pulldown 是否启用下拉刷新 默认 false, true 时监听事件 scrollToStart 例如:

  <ly-scroll :pulldown="open" @scrollToStart="顶部下拉时你想触发的事件" >
    // 内容
  </ly-scroll>
  ...
  data () {
    return {
      open: true,
    }
  },

属性4:listenScroll 是否监听实时滚动事件 默认 false, true 时监听事件 scroll((x, y)) 接收参数(x, y) 为滚动的实时位置坐标 例如:

  <ly-scroll :listenScroll="open" @scroll="滚动时触发事件(x, y)" >
    // 内容
  </ly-scroll>
  ...
  data () {
    return {
      open: true,
    }
  },

属性5: direction="horizontal" 开启横向滚动 默认:vertical 为垂直滚动 例如:

  <div style="width: 100%; height: 400px" >
    <ly-scroll direction="horizontal" >
      <div>
        // 内容 scroll需要一个唯一子元素div存放内容
        // 注意水平布局 display: inline-block; white-space: nowrap;
      </div>
    </ly-scroll>
  </div>

方法1: scrollToElement(el) 滚动到指定元素 ## 此处注意该元素需在可滚动范围内 例如:

    <ly-scroll ref="scroll" >
      <ul>
        <li ref="one" >1</li>
        <li>2</li>
        <li>3</li>
        <li>4</li>
      </ul>
    </ly-scroll>
    // 在需要滚动的时候调用可滚到指定元素
    // this.$refs.scroll.scrollToElement(this.$refs.one)

方法2: scrollTo(x, y) 滚动到指定坐标 ## 此处注意该坐标需在可滚动范围内 例如:

    <ly-scroll ref="scroll" >
      <ul>
        <li ref="one" >1</li>
        <li>2</li>
        <li>3</li>
        <li>4</li>
      </ul>
    </ly-scroll>
    // 在需要滚动的时候调用可滚到指定坐标
    // this.$refs.scroll.scrollTo(0, 0)

其它属性与方法:待补充

联系作者:772748611@qq.com

1.0.5

7 years ago

1.0.4

7 years ago

1.0.3

7 years ago

1.0.2

7 years ago

1.0.1

7 years ago

1.0.0

7 years ago