189 8069 5689

创新互联百度小程序教程: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://cdxtjz.cn/article/djeghop.html

    联系我们

    您好HELLO!
    感谢您来到成都网站建设公司,若您有合作意向,请您为我们留言或使用以下方式联系我们, 我们将尽快给你回复,并为您提供真诚的设计服务,谢谢。
    • 电话:028- 86922220 18980695689
    • 商务合作邮箱:631063699@qq.com
    • 合作QQ: 532337155
    • 成都网站设计地址:成都市青羊区锣锅巷31号五金站写字楼6楼

    小谭建站工作室

    成都小谭网站建设公司拥有多年以上互联网从业经验的团队,始终保持务实的风格,以"帮助客户成功"为已任,专注于提供对客户有价值的服务。 我们已为众企业及上市公司提供专业的网站建设服务。我们不只是一家网站建设的网络公司;我们对营销、技术、管理都有自己独特见解,小谭建站采取“创意+综合+营销”一体化的方式为您提供更专业的服务!

    小谭观点

    相对传统的成都网站建设公司而言,小谭是互联网中的网站品牌策划,我们精于企业品牌与互联网相结合的整体战略服务。
    我们始终认为,网站必须注入企业基因,真正使网站成为企业vi的一部分,让整个网站品牌策划体系变的深入而持久。