创新互联百度小程序教程:scroll-view可滚动视图区域

  • scroll-view 可滚动视图区域
    • 属性说明
    • 示例
      • 代码示例 1:纵向滚动
      • 代码示例 2:横向滚动
    • Bug & Tip
    • 常见问题
      • Q:scroll-view 的 scroll-top 设置是否是无效的?

    scroll-view 可滚动视图区域

    解释:可滚动视图区域,可实现横向滚动和竖向滚动。使用竖向滚动时,需要给定该组件一个固定高度,可以通过 CSS 设置 height 。

    属性说明

    属性名 类型 默认值 必填 说明

    scroll-x

    Boolean

    false

    允许横向滚动

    scroll-y

    Boolean

    false

    允许纵向滚动

    upper-threshold

    Number/String

    50

    距顶部 / 左边多远时(单位 px),触发 scrolltoupper 事件

    lower-threshold

    Number/String

    50

    距底部 / 右边多远时(单位 px),触发 scrolltolower 事件

    scroll-top

    Number/String

    设置竖向滚动条位置。要动态设置滚动条位置,用法scroll-top=”{= scrollTop =}”
    如果在设置组件渲染数据的同时设置了 scroll-top、scroll-left 值,需要在 swan.nextTick 回调中设置 scroll-top、scroll-left ,确保滚动条位置准确

    scroll-left

    Number/String

    设置横向滚动条位置。要动态设置滚动条位置,用法scroll-left=”{= scrollLeft =}”
    如果在设置组件渲染数据的同时设置了 scroll-top、scroll-left 值,需要在 swan.nextTick 回调中设置 scroll-top、scroll-left ,确保滚动条位置准确

    scroll-into-view

    String

    值应为某子元素 id(id 不能以数字开头)。设置滚动方向后,按方向滚动到该元素,动态设置用法scroll-into-view=”{= scrollIntoView =}”

    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}

    示例

    跳转编辑工具

    在开发者工具中打开

    在 WEB IDE 中打开

    扫码体验

    代码示例

    请使用百度APP扫码

    代码示例 1:纵向滚动

    • SWAN
    • JS
     
     
     
    1. 纵向滚动
    2. class="scroll-view"
    3. scroll-y
    4. upper-threshold="1"
    5. lower-threshold="1"
    6. scroll-top="{= scrollTop =}"
    7. scroll-into-view="{= scrollIntoView =}"
    8. scroll-with-animation="true"
    9. enable-back-to-top="true"
    10. bindscrolltoupper="upper"
    11. bindscrolltolower="lower"
    12. bindscroll="scroll">
    13. A
    14. B
    15. C
    16. 下一页
    17. 滚动
    18. 回顶部

    代码示例 2:横向滚动

    • SWAN
    • JS
     
     
     
    1. 横向滚动
    2. class="scroll-view"
    3. scroll-x
    4. bindscrolltoupper="toLeft"
    5. bindscrolltolower="toRight"
    6. scroll-left="{= scrollLeft =}"
    7. upper-threshold="1"
    8. lower-threshold="1"
    9. bindscroll="scroll">
    10. A
    11. B
    12. C

    Bug & Tip

    • Tip:请勿在 scroll-view 中使用 textarea、map、canvas、video 组件;详情请参考原生组件说明。
    • Tip:scroll-into-view 的优先级低于 scroll-top、scroll-left 。
    • Bug:在滚动 scroll-view 时会阻止页面回弹,所以在 scroll-view 中滚动,是无法触发 onPullDownRefresh 。
    • Tip:若要使用下拉刷新,请使用页面的滚动,而不是 scroll-view 。
    • Tip:scroll-into-view、scroll-top、scroll-left 需要在页面数据高度(或宽度)撑开时生效,若有异步加载数据,请在数据渲染完成时,重新动态赋值,才可生效。
    • Tip:在设置 scroll-view 组件 height 属性不是内容可视区总高度时,使用 swan.pageScrollTo API 无法生效。
    • Tip:暂不支持 border-radius 特性。

    常见问题

    Q:scroll-view 的 scroll-top 设置是否是无效的?

    A:使用竖向滚动时,需要给 一个固定高度,通过 CSS 设置 height 。

    代码示例

    在开发者工具中打开

    在开发者工具中打开

    在 WEB IDE 中打开

    • SWAN
    • JS
     
     
     
    1. 纵向滚动
    2. scroll-y
    3. style="height: 1.66rem;"
    4. scroll-into-view="{= toView =}"
    5. scroll-top="{= scrollTop =}"
    6. >
    7. A
    8. B
    9. C
    10. 回顶部

    分享名称:创新互联百度小程序教程:scroll-view可滚动视图区域
    文章网址:http://www.mswzjz.cn/qtweb/news3/465553.html

    攀枝花网站建设、攀枝花网站运维推广公司-贝锐智能,是专注品牌与效果的网络营销公司;服务项目有等

    广告

    声明:本网站发布的内容(图片、视频和文字)以用户投稿、用户转载内容为主,如果涉及侵权请尽快告知,我们将会在第一时间删除。文章观点不代表本网站立场,如需处理请联系客服。电话:028-86922220;邮箱:631063699@qq.com。内容未经允许不得转载,或转载时需注明来源: 贝锐智能