# 全局配置 1.5.8

说明

① 支持统一配置z-paging的所有属性,以下配置不是必须的!
② 在z-paging标签上的局部配置优先级高于全局配置。
③ 这里的全局配置不是全局引入组件,全局配置是指统一配置z-paging默认的属性值,z-paging遵循easycom组件规范,无需注册即可使用。
点击查看easycom组件规范 (opens new window)

  • (推荐)【方案1】2.6.5 在路径main.js中添加z-paging配置(具体位置没有要求,确保初始化项目执行到即可)
// main.js
uni.$zp = {
	config: {
		//配置分页默认pageSize为15
		'default-page-size': '15',
		//配置空数据图默认描述文字为:空空如也~~
		'empty-view-text': '空空如也~~',
		//...
	}
}
1
2
3
4
5
6
7
8
9
10
  • 【方案2】2.0.4 在文件 z-paging/config/index.js中进行配置,此方案所有平台兼容,但是需要注意更新插件时要避免被覆盖。

若同时配置了【方案1】,此配置生效优先级高于【方案1】

// z-paging/config/index.js
module.exports = {
	//配置分页默认pageSize为15
	'default-page-size': '15',
	//配置空数据图默认描述文字为:空空如也~~
	'empty-view-text': '空空如也~~',
	//...
}
1
2
3
4
5
6
7
8
  • 【已废弃】在路径@/uni_modules/z-paging下创建z-paging-config.js(与z-paging目录下的readme.md同级),z-paging-config.js中的内容如下所示。2.6.5起废弃

注意

此方案不支持vue3,在vue3中请使用【方案2】或【方案3】
此方案不支持使用npm安装z-paging的情况,使用npm安装时请使用【方案2】或【方案3】

module.exports = {
	//配置分页默认pageSize为15
	'default-page-size': '15',
	//配置空数据图默认描述文字为:空空如也~~
	'empty-view-text': '空空如也~~',
	//...
}
1
2
3
4
5
6
7
  • 【已废弃】在main.jsimport zConfig from '@/uni_modules/z-paging/components/z-paging/js/z-paging-config'(此路径为使用uni_modules情况下使用,可依照具体情况进行修改),然后进行z-paging的全局配置:2.6.5起废弃

注意

如果调用过setConfig进行配置,后期又需要取消配置,则必须设置zConfig.setConfig(null)将配置置空,因为setConfig是将配置设置在缓存中,直接删除配置代码将导致原先缓存的配置无法清空。

zConfig.setConfig({
	//配置分页默认pageSize为15
	'default-page-size': '15',
	//配置空数据图默认描述文字为:空空如也~~
	'empty-view-text': '空空如也~~',
	//...
})
1
2
3
4
5
6
7

# 拦截器 2.2.8

  • 支持全局对@query的参数进行拦截&修改
    main.jsimport ZPInterceptor from '@/uni_modules/z-paging/components/z-paging/js/z-paging-interceptor'(此路径为使用uni_modules情况下使用,可依照具体情况进行修改),然后可以对@query进行拦截&修改:
  • ZPInterceptor.handleQuery各参数说明:
    pageNo:当前第几页;
    pageSize:每页多少条;
    from:@query的触发来源:0.用户主动下拉刷新 1.通过reload触发 2.通过refresh触发 3.通过滚动到底部加载更多或点击底部加载更多触发;
    lastItem 2.5.8:当前列表最后一项。
import ZPInterceptor from '@/uni_modules/z-paging/components/z-paging/js/z-paging-interceptor'
ZPInterceptor.handleQuery((pageNo, pageSize, from, lastItem) => {
	//这里可以对pageNo, pageSize, from, lastItem进行一些处理后return,请注意需要return一个数组,数组中0、1、2的元素就代表@query中绑定方法获取到的参数,数组长度不一定为3,数组长度为多少,@query中的参数就有多少个
	return [pageNo, pageSize, from];
})
1
2
3
4
5