Skip to content

Page 页面

基础用法

  • 页面容器,是页面的根节点。使用页面容器可帮助您快速布局页面,无需手动管理滚动相关组件及事件。
  • 支持动态修改页面背景色、全局背景色。
vue
<template>
	<sn-page bgColor="#f0f0f0"></sn-page>
</template>

更多演示请下载 demo 查看

属性

参数说明类型默认值可选值
scrollOn是否开启滚动功能Booleantruetrue | false
scrollTop设置竖向滚动条位置Number0-
scrollWithAnimation滚动是否使用动画Booleantruetrue | false
direction滚动方向(vertical 或 horizontal)Stringverticalvertical | horizontal
upperThreshold距顶部/左边多远时,触发 scrolltoupper 事件Number50-
lowerThreshold距底部/右边多远时,触发 scrolltolower 事件Number50-
bgColor页面背景颜色String$page-
padding页面内边距String0 15px-
bounces是否启用回弹效果Booleantruetrue | false
customStyle自定义页面样式UTSJSONObject{}-

方法

名称参数返回值描述
scrollTo(x: number, y: number)-滚动页面到指定位置

事件

名称类型说明
scrolltoupper(e: UniScrollToUpperEvent) => void滚动到顶部时触发
scrolltolower(e: UniScrollToLowerEvent) => void滚动到底部时触发
scroll(e: UniScrollEvent) => void滚动时触发
scrollend(e: UniScrollEvent) => void滚动结束时触发
refresherpulling(event: UniRefresherEvent) => void下拉刷新控件被下拉
refresherrefresh(event: UniRefresherEvent) => void下拉刷新被触发
refresherrestore(event: UniRefresherEvent) => void下拉刷新被复位
refresherabort(event: UniRefresherEvent) => void下拉刷新被中止
startnestedscroll(event: UniStartNestedScrollEvent) => Boolean子元素开始滚动时触发, return true表示与子元素开启滚动协商 默认return false! event =
nestedprescroll(event: UniNestedPreScrollEvent) => void子元素滚动时触发,可执行event.consumed(x,y)告知子元素deltaX、deltaY各消耗多少。子元素将执行差值后的deltaX、deltaY滚动距离。不执行consumed(x,y)则表示父元素不消耗deltaX、deltaY。event =
stopnestedscroll(event: UniStopNestedScrollEvent) => void子元素滚动结束或意外终止时触发

插槽

名称说明
default放置页面内容

使用 MIT 协议