# 通过插件市场安装

# ① 在插件市场 (opens new window)中访问z-paging。

# ② 点击【使用HbuilderX导入插件】。

# ③ 选择目标项目并导入。

提示

z-paging 使用uni_modules管理,导入的项目会在uni_modules目录下,在uni_modules下右键z-paging可以快速地从插件市场更新

注意

若不想使用uni_modules,可以在插件市场中点击【下载插件ZIP】,解压后将z-paging(必须)、z-paging-empty-view(必须)、z-paging-swiper(可选)和z-paging-swiper-item(可选)放到项目的components目录下。

注意

z-paging遵循easycom规范 (opens new window),无需注册即可使用。

注意

在支付宝和钉钉小程序中,必须在pages.json中进行如下设置:

// 以下代码可以写在globalStyle中或特定页面的style中
// 支付宝和钉钉小程序需要取消回弹效果
"mp-alipay": {
  "allowsBounceVertical": "NO"
}
1
2
3
4
5

# 通过npm安装

为多端兼容考虑,建议优先从插件市场 (opens new window)获取插件

// 若项目之前未使用npm管理依赖(项目根目录下无package.json文件),先在项目根目录执行命令初始化npm工程
npm init -y

// 安装
npm install z-paging --save
// 更新
npm update z-paging
1
2
3
4
5
6
7

注意

下方配置只有在通过npm安装的时候才要配置!!!!!!!!

注意

(v2.4.6之前)使用npm方式安装编译会提示WARNING: Module not found: Error: Can't resolve' @/uni_modules/z-paging'
此警告不影响正常使用,若需要消除此警告,请至源码的z-paging-utils.js文件中,按照注释提示注释相关代码。

pages.json中配置easycom

"easycom": {
	"custom": {
	    "^(?!z-paging-refresh|z-paging-load-more)z-paging(.*)": "z-paging/components/z-paging$1/z-paging$1.vue"
	}
}
1
2
3
4
5

vue.config.js(没有这个文件则在项目根目录下创建)中添加配置

module.exports = {
	transpileDependencies: ['z-paging']
}
1
2
3