# 常规配置

参数 说明 类型 默认值 可选值
v-model 1.8.4 绑定最终的列表渲染变量(页面data中声明的值),当列表数据改变时,所绑定的变量会跟着改变 Array - -
default-page-no 自定义pageNo(第几页) Number|String 1 -
default-page-size 自定义pageSize(每页显示多少条)

(必须和后端的pageSize一致,例如后端分页的pageSize为15,此属性必须改为15)

Number|String 10 -
fixed 1.5.6 z-paging是否使用fixed布局,若使用fixed布局,则z-paging的父view无需固定高度,z-paging高度默认铺满屏幕,页面中的view请放在z-paging标签内,需要固定在顶部的view使用slot="top"包住。

(当使用内置scroll-view滚动时有效,nvue无效。若使用了fixed,请不要设置height:100%)

Boolean true false
safe-area-inset-bottom 1.6.1 是否开启底部安全区域适配 Boolean false true
use-page-scroll 使用页面滚动,默认为否,当设置为是时则使用页面的滚动而非此组件内部的scroll-view的滚动,使用页面滚动时z-paging无需设置确定的高度且对于长列表展示性能更高,但配置会略繁琐

(nvue中不建议使用页面滚动,nvue中默认使用list组件,性能远高于使用页面滚动。在nvue中使用页面滚动无法插入cell,且仅能使用页面的下拉刷新)

Boolean false true
auto-full-height 2.0.6 使用页面滚动时,是否在不满屏时自动填充满屏幕 Boolean true false
default-theme-style loading(下拉刷新、上拉加载更多)的主题样式,支持black,white String black white
paging-style 设置z-paging的style,部分平台(如微信小程序)无法直接修改组件的style,可使用此属性代替

(在使用fixed布局时,若要设置列表背景色,请设置page的背景色或使用:paging-style="{'background-color':'red'}"方式,因为此时z-paging的父view是没有高度的,给它们设置背景色无效)

Object - -
height 2.0.6 z-paging的高度,优先级低于paging-style中设置的height,传字符串,如100px、100rpx、100% String - -
width 2.0.6 z-paging的宽度,优先级低于paging-style中设置的width,传字符串,如100px、100rpx、100% String - -
bg-color 2.0.6 z-paging的背景色,优先级低于paging-style中设置的background-color。传字符串,如"#ffffff" String - -
delay 1.9.6 调用complete后延迟处理的时间,单位为毫秒,优先级高于min-delay Number|String 0 -
min-delay 2.0.9 触发@query后最小延迟处理的时间,单位为毫秒,优先级低于delay(假设设置为300毫秒,若分页请求时间小于300毫秒,则在调用complete后延迟[300毫秒-请求时长];若请求时长大于300毫秒,则不延迟) Number|String 0
(当show-refresher-when-reload为true或reload(true)时,其最小值为400)
-
list.sync

(建议使用v-model代替)

绑定最终的列表渲染变量(页面data中声明的值),当列表数据改变时,所绑定的变量会跟着改变
Array - -
refresher-status.sync 绑定下拉刷新状态改变的变量(页面data中声明的值),当下拉刷新状态改变时,此变量会跟着改变(0-默认状态 1.松手立即刷新 2.刷新中 3.刷新成功) Number - -
chat-index.sync 绑定聊天记录模式下当前聊天记录第一条index的变量(页面data中声明的值),当聊天记录第一条index改变时,此变量会跟着改变 Number - -