dykj-outsource-12123/uni_modules/uview-plus/components/u-waterfall/u-waterfall.vue
2024-06-28 14:18:30 +08:00

225 lines
9.0 KiB
Vue
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<template>
<view class="u-waterfall">
<view id="u-left-column" class="u-column">
<slot name="left" :leftList="leftList"></slot>
</view>
<view id="u-right-column" class="u-column">
<slot name="right" :rightList="rightList"></slot>
</view>
</view>
</template>
<script>
/**
* waterfall 瀑布流
* @description 这是一个瀑布流形式的组件内容分为左右两列结合uview的懒加载组件效果更佳。相较于某些只是奇偶数左右分别或者没有利用vue作用域插槽的做法uview的瀑布流实现了真正的 组件化搭配LazyLoad 懒加载和loadMore 加载更多组件,让您开箱即用,眼前一亮。
* @tutorial https://uview-plus.jiangruyi.com/components/waterfall.html
* @property {Array} flow-list 用于渲染的数据
* @property {String Number} add-time 单条数据添加到队列的时间间隔单位ms见上方注意事项说明默认200
* @example <u-waterfall :flowList="flowList"></u-waterfall>
*/
export default {
name: "u-waterfall",
props: {
// #ifdef VUE2
value: {
// 瀑布流数据
type: Array,
required: true,
default: function() {
return [];
}
},
// #endif
// #ifdef VUE3
modelValue: {
// 瀑布流数据
type: Array,
required: true,
default: function() {
return [];
}
},
// #endif
// 每次向结构插入数据的时间间隔,间隔越长,越能保证两列高度相近,但是对用户体验越不好
// 单位ms
addTime: {
type: [Number, String],
default: 200
},
// id值用于清除某一条数据时根据此idKey名称找到并移除如数据为{idx: 22, name: 'lisa'}
// 那么该把idKey设置为idx
idKey: {
type: String,
default: 'id'
}
},
data() {
return {
leftList: [],
rightList: [],
tempList: [],
children: []
}
},
watch: {
copyFlowList(nVal, oVal) {
// 取差值,即这一次数组变化新增的部分
let startIndex = Array.isArray(oVal) && oVal.length > 0 ? oVal.length : 0;
// 拼接上原有数据
this.tempList = this.tempList.concat(this.cloneData(nVal.slice(startIndex)));
this.splitData();
}
},
mounted() {
this.tempList = this.cloneData(this.copyFlowList);
this.splitData();
},
computed: {
// 破坏flowList变量的引用否则watch的结果新旧值是一样的
copyFlowList() {
// #ifdef VUE2
return this.cloneData(this.value);
// #endif
// #ifdef VUE3
return this.cloneData(this.modelValue);
// #endif
}
},
emits: ['update:modelValue'],
methods: {
async splitData() {
if (!this.tempList.length) return;
let leftRect = await this.$uGetRect('#u-left-column');
let rightRect = await this.$uGetRect('#u-right-column');
// 如果左边小于或等于右边,就添加到左边,否则添加到右边
let item = this.tempList[0];
// 解决多次快速上拉后可能数据会乱的问题因为经过上面的两个await节点查询阻塞一定时间加上后面的定时器干扰
// 数组可能变成[]导致此item值可能为undefined
if (!item) return;
if (leftRect.height < rightRect.height) {
this.leftList.push(item);
} else if (leftRect.height > rightRect.height) {
this.rightList.push(item);
} else {
// 这里是为了保证第一和第二张添加时,左右都能有内容
// 因为添加第一张实际队列的高度可能还是0这时需要根据队列元素长度判断下一个该放哪边
if (this.leftList.length <= this.rightList.length) {
this.leftList.push(item);
} else {
this.rightList.push(item);
}
}
// 移除临时列表的第一项
this.tempList.splice(0, 1);
// 如果临时数组还有数据,继续循环
if (this.tempList.length) {
setTimeout(() => {
this.splitData();
}, this.addTime)
}
},
// 复制而不是引用对象和数组
cloneData(data) {
return JSON.parse(JSON.stringify(data));
},
// 清空数据列表
clear() {
this.leftList = [];
this.rightList = [];
// 同时清除父组件列表中的数据
// #ifdef VUE2
this.$emit('input', []);
// #endif
// #ifdef VUE3
this.$emit('update:modelValue', []);
// #endif
this.tempList = [];
},
// 清除某一条指定的数据根据id实现
remove(id) {
// 如果findIndex找不到合适的条件就会返回-1
let index = -1;
index = this.leftList.findIndex(val => val[this.idKey] == id);
if (index != -1) {
// 如果index不等于-1说明已经找到了要找的id根据index索引删除这一条数据
this.leftList.splice(index, 1);
} else {
// 同理于上方面的方法
index = this.rightList.findIndex(val => val[this.idKey] == id);
if (index != -1) this.rightList.splice(index, 1);
}
// 同时清除父组件的数据中的对应id的条目
// #ifdef VUE2
index = this.value.findIndex(val => val[this.idKey] == id);
if (index != -1) this.$emit('input', this.value.splice(index, 1));
// #endif
// #ifdef VUE3
index = this.modelValue.findIndex(val => val[this.idKey] == id);
if (index != -1) this.$emit('input', this.modelValue.splice(index, 1));
// #endif
},
// 修改某条数据的某个属性
modify(id, key, value) {
// 如果findIndex找不到合适的条件就会返回-1
let index = -1;
index = this.leftList.findIndex(val => val[this.idKey] == id);
if (index != -1) {
// 如果index不等于-1说明已经找到了要找的id修改对应key的值
this.leftList[index][key] = value;
} else {
// 同理于上方面的方法
index = this.rightList.findIndex(val => val[this.idKey] == id);
if (index != -1) this.rightList[index][key] = value;
}
// 修改父组件的数据中的对应id的条目
// #ifdef VUE2
index = this.value.findIndex(val => val[this.idKey] == id);
// #endif
// #ifdef VUE3
index = this.modelValue.findIndex(val => val[this.idKey] == id);
// #endif
if (index != -1) {
// 首先复制一份value的数据
// #ifdef VUE2
let data = this.cloneData(this.value);
// #endif
// #ifdef VUE3
let data = this.cloneData(this.modelValue);
// #endif
// 修改对应索引的key属性的值为value
data[index][key] = value;
// 修改父组件通过v-model绑定的变量的值
// #ifdef VUE2
this.$emit('input', data);
// #endif
// #ifdef VUE3
this.$emit('update:modelValue', data);
// #endif
}
}
}
}
</script>
<style lang="scss" scoped>
@import "../../libs/css/components.scss";
.u-waterfall {
@include flex;
flex-direction: row;
align-items: flex-start;
}
.u-column {
@include flex;
flex: 1;
flex-direction: column;
height: auto;
}
.u-image {
width: 100%;
}
</style>