diff --git a/.gitignore b/.gitignore index 5c990e822df0665bcd28790b58b32879c230e99e..5a2bf9890eb3cd4d70c2a5230eca085466fab48f 100644 --- a/.gitignore +++ b/.gitignore @@ -1,3 +1 @@ -uniapp-extend/unpackage/dist/dev/ -uniapp-extend/unpackage/dist/build/* -!uniapp-extend/unpackage/dist/build/h5/ \ No newline at end of file +uniapp-extend/unpackage \ No newline at end of file diff --git a/uniapp-extend/pages.json b/uniapp-extend/pages.json index 2c4c0d9fa194cb89e934c97f2680d97eeb79d1fb..233088535ea227667907d82c73df901afad7bdd9 100644 --- a/uniapp-extend/pages.json +++ b/uniapp-extend/pages.json @@ -191,7 +191,6 @@ "navigationBarTitleText": "瀑布流", "enablePullDownRefresh": true } - } ,{ "path" : "pages/template/optimized-swiper", diff --git a/uniapp-extend/uni_modules/helang-tabBar/components/helang-tabBar/tab-bar-slide.vue b/uniapp-extend/uni_modules/helang-tabBar/components/helang-tabBar/tab-bar-slide.vue index 18bea9603373d1cc15983508ff7088763b5c7de4..4f9e0f8dca1f488879c0231a760cae17d7a250b7 100644 --- a/uniapp-extend/uni_modules/helang-tabBar/components/helang-tabBar/tab-bar-slide.vue +++ b/uniapp-extend/uni_modules/helang-tabBar/components/helang-tabBar/tab-bar-slide.vue @@ -2,7 +2,7 @@ - + diff --git a/uniapp-extend/uni_modules/helang-waterfall/changelog.md b/uniapp-extend/uni_modules/helang-waterfall/changelog.md index 63f302645aded10e1221636494eaec111ed0038d..344391d3dbb94f5ff8326ee6bcfed4befde0b0d6 100644 --- a/uniapp-extend/uni_modules/helang-waterfall/changelog.md +++ b/uniapp-extend/uni_modules/helang-waterfall/changelog.md @@ -1,3 +1,15 @@ +## 1.1.6(2022-10-24) +修复 初始化渲染变量取值错误问题 +## 1.1.5(2022-10-24) +初始化渲染增加状态条件判断 +## 1.1.4(2022-10-24) +修改空数据提示 +## 1.1.3(2022-10-24) +1、增加内容插槽 + +2、删除状态文本属性 + +3、组件创建时可触发渲染条件 ## 1.1.2(2022-09-26) 修改了开启布局的判断条件 ## 1.1.1(2022-08-28) diff --git a/uniapp-extend/uni_modules/helang-waterfall/components/waterfall/waterfall-item.vue b/uniapp-extend/uni_modules/helang-waterfall/components/waterfall/waterfall-item.vue index 804edca217f4067bf316764f926ee176dca0ddc2..258a15d39b187b95a2a2d1e4d0ee660576606579 100644 --- a/uniapp-extend/uni_modules/helang-waterfall/components/waterfall/waterfall-item.vue +++ b/uniapp-extend/uni_modules/helang-waterfall/components/waterfall/waterfall-item.vue @@ -16,7 +16,10 @@ @@ -157,4 +208,40 @@ page { background-color: #f3f3f3; } + + .load-txt{ + padding: 0 0 20rpx 0; + text-align: center; + color: #999; + font-size: 24rpx; + } + + .load-icon{ + width: 300rpx; + height: 300rpx; + margin: 0 auto 20rpx auto; + display: block; + } + + .status-change{ + position: fixed; + right: 10rpx; + top: 60%; + width: 80rpx; + height: 80rpx; + z-index: 100; + font-size: 24rpx; + border-radius: 50%; + background-color: #0089ff; + color: #fff; + line-height: 1; + opacity: .33; + + display: flex; + flex-direction: row; + flex-wrap: nowrap; + justify-content: center; + align-items: center; + align-content: center; + } \ No newline at end of file diff --git a/uniapp-extend/uni_modules/helang-waterfall/static/waterfall/empty.png b/uniapp-extend/uni_modules/helang-waterfall/static/waterfall/empty.png new file mode 100644 index 0000000000000000000000000000000000000000..8b287516ef006526bd41015143deaa9f66d0dffd Binary files /dev/null and b/uniapp-extend/uni_modules/helang-waterfall/static/waterfall/empty.png differ diff --git a/uniapp-extend/uni_modules/helang-waterfall/static/waterfall/fail.png b/uniapp-extend/uni_modules/helang-waterfall/static/waterfall/fail.png new file mode 100644 index 0000000000000000000000000000000000000000..e1e1e49c880ac40af7e9279249cc3dee2b23632b Binary files /dev/null and b/uniapp-extend/uni_modules/helang-waterfall/static/waterfall/fail.png differ diff --git "a/\346\226\207\346\241\243/\347\200\221\345\270\203\346\265\201.md" "b/\346\226\207\346\241\243/\347\200\221\345\270\203\346\265\201.md" index 9eb0cb71dc15ec1231180265a88f9fc50b8d7b48..b18556a2d201fe2b4a78bfb0d4a155de3f1e157c 100644 --- "a/\346\226\207\346\241\243/\347\200\221\345\270\203\346\265\201.md" +++ "b/\346\226\207\346\241\243/\347\200\221\345\270\203\346\265\201.md" @@ -8,7 +8,10 @@ ### 瀑布流组件的渲染触发条件是什么? -#### 控制瀑布流的渲染条件是 `status` 属性,当 `status="success"` 时,组件将会开始计算布局,计算完成后渲染列表效果。切记,需要触发渲染,需要将 `status` 设置为 `success` ,并且是由 非 `success` 转为 `success`。 +#### 瀑布流组件的渲染触发情况有2种 + +1. 控制瀑布流的渲染条件是 `status` 属性,当 `status="success"` 时,组件将会开始计算布局,计算完成后渲染列表效果。切记,需要触发渲染,需要将 `status` 设置为 `success` ,并且是由 非 `success` 转为 `success`。 +2. 如果组件在创建时, `status` 属性是 `success`,并且 `list` 属性的数据长度大于 0。 ## 下载&体验 @@ -35,67 +38,12 @@ ## 组件引用 -``` - - -/* 引用组件 */ -import helangWaterfallList from "@/uni_modules/helang-waterfall/components/waterfall/waterfall-list" - -export default { - components: { - "helang-waterfall-list": helangWaterfallList - }, - data() { - return { - // ... - // 瀑布流组件相关 - waterfall:{ - status:"", - reset:false, - list:[] - } - } - }, - onReady(){ - // 设置瀑布流组件为加载中 - this.waterfall.status = "loading"; - // 设置瀑布流组件需要渲染的数据 - this.waterfall.list = 你的数据集 // 一个JSON数组,参考示例的模拟数据 - // 设置瀑布流组件为成功,即开始计算列表布局 - this.waterfall.status = "success"; - }, - methods:{ - // 监听瀑布流点击 - onClick(data,index, tag){ - console.log("数据",data); - console.log("序号",index); - console.log("标签",tag); - }, - // 瀑布流渲染完成 - onDone(){ - // 设置组件为 非重置,这行代码保留不删即可 - this.waterfall.reset = false; - - // 恢复 getList 方法的调用 - this.ajax.load = true; - this.ajax.page++; - - // 设置组件状态为 等待加载 - this.waterfall.status = 'await'; - } - } -} -``` +### 组件的使用示例代码较多,建议下载 示例项目体验。详情见 waterfall.vue 文件 + +### waterfall-list 插槽 +名称 | 说明 +--------|------|------ +default | 可往组件内插入自定义内容,常用于显示组件不同状态下的提示内容。可参考示例项目 ### waterfall-list 组件属性说明 @@ -103,12 +51,7 @@ export default { --------|------|------ status | String | 组件状态,默认`空字符串`,可选值看下方 `status` 属性说明 list | Array | 待渲染的数据,默认值`[]` -reset | Boolean | 重置列表,默认值`false`,设置为 true 时,瀑布流会自动重新渲染列表 -awaitText | String | 等待加载文案,默认值`上拉加载更多` -loadingText | String | 加载中文案,默认值`加载中` -successText | String | 加载成功文案,默认值`加载中`,一般与加载中保持一致即可,主要为提示组件可以开始渲染了 -finishText | String | 加载结束文案,默认值`没有更多了`,用于没有更多数据时候展示 -failText | String | 加载失败文案,默认值`加载失败`,用于数据获取异常时展示 +reset | Boolean | 重置列表,默认值`false`,设置为 true 时,瀑布流在渲染时会清除之前的列表内容 ### waterfall-list 组件 status 属性说明 @@ -118,7 +61,8 @@ await | 等待加载 loading | 等待加载 success | 加载成功 finish | 加载结束 -fail | 加载失败 +fail | 加载失败,该状态下组件不展示列表内容 +empty | 内容为空,该状态下组件不展示列表内容 ### waterfall-list 组件方法说明