uview-plus 3.1.52 → 3.2.5

package/components/u-waterfall/u-waterfall.vue

@@ -0,0 +1,225 @@
+<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>

package/index.js

@@ -34,8 +34,11 @@ import color from './libs/config/color.js'
 import platform from './libs/function/platform'
 
 // 导出
+const http = new Request()
+let themeType = ['primary', 'success', 'error', 'warning', 'info'];
+export { route, http, debounce, throttle, platform, themeType, mixin, mpMixin, props, color, test, zIndex }
 export * from './libs/function/index.js'
-export const http = new Request()
+export * from './libs/function/colorGradient.js'
 
 const $u = {
     route,
@@ -45,7 +48,7 @@ const $u = {
     rgbToHex: colorGradient.rgbToHex,
     colorToRgba: colorGradient.colorToRgba,
     test,
-    type: ['primary', 'success', 'error', 'warning', 'info'],
+    type: themeType,
     http,
     config, // uview-plus配置信息相关，比如版本号
     zIndex,

package/libs/config/props/formItem.js

@@ -14,6 +14,7 @@ export default {
         prop: '',
         rule: '',
         borderBottom: '',
+        labelPosition: '',
         labelWidth: '',
         rightIcon: '',
         leftIcon: '',

package/libs/config/props/tag.js

@@ -1,29 +1,30 @@
-/*
- * @Author       : LQ
- * @Description  :
- * @version      : 1.0
- * @Date         : 2021-08-20 16:44:21
- * @LastAuthor   : LQ
- * @lastTime     : 2021-08-20 17:23:37
- * @FilePath     : /u-view2.0/uview-ui/libs/config/props/tag.js
- */
-export default {
-    // tag 组件
-    tag: {
-        type: 'primary',
-        disabled: false,
-        size: 'medium',
-        shape: 'square',
-        text: '',
-        bgColor: '',
-        color: '',
-        borderColor: '',
-        closeColor: '#C6C7CB',
-        name: '',
-        plainFill: false,
-        plain: false,
-        closable: false,
-        show: true,
-        icon: ''
-    }
-}
+/*
+ * @Author       : LQ
+ * @Description  :
+ * @version      : 1.0
+ * @Date         : 2021-08-20 16:44:21
+ * @LastAuthor   : LQ
+ * @lastTime     : 2021-08-20 17:23:37
+ * @FilePath     : /u-view2.0/uview-ui/libs/config/props/tag.js
+ */
+export default {
+	// tag 组件
+	tag: {
+		type: 'primary',
+		disabled: false,
+		size: 'medium',
+		shape: 'square',
+		text: '',
+		bgColor: '',
+		color: '',
+		borderColor: '',
+		closeColor: '#C6C7CB',
+		name: '',
+		plainFill: false,
+		plain: false,
+		closable: false,
+		show: true,
+		icon: '',
+		iconColor: ''
+	}
+}

package/libs/css/common.scss

@@ -1,5 +1,5 @@
 // 超出行数，自动显示行尾省略号，最多5行
-// 来自uView的温馨提示：当您在控制台看到此报错，说明需要在App.vue的style标签加上【lang="scss"】
+// 来自uview-plus的温馨提示：当您在控制台看到此报错，说明需要在App.vue的style标签加上【lang="scss"】
 @for $i from 1 through 5 {
 	.u-line-#{$i} {
 		/* #ifdef APP-NVUE */
@@ -95,3 +95,6 @@
 	opacity: 0.7;
 }
 
+.cursor-pointer {
+    cursor: pointer;
+}

package/libs/css/components.scss

@@ -1,11 +1,11 @@
 @import "./mixin.scss";
 
 /* #ifndef APP-NVUE */
-// 由于uView是基于nvue环境进行开发的，此环境中普通元素默认为flex-direction: column;
-// 所以在非nvue中，需要对元素进行重置为flex-direction: column; 否则可能会表现异常
-view,
-scroll-view,
-swiper-item,
+// 由于uview-plus是基于nvue环境进行开发的，此环境中普通元素默认为flex-direction: column;
+// 所以在非nvue中，需要对元素进行重置为flex-direction: column; 否则可能会表现异常
+// 2024-04-09由于微信小程序会提示 Some selectors are not allowed in component wxss所以注释以下几行
+// scroll-view,
+// swiper-item,
 .u-empty,
 .u-empty__wrap,
 .u-tabs,

package/libs/css/flex.scss

@@ -188,74 +188,74 @@
 // 以下属于项目(子元素)的类
 
 // 子元素交叉轴起点对齐
-// .u-flex-self-start {
-// 	align-self: flex-start;
-// }
+.u-flex-self-start {
+	align-self: flex-start;
+}
 
-// // 子元素交叉轴居中对齐
-// .u-flex-self-center {
-// 	align-self: center;
-// }
+// 子元素交叉轴居中对齐
+.u-flex-self-center {
+	align-self: center;
+}
 
-// // 子元素交叉轴终点对齐
-// .u-flex-self-end {
-// 	align-self: flex-end;
-// }
+// 子元素交叉轴终点对齐
+.u-flex-self-end {
+	align-self: flex-end;
+}
 
 // 子元素交叉轴第一行文字基线对齐
-// .u-flex-self-baseline {
-// 	align-self: baseline;
-// }
+.u-flex-self-baseline {
+	align-self: baseline;
+}
 
-// // 子元素交叉轴方向拉伸对齐
-// .u-flex-self-stretch {
-// 	align-self: stretch;
-// }
+// 子元素交叉轴方向拉伸对齐
+.u-flex-self-stretch {
+	align-self: stretch;
+}
 
 // 多轴交叉时的对齐方式
 
 // 起点对齐
-// .u-flex-content-start {
-// 	align-content: flex-start;
-// }
+.u-flex-content-start {
+	align-content: flex-start;
+}
 
-// // 居中对齐
-// .u-flex-content-center {
-// 	align-content: center;
-// }
+// 居中对齐
+.u-flex-content-center {
+	align-content: center;
+}
 
-// // 终点对齐
-// .u-flex-content-end {
-// 	align-content: flex-end;
-// }
+// 终点对齐
+.u-flex-content-end {
+	align-content: flex-end;
+}
 
-// // 两端对齐
-// .u-flex-content-between {
-// 	align-content: space-between;
-// }
+// 两端对齐
+.u-flex-content-between {
+	align-content: space-between;
+}
 
-// // 均分间距
-// .u-flex-content-around {
-// 	align-content: space-around;
-// }
+// 均分间距
+.u-flex-content-around {
+	align-content: space-around;
+}
 
 // 全部居中对齐
 .u-flex-middle {
 	justify-content: center;
 	align-items: center;
-	// align-self: center;
-	// align-content: center;
+	align-self: center;
+	align-content: center;
 }
 
 // 是否可以放大
-// .u-flex-grow {
-// 	flex-grow: 1;
-// }
+.u-flex-grow {
+	flex-grow: 1;
+}
 
 // 是否可以缩小
-// .u-flex-shrink {
-// 	flex-shrink: 1;
-// }
+.u-flex-shrink {
+	flex-shrink: 1;
+}
 
 // 定义内外边距，历遍1-80
 @for $i from 0 through 80 {

package/libs/mixin/mixin.js

@@ -145,8 +145,8 @@ export default {
     },
     onReachBottom() {
         uni.$emit('uOnReachBottom')
-    },
-    beforeDestroy() {
+	},
+	beforeUnmount() {
         // 判断当前页面是否存在parent和chldren，一般在checkbox和checkbox-group父子联动的场景会有此情况
         // 组件销毁时，移除子组件在父组件children数组中的实例，释放资源，避免数据混乱
         if (this.parent && uni.$u.test.array(this.parent.children)) {

package/libs/mixin/mpShare.js

@@ -1,13 +1,15 @@
-export default {
-    onLoad() {
-        // 设置默认的转发参数
-        uni.$u.mpShare = {
-            title: '', // 默认为小程序名称
-            path: '', // 默认为当前页面路径
-            imageUrl: '' // 默认为当前页面的截图
-        }
-    },
-    onShareAppMessage() {
-        return uni.$u.mpShare
-    }
-}
+
+export default {
+    data() {
+        return {
+            mpShare: {
+                title: '', // 默认为小程序名称
+                path: '', // 默认为当前页面路径
+                imageUrl: '' // 默认为当前页面的截图 
+            }
+        }
+    },
+    onShareAppMessage() {
+        return this.mpShare;
+    }
+}

package/package.json

@@ -2,7 +2,7 @@
 	"id": "uview-plus",
 	"name": "uview-plus",
 	"displayName": "uview-plus3.0重磅发布，全面的Vue3移动组件库。",
-	"version": "3.1.52",
+	"version": "3.2.5",
 	"description": "uview-plus已兼容vue3，全面的组件和便捷的工具会让您信手拈来，如鱼得水",
 	"keywords": [
         "uview",

package/types/comps/_common.d.ts

@@ -0,0 +1,9 @@
+export interface AllowedComponentProps {
+  class?: unknown;
+  style?: unknown;
+}
+
+export interface VNodeProps {
+  key?: string | number | symbol;
+  ref?: unknown;
+}

package/types/comps/actionSheet.d.ts

@@ -0,0 +1,121 @@
+import { AllowedComponentProps, VNodeProps } from './_common'
+
+declare interface ActionSheetProps {
+  /**
+   * 是否展示
+   * @default false
+   */
+  show?: boolean
+  /**
+   * 设置标题
+   */
+  title?: string
+  /**
+   * 选项上方的描述信息
+   */
+  description?: string
+  /**
+   * 按钮的文字数组
+   * @default []
+   */
+  actions?: any[]
+  /**
+   * 取消按钮的文字，不为空时显示按钮
+   */
+  cancelText?: string
+  /**
+   * 点击某个菜单项时是否关闭弹窗
+   */
+  closeOnClickAction?: string
+  /**
+   * 是否开启底部安全区适配
+   * @default false
+   */
+  safeAreaInsetBottom?: boolean
+  /**
+   * 小程序的打开方式
+   */
+  openType?: string
+  /**
+   * 点击遮罩是否允许关闭
+   */
+  closeOnClickOverlay?: boolean
+  /**
+   * 圆角值，默认无圆角
+   * @default 0
+   */
+  round?: string | number
+  /**
+   * 指定返回用户信息的语言
+   * @default "en"
+   */
+  lang?: 'zh_CN' | 'zh_TW' | 'en'
+  /**
+   * 会话来源，open-type="contact"时有效。只微信小程序有效
+   */
+  sessionFrom?: string
+  /**
+   * 会话内消息卡片标题，openType="contact"时有效
+   */
+  sendMessageTitle?: string
+  /**
+   * 会话内消息卡片点击跳转小程序路径，openType="contact"时有效
+   */
+  sendMessagePath?: string
+  /**
+   * 会话内消息卡片图片，openType="contact"时有效
+   */
+  sendMessageImg?: string
+  /**
+   * 是否显示会话内消息卡片，设置此参数为 true，用户进入客服会话会在右下角显示"可能要发送的小程序"提示，用户点击后可以快速发送小程序消息，openType="contact"时有效
+   * @default false
+   */
+  showMessageCard?: boolean
+  /**
+   * 打开 APP 时，向 APP 传递的参数，openType=launchApp 时有效
+   */
+  appParameter?: string
+  /**
+   * 点击ActionSheet列表项时触发
+   */
+  onSelect?: () => any
+  /**
+   * 点击取消按钮时触发
+   */
+  onClose?: () => any
+  /**
+   * 获取用户信息回调，openType="getUserInfo"时有效
+   * @param detail 用户信息
+   */
+  onGetuserinfo?: (detail: any) => any
+  /**
+   * 客服消息回调，openType="contact"时有效
+   */
+  onContact?: () => any
+  /**
+   * 获取用户手机号回调，openType="getPhoneNumber"时有效
+   */
+  onGetphonenumber?: () => any
+  /**
+   * 当使用开放能力时，发生错误的回调
+   */
+  onError?: (...args: any) => any
+  /**
+   * 在打开授权设置页并关闭后回调
+   */
+  onOpensetting?: (...args: any) => any
+  /**
+   * 打开 APP 成功的回调
+   */
+  onLaunchapp?: (...args: any) => any
+}
+
+declare interface _ActionSheet {
+  new (): {
+    $props: AllowedComponentProps &
+      VNodeProps &
+      ActionSheetProps
+  }
+}
+
+export declare const ActionSheet: _ActionSheet