# 数据&布局配置
| 参数 | 说明 | 类型 | 默认值 | 可选值 |
|---|---|---|---|---|
| v-model 1.8.4 | 绑定最终的列表渲染变量(页面data中声明的值)，当列表数据改变时，所绑定的变量会跟着改变 (当调用z-paging的 | 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"包住，需要固定在底部的view使用slot="bottom"包住。(若不需要z-paging铺满全屏，例如希望在弹窗内使用z-paging，请设置 | Boolean | true | false |
| safe-area-inset-bottom 1.6.1 | 是否开启底部安全区域适配 | Boolean | false | true |
| use-safe-area-placeholder 2.2.7 | 开启底部安全区域适配后，是否使用placeholder形式实现。为否时滚动区域会自动避开底部安全区域，也就是所有滚动内容都不会挡住底部安全区域，若设置为是，则滚动时滚动内容会挡住底部安全区域，但是当滚动到底部时才会避开底部安全区域 ( (若设置了 | Boolean | false | true |
| use-page-scroll | 使用页面滚动，默认为否，当设置为是时则使用页面的滚动而非此组件内部的scroll-view的滚动，使用页面滚动时z-paging无需设置确定的高度且对于长列表展示性能更高，但配置会略繁琐 (特别注意：必须引入 (nvue中不建议使用页面滚动，nvue中默认使用list组件，性能远高于使用页面滚动。在nvue中使用页面滚动无法插入 | 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 | - | - |
| max-height 2.7.6 | z-paging的最大宽度，优先级低于paging-style中设置的max-width；传字符串，如100px、100rpx、100%。默认为空，也就是铺满窗口宽度，若设置了特定值则会自动添加margin: 0 auto | String | - | - |
| bg-color 2.0.6 | z-paging的背景色(为css中的background，因此也可以设置渐变，背景图片等)，优先级低于paging-style中设置的background-color。传字符串，如"#ffffff" | String | - | - |
| watch-touch-direction-change 2.3.0 | 是否监听列表触摸方向改变 | Boolean | false | true |
| 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) | - |
| call-network-reject 2.6.1 | 请求失败是否触发reject，若设置为否，则this.$refs.paging.reload().catch(() => {})、this.$refs.paging.complete().catch(() => {})等数据处理类型的catch在请求失败时不会触发，且未捕获请求失败catch时异常不会在控制台抛出 | Boolean | true | false |
| unit 2.6.7 | z-paging中默认布局的单位 | String | rpx | px |
| concat 1.8.8 | 自动拼接complete中传过来的数组(使用聊天记录模式时无效) (若设置为false，则complete中传过来的数组会直接覆盖list) | Boolean | true | false |
| data-key 1.6.4 | 为保证数据一致，设置当前tab切换时的标识key，并在complete中传递相同key，若二者不一致，则complete将不会生效 (关于数据一致性，请查看demo中 | Number|Object | - | - |
| autowire-list-name 1.8.5 | 【极简写法】自动注入的list名，可自动修改父view(包含ref="paging")中对应name的list值 z-paging标签必须设置 | String | "" | - |
| autowire-query-name 1.8.5 | 【极简写法】自动注入的query名，可自动调用父view(包含ref="paging")中的query方法 z-paging标签必须设置 | String | "" | - |
| list.sync | (建议使用v-model代替) 绑定最终的列表渲染变量(页面data中声明的值)，当列表数据改变时，所绑定的变量会跟着改变 | Array | - | - |
| refresher-status.sync | 绑定下拉刷新状态改变的变量(页面data中声明的值)，当下拉刷新状态改变时，此变量会跟着改变（0-默认状态 1.松手立即刷新 2.刷新中 3.刷新成功） | Number | - | - |
| chat-index.sync | 绑定聊天记录模式下当前聊天记录第一条index的变量(页面data中声明的值)，当聊天记录第一条index改变时，此变量会跟着改变 | Number | - | - |
| virtualList.sync 2.2.7 | 虚拟列表当前渲染的数组改变时触发，在虚拟列表中只会渲染可见区域内+预加载页面的数据。当列表数据改变时，所绑定的变量会跟着改变 | Array | - | - |
← 全局配置&拦截器 reload相关配置 →