Skip to content

Commit 32f6c30

Browse files
SmileZXLeeSmileZXLee
committed
v0.1.2-released
1 parent 64c14da commit 32f6c30

File tree

4 files changed

+38
-12
lines changed

4 files changed

+38
-12
lines changed

‎z-paging-x/uni_modules/z-paging-x/changelog.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,11 @@
1+
## 0.1.2（2024-01-03）
2+
1.`新增` 滑动切换选项卡+吸顶演示 & list相关配置。
3+
2.`新增` props `empty-error-text` & `empty-error-img`，支持配置空数据图加载失败文字&图片。
4+
3.`新增` 方法 `completeByError`，在请求结束(失败)调用此方法，将自动展示失败页面 。
5+
4.`新增` slots `loadMore`，支持自定义底部加载更多view。
6+
5.`新增` event `refresh`，支持监听用户下拉刷新。
7+
6.`修复` 下拉刷新显示最后更新时间时，时间更新可能不及时的问题。
8+
7.`修复` 下拉刷新和底部加载更多loading动画未持续执行的问题。
19
## 0.1.1（2023-12-26）
210
1.`新增` 支持下拉刷新view自定义各种状态文字&下拉刷新背景色。
311
2.`新增` 支持底部加载更多view配置自定义状态文字。

‎z-paging-x/uni_modules/z-paging-x/components/z-paging-x/z-paging-x.uvue

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -329,7 +329,7 @@ by ZXLee
329329
// this.totalData = [];
330330
this._emitQuery(this.pageNo, this.pageSize);
331331
},
332-
// 请求结束(成功或者失败)调用此方法，将请求的结果传递给z-paging-x处理，第一个参数为请求结果数组，第二个参数为是否成功(默认是是）
332+
// 请求结束(成功)调用此方法，将请求的结果数组传递给z-paging-x处理
333333
complete(data: null | any[]) {
334334
const finalData: any[] = data === null ? [] : data;
335335
this.isLoadFailed = false;
@@ -354,7 +354,7 @@ by ZXLee
354354
this.totalData = this.totalData.concat(currentData);
355355
}
356356
},
357-
// 请求结束(成功或者失败)调用此方法，将请求的结果传递给z-paging-x处理，第一个参数为请求结果数组，第二个参数为是否成功(默认是是）
357+
// 请求结束(失败)调用此方法，将自动展示失败页面
358358
completeByError() {
359359
this.isLoadFailed = true;
360360
this.endRefresh();

‎z-paging-x/uni_modules/z-paging-x/package.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
"id": "z-paging-x",
33
"name": "z-paging-x",
44
"displayName": "z-paging-x",
5-
"version": "0.1.1",
5+
"version": "0.1.2",
66
"description": "z-paging现已支持uniapp x！持续完善中~",
77
"keywords": [
88
"z-paging-x"

‎z-paging-x/uni_modules/z-paging-x/readme.md

Lines changed: 27 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -95,6 +95,18 @@ npm update z-paging-x
9595
| auto | mounted后自动调用reload方法(mounted后自动调用接口) | Boolean | true | false |
9696
| paging-style | 自定义组件的样式 | Object | {} | - |
9797

98+
#### list-view&scroll-view相关配置
99+
100+
| 参数 | 说明 | 类型 | 默认值 | 可选值 |
101+
| :------------------- | :----------------------------------------------------------- | :------ | :-------- | :---------- |
102+
| list-is | list的类型：`list-view`或`scroll-view` | String | list-view | scroll-view |
103+
| list-id | list的id | String | '' | - |
104+
| show-scrollbar | 控制是否出现滚动条 | Boolean | true | false |
105+
| rebound | 控制是否回弹效果 | Boolean | true | false |
106+
| custom-nested-scroll | (子元素中使用)子元素是否开启嵌套滚动，将滚动事件与父元素协商处理 | Boolean | false | true |
107+
| start-nested-scroll | (仅listIs = scroll-view有效，父元素中使用)是否与子元素开启滚动协商 | Boolean | false | true |
108+
| nested-scroll-child | (仅listIs = scroll-view有效)嵌套滚动子元素的id属性，不支持ref，scroll-view惯性滚动时会让对应id元素视图进行滚动，子元素滚动时会触发scroll-view的`nestedprescroll`事件，嵌套子元素需要设置`custom-nested-scroll` = true | String | '' | - |
109+
98110
#### 下拉刷新配置
99111

100112
| 参数 | 说明 | 类型 | 默认值 | 可选值 |
@@ -121,10 +133,12 @@ npm update z-paging-x
121133

122134
#### 空数据图配置
123135

124-
| 参数 | 说明 | 类型 | 默认值 | 可选值 |
125-
| :--------- | :------------------------------------- | :----- | :---------- | :----- |
126-
| empty-text | 空数据描述文字 | String | 没有数据哦~ | - |
127-
| empty-img | 空数据图片，默认使用z-paging内置的图片 | String | - | - |
136+
| 参数 | 说明 | 类型 | 默认值 | 可选值 |
137+
| :--------------- | :----------------------------------------------- | :----- | :--------------- | :----- |
138+
| empty-text | 空数据描述文字 | String | 没有数据哦~ | - |
139+
| empty-img | 空数据图片，默认使用z-paging-x内置的图片 | String | - | - |
140+
| empty-error-text | 空数据加载失败文字 | String | 很抱歉，加载失败 | - |
141+
| empty-error-img | 空数据加载失败图片，默认使用z-paging-x内置的图片 | String | - | - |
128142

129143
#### 点击返回顶部配置
130144

@@ -140,16 +154,19 @@ npm update z-paging-x
140154
| 事件名 | 说明 | 回调参数 |
141155
| --------------- | ------------------------------------------------------------ | ------------------------------------------------------------ |
142156
| @query | 下拉刷新或滚动到底部时会自动触发此方法。`z-paging-x`加载时也会触发(若要禁止，请设置`:auto="false"`)。pageNo和pageSize会自动计算好，直接传给服务器即可。 | `参数1`:pageNo(当前第几页)；<br/>`参数2`:pageSize(每页多少条)(pageSize必须与传给服务器的一致，如果需要修改pageSize，请通过`:default-page-size="15"`修改) |
157+
| @refresh | 下拉刷新被触发 | - |
143158
| @scroll | 列表滚动时触发 | `参数1`:(event: [ScrollEvent](https://doc.dcloud.net.cn/uni-app-x/component/list-view.html#scrollevent)) => void |
144159
| @backToTopClick | | 点击返回顶部按钮后是否滚动到顶部，默认为是。<br/>如果需要禁止滚动到顶部事件，则在page的methods中书写：<p style="font-weight:bold;">backToTopClick(e: (toTop: boolean) => void) {<br/> &nbsp;&nbsp;&nbsp;&nbsp;e(false);<br/> &nbsp;&nbsp;&nbsp;&nbsp;//处理自己的业务逻辑<br/>}</p> |
145160

146161
### methods
147162

148-
| 方法名 | 说明 | 参数 |
149-
| ----------- | ------------------------------------------------------------ | ---------------------------- |
150-
| reload | 重新加载分页数据，pageNo恢复为默认值，相当于下拉刷新的效果 | - |
151-
| complete | 请求结束(成功或者失败)调用此方法，将请求的结果传递给`z-paging-x`处理，会自动判断是否有更多数据(当通过`complete`传进去的数组长度小于`pageSize`时，则判定为没有更多了)。 | `参数1(必填)`:请求结果数组； |
152-
| scrollToTop | 滚动到顶部 | - |
163+
| 方法名 | 说明 | 参数 |
164+
| --------------- | ------------------------------------------------------------ | ---------------------------- |
165+
| reload | 重新加载分页数据，pageNo恢复为默认值，相当于下拉刷新的效果 | - |
166+
| complete | 请求结束(成功)调用此方法，将请求的结果数组传递给z-paging-x处理 | `参数1(必填)`:请求结果数组； |
167+
| completeByError | 请求结束(失败)调用此方法，将自动展示失败页面 | - |
168+
| scrollToTop | 滚动到顶部 | |
169+
153170

154171
### slots
155172

@@ -158,4 +175,5 @@ npm update z-paging-x
158175
| top | 可以将自定义导航栏、tab-view等需要固定的`(不需要跟着滚动的)`元素放入`slot="top"`的view中。<br/>注意，当有多个需要固定的view时，请用一个view包住它们，并且在这个view上设置`slot="top"`。需要固定在顶部的view请勿设置`position: fixed;` |
159176
| bottom | 可以将需要固定在底部的`(不需要跟着滚动的)`元素放入`slot="bottom"`的view中。<br/>注意，当有多个需要固定的view时，请用一个view包住它们，并且在这个view上设置`slot="bottom"`。需要固定在底部的view请勿设置`position: fixed;`。 |
160177
| refresher | 自定义下拉刷新view，设置后则不使用uni自带的下拉刷新view和z-paging自定义的下拉刷新view。<br>slot-scope="{ refresherStatus(0-默认状态 1.松手立即刷新 2.刷新中 3.刷新成功) }" |
178+
| loadMore | 自定义底部加载更多view，设置后则不使用z-paging-x内置的下拉刷新view。<br/>slot-scope="{ loadMoreStatus(0-默认状态 1.加载中 2.没有更多数据 3.加载失败) }" |
161179
| backToTop | 自定义点击返回顶部view |

0 commit comments

Comments
 (0)