|
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176 |
- <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://www.uviewui.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: {
- value: {
- // 瀑布流数据
- type: Array,
- required: true,
- default: function() {
- return [];
- }
- },
- // 每次向结构插入数据的时间间隔,间隔越长,越能保证两列高度相近,但是对用户体验越不好
- // 单位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() {
- return this.cloneData(this.value);
- }
- },
- 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 = [];
- // 同时清除父组件列表中的数据
- this.$emit('input', []);
- 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的条目
- index = this.value.findIndex(val => val[this.idKey] == id);
- if(index != -1) this.$emit('input', this.value.splice(index, 1));
- },
- // 修改某条数据的某个属性
- 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的条目
- index = this.value.findIndex(val => val[this.idKey] == id);
- if(index != -1) {
- // 首先复制一份value的数据
- let data = this.cloneData(this.value);
- // 修改对应索引的key属性的值为value
- data[index][key] = value;
- // 修改父组件通过v-model绑定的变量的值
- this.$emit('input', data);
- }
- }
- }
- }
- </script>
-
- <style lang="scss" scoped>
- @import "../../libs/css/style.components.scss";
-
- .u-waterfall {
- @include vue-flex;
- flex-direction: row;
- align-items: flex-start;
- }
-
- .u-column {
- @include vue-flex;
- flex: 1;
- flex-direction: column;
- height: auto;
- }
-
- .u-image {
- width: 100%;
- }
- </style>
|