uview-ultra-plus 1.0.0

package/uview-ultra/libs/util/route.js

@@ -0,0 +1,124 @@
+/**
+ * 路由跳转方法，该方法相对于直接使用uni.xxx的好处是使用更加简单快捷
+ * 并且带有路由拦截功能
+ */
+import { queryParams, deepMerge, page } from '../function/index.js';
+class Router {
+    constructor() {
+        // 原始属性定义
+        this.config = {
+            type: 'navigateTo',
+            url: '',
+            delta: 1, // navigateBack页面后退时,回退的层数
+            params: {}, // 传递的参数
+            animationType: 'pop-in', // 窗口动画,只在APP有效
+            animationDuration: 300, // 窗口动画持续时间,单位毫秒,只在APP有效
+            intercept: false // 是否需要拦截
+        }
+        // 因为route方法是需要对外赋值给另外的对象使用，同时route内部有使用this，会导致route失去上下文
+        // 这里在构造函数中进行this绑定
+        this.route = this.route.bind(this)
+    }
+
+    // 判断url前面是否有"/"，如果没有则加上，否则无法跳转
+    addRootPath(url) {
+        return url[0] === '/' ? url : `/${url}`
+    }
+
+    // 整合路由参数
+    mixinParam(url, params) {
+        url = url && this.addRootPath(url)
+
+        // 使用正则匹配，主要依据是判断是否有"/","?","="等，如“/page/index/index?name=mary"
+        // 如果有url中有get参数，转换后无需带上"?"
+        let query = ''
+        if (/.*\/.*\?.*=.*/.test(url)) {
+            // object对象转为get类型的参数
+            query = queryParams(params, false)
+            // 因为已有get参数,所以后面拼接的参数需要带上"&"隔开
+            return url += `&${query}`
+        }
+        // 直接拼接参数，因为此处url中没有后面的query参数，也就没有"?/&"之类的符号
+        query = queryParams(params)
+        return url += query
+    }
+
+    // 对外的方法名称
+    async route(options = {}, params = {}) {
+        // 合并用户的配置和内部的默认配置
+        let mergeConfig = {}
+
+        if (typeof options === 'string') {
+            // 如果options为字符串，则为route(url, params)的形式
+            mergeConfig.url = this.mixinParam(options, params)
+            mergeConfig.type = 'navigateTo'
+        } else {
+            mergeConfig = deepMerge(this.config, options)
+            // 否则正常使用mergeConfig中的url和params进行拼接
+            mergeConfig.url = this.mixinParam(options.url, options.params)
+        }
+
+        // 如果本次跳转的路径和本页面路径一致，不执行跳转，防止用户快速点击跳转按钮，造成多次跳转同一个页面的问题
+        if (mergeConfig.url === page()) return
+
+        if (params.intercept) {
+            this.config.intercept = params.intercept
+        }
+        // params参数也带给拦截器
+        mergeConfig.params = params
+        // 合并内外部参数
+        mergeConfig = deepMerge(this.config, mergeConfig)
+        // 判断用户是否定义了拦截器
+        if (typeof uni.$u.routeIntercept === 'function') {
+            // 定一个promise，根据用户执行resolve(true)或者resolve(false)来决定是否进行路由跳转
+            const isNext = await new Promise((resolve, reject) => {
+                uni.$u.routeIntercept(mergeConfig, resolve)
+            })
+            // 如果isNext为true，则执行路由跳转
+            isNext && this.openPage(mergeConfig)
+        } else {
+            this.openPage(mergeConfig)
+        }
+    }
+
+    // 执行路由跳转
+    openPage(config) {
+        // 解构参数
+        const {
+            url,
+            type,
+            delta,
+            animationType,
+            animationDuration
+        } = config
+        if (config.type == 'navigateTo' || config.type == 'to') {
+            uni.navigateTo({
+                url,
+                animationType,
+                animationDuration
+            })
+        }
+        if (config.type == 'redirectTo' || config.type == 'redirect') {
+            uni.redirectTo({
+                url
+            })
+        }
+        if (config.type == 'switchTab' || config.type == 'tab') {
+            uni.switchTab({
+                url
+            })
+        }
+        if (config.type == 'reLaunch' || config.type == 'launch') {
+            uni.reLaunch({
+                url
+            })
+        }
+        if (config.type == 'navigateBack' || config.type == 'back') {
+            uni.navigateBack({
+                delta
+            })
+        }
+    }
+}
+
+export default (new Router()).route

package/uview-ultra/libs/util/route.uts

@@ -0,0 +1,130 @@
+/**
+ * 路由跳转方法，该方法相对于直接使用uni.xxx的好处是使用更加简单快捷
+ * 并且带有路由拦截功能
+ */
+import { queryParams, deepMerge, page } from '../function/index';
+class Router {
+	config: UTSJSONObject = {}
+
+    constructor() {
+        // 原始属性定义
+        this.config = {
+            type: 'navigateTo',
+            url: '',
+            delta: 1, // navigateBack页面后退时,回退的层数
+            params: {}, // 传递的参数
+            animationType: 'pop-in', // 窗口动画,只在APP有效
+            animationDuration: 300, // 窗口动画持续时间,单位毫秒,只在APP有效
+            intercept: false // 是否需要拦截
+        } as UTSJSONObject
+        // 因为route方法是需要对外赋值给另外的对象使用，同时route内部有使用this，会导致route失去上下文
+        // 这里在构造函数中进行this绑定
+        // this.route = this.route.bind(this)
+    }
+
+    // 判断url前面是否有"/"，如果没有则加上，否则无法跳转
+    addRootPath(url: string) {
+        return url.indexOf('/') == 0 ? url : `/${url}`
+    }
+
+    // 整合路由参数
+    mixinParam(url: string, params: UTSJSONObject) {
+        url = url != '' ? url : this.addRootPath(url)
+
+        // 使用正则匹配，主要依据是判断是否有"/","?","="等，如“/page/index/index?name=mary"
+        // 如果有url中有get参数，转换后无需带上"?"
+        let query = ''
+        if (/.*\/.*\?.*=.*/.test(url)) {
+            // object对象转为get类型的参数
+            query = queryParams(params, false)
+            // 因为已有get参数,所以后面拼接的参数需要带上"&"隔开
+			url = url + `&${query}`
+            return url
+        }
+        // 直接拼接参数，因为此处url中没有后面的query参数，也就没有"?/&"之类的符号
+        query = queryParams(params) as String
+		url = url + query
+        return url
+    }
+
+    // 对外的方法名称
+    async route(options: UTSJSONObject = {}, params: UTSJSONObject = {}): Promise<any> {
+        // 合并用户的配置和内部的默认配置
+        let mergeConfig:UTSJSONObject = {}
+
+        if (typeof options === 'string') {
+            // 如果options为字符串，则为route(url, params)的形式
+            mergeConfig['url'] = this.mixinParam(options.toString(), params)
+            mergeConfig['type'] = 'navigateTo'
+        } else {
+            mergeConfig = deepMerge(this.config, options) as UTSJSONObject
+            // 否则正常使用mergeConfig中的url和params进行拼接
+			let url = options.getString('url')
+            mergeConfig['url'] = this.mixinParam(
+				url ?? '', 
+				options.getJSON('params') ?? {}
+			)
+        }
+
+        // 如果本次跳转的路径和本页面路径一致，不执行跳转，防止用户快速点击跳转按钮，造成多次跳转同一个页面的问题
+        if (mergeConfig['url'] === page()) return
+
+        if (params['intercept'] != null) {
+            this.config['intercept'] = params['intercept']
+        }
+        // params参数也带给拦截器
+        mergeConfig['params'] = params
+        // 合并内外部参数
+        mergeConfig = deepMerge(this.config, mergeConfig) as UTSJSONObject
+        // todo判断用户是否定义了拦截器
+        // if (typeof routeIntercept === 'function') {
+        //     // 定一个promise，根据用户执行resolve(true)或者resolve(false)来决定是否进行路由跳转
+        //     const isNext = await new Promise((resolve, reject) => {
+        //         routeIntercept(mergeConfig, resolve)
+        //     })
+        //     // 如果isNext为true，则执行路由跳转
+        //     isNext && this.openPage(mergeConfig)
+        // } else {
+            this.openPage(mergeConfig)
+        // }
+		return
+    }
+
+    // 执行路由跳转
+    openPage(config: UTSJSONObject) {
+		// let url: string = config.getString('url').toString()
+		// let type: string = config.getString('type').toString()
+		// let delta: number = config.getNumber('delta') ?? 1
+		// let animationType: string = config.getString('animationType').toString()
+		// let animationDuration: number = config.getNumber('animationDuration') ?? 0
+  //       if (config['type'] == 'navigateTo' || config['type'] == 'to') {
+  //           uni.navigateTo({
+  //               url,
+  //               animationType: animationType ?? '',
+  //               animationDuration
+  //           })
+  //       }
+  //       if (config['type'] == 'redirectTo' || config['type'] == 'redirect') {
+  //           uni.redirectTo({
+  //               url
+  //           })
+  //       }
+  //       if (config['type'] == 'switchTab' || config['type'] == 'tab') {
+  //           uni.switchTab({
+  //               url
+  //           })
+  //       }
+  //       if (config['type'] == 'reLaunch' || config['type'] == 'launch') {
+  //           uni.reLaunch({
+  //               url
+  //           })
+  //       }
+  //       if (config['type'] == 'navigateBack' || config['type'] == 'back') {
+  //           uni.navigateBack({
+  //               delta
+  //           })
+  //       }
+    }
+}
+
+export default (new Router()).route()

package/uview-ultra/libs/vue.js

@@ -0,0 +1,3 @@
+export const defineMixin = (options) => {
+  return options
+}

package/uview-ultra/libs/vue.uts

@@ -0,0 +1,8 @@
+// #ifdef APP
+export * from 'vue'
+// #endif
+// #ifdef WEB
+export const defineMixin = (options: any) => {
+	return options
+}
+// #endif

package/uview-ultra/package.json

@@ -0,0 +1,108 @@
+{
+  "id": "uview-ultra",
+  "name": "uview-ultra",
+  "displayName": "零云®UviewUltra v4重磅发布，大满贯全面兼容uniapp-x、uniapp鸿蒙组件库。",
+  "version": "4.2.48",
+  "description": "uview-ultra全面兼容uni-app/uni-app-x/鸿蒙/nvue，全面的组件和便捷的工具会让您信手拈来，如鱼得水",
+  "keywords": [
+    "uview",
+    "uview-plus",
+    "uview-ultra",
+    "ultraUI",
+    "uni-app"
+],
+  "main": "index.js",
+  "engines": {
+    "HBuilderX": "^3.1.0",
+    "uni-app": "^4.87",
+    "uni-app-x": "^4.87"
+  },
+  "dcloudext": {
+    "sale": {
+      "regular": {
+        "price": "0.00"
+      },
+      "sourcecode": {
+        "price": "0.00"
+      }
+    },
+    "contact": {
+      "qq": "1295585851"
+    },
+    "declaration": {
+      "ads": "无",
+      "data": "无",
+      "permissions": "无"
+    },
+    "type": "component-vue",
+    "darkmode": "x",
+    "i18n": "√",
+    "widescreen": "x"
+  },
+  "uni_modules": {
+    "dependencies": ["lime-dayuts"],
+    "encrypt": [],
+    "platforms": {
+      "cloud": {
+        "tcb": "√",
+        "aliyun": "√",
+        "alipay": "√"
+      },
+      "client": {
+        "uni-app": {
+          "vue": {
+            "vue2": "-",
+            "vue3": "√"
+          },
+          "web": {
+            "safari": "√",
+            "chrome": "√"
+          },
+          "app": {
+            "vue": "√",
+            "nvue": "√",
+            "android": "√",
+            "ios": "√",
+            "harmony": "√"
+          },
+          "mp": {
+            "weixin": "√",
+            "alipay": "√",
+            "toutiao": "√",
+            "baidu": "-",
+            "kuaishou": "-",
+            "jd": "-",
+            "harmony": "-",
+            "qq": "√",
+            "lark": "-"
+          },
+          "quickapp": {
+            "huawei": "-",
+            "union": "-"
+          }
+        },
+        "uni-app-x": {
+          "web": {
+            "safari": "√",
+            "chrome": "√"
+          },
+          "app": {
+            "android": "√",
+            "ios": "√",
+            "harmony": "√"
+          },
+          "mp": {
+            "weixin": "√"
+          }
+        }
+      }
+    }
+  },
+  "dependencies": {
+    "clipboard": "^2.0.11",
+    "dayjs": "^1.11.3"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/"
+  }
+}

package/uview-ultra/theme.scss

@@ -0,0 +1,77 @@
+// 此文件为组件库主题变量，这些变量目前只能通过uni.scss引入才有效，另外由于
+// uni.scss中引入的样式会同时混入到全局样式文件和单独每一个页面的样式中，造成微信程序包太大，
+// 故uni.scss只建议放scss变量名相关样式，其他的样式可以通过main.js或者App.vue引入
+
+$up-main-color: #303133;
+$up-content-color: #606266;
+$up-tips-color: #909193;
+$up-light-color: #c0c4cc;
+$up-border-color: #dadbde;
+$up-bg-color: #f3f4f6;
+$up-disabled-color: #c8c9cc;
+
+$up-primary: #3c9cff;
+$up-primary-dark: #398ade;
+$up-primary-disabled: #9acafc;
+$up-primary-light: #ecf5ff;
+
+$up-warning: #f9ae3d;
+$up-warning-dark: #f1a532;
+$up-warning-disabled: #f9d39b;
+$up-warning-light: #fdf6ec;
+
+$up-success: #5ac725;
+$up-success-dark: #53c21d;
+$up-success-disabled: #a9e08f;
+$up-success-light: #f5fff0;
+
+$up-error: #f56c6c;
+$up-error-dark: #e45656;
+$up-error-disabled: #f7b2b2;
+$up-error-light: #fef0f0;
+
+$up-info: #909399;
+$up-info-dark: #767a82;
+$up-info-disabled: #c4c6c9;
+$up-info-light: #f4f4f5;
+
+$u-main-color: $up-main-color;
+$u-content-color: $up-content-color;
+$u-tips-color: $up-tips-color;
+$u-light-color: $up-light-color;
+$u-border-color: $up-border-color;
+$u-bg-color: $up-bg-color;
+$u-disabled-color: $up-disabled-color;
+
+$u-primary: $up-primary;
+$u-primary-dark: $up-primary-dark;
+$u-primary-disabled: $up-primary-disabled;
+$u-primary-light: $up-primary-light;
+
+$u-warning: $up-warning;
+$u-warning-dark: $up-warning-dark;
+$u-warning-disabled: $up-warning-disabled;
+$u-warning-light: $up-warning-light;
+
+$u-success: $up-success;
+$u-success-dark: $up-success-dark;
+$u-success-disabled: $up-success-disabled;
+$u-success-light: $up-success-light;
+
+$u-error: $up-error;
+$u-error-dark: $up-error-dark;
+$u-error-disabled: $up-error-disabled;
+$u-error-light: $up-error-light;
+
+$u-info: $up-info;
+$u-info-dark: $up-info-dark;
+$u-info-disabled: $up-info-disabled;
+$u-info-light: $up-info-light;
+
+// scss混入，为了少写几行#ifndef
+@mixin flex($direction: row) {
+	/* #ifndef APP-NVUE */
+	display: flex;
+	/* #endif */
+	flex-direction: $direction;
+}

package/uview-ultra/types/common.uts

@@ -0,0 +1,14 @@
+export type UPCommonStyle = {
+	color ?: string,
+	fontSize ?: string,
+	backgroundColor ?: string,
+	borderRadius ?: string,
+	width ?: string,
+	height ?: string,
+	margin ?: string,
+	padding ?: string,
+	transform ?: string,
+	borderColor ?: string,
+}
+
+export {}

package/uview-ultra/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/uview-ultra/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

package/uview-ultra/types/comps/album.d.ts

@@ -0,0 +1,82 @@
+import { AllowedComponentProps, VNodeProps } from './_common'
+
+declare interface AlbumProps {
+  /**
+   * 图片地址列表
+   */
+  urls?: string[] | Record<string, any>[]
+  /**
+   * 指定从数组的对象元素中读取哪个属性作为图片地址
+   */
+  keyName?: string
+  /**
+   * 单图时，图片长边的长度
+   * @default 180
+   */
+  singleSize?: string | number
+  /**
+   * 多图时，图片边长
+   * @default 70
+   */
+  multipleSize?: string | number
+  /**
+   * 多图时，图片水平和垂直之间的间隔
+   * @default 6
+   */
+  space?: string | number
+  /**
+   * 单图时，图片缩放裁剪的模式
+   * @default "scaleToFill"
+   */
+  singleMode?: ImageMode
+  /**
+   * 多图时，图片缩放裁剪的模式
+   * @default "aspectFill"
+   */
+  multipleMode?: ImageMode
+  /**
+   * 最多展示的图片数量，超出时最后一个位置将会显示剩余图片数量
+   * @default 9
+   */
+  maxCount?: string | number
+  /**
+   * 是否可以预览图片
+   * @default true
+   */
+  previewFullImage?: boolean
+  /**
+   * 每行展示图片数量，如设置，singleSize和multipleSize将会无效
+   * @default 3
+   */
+  rowCount?: string | number
+  /**
+   * 超出maxCount时是否显示查看更多的提示
+   * @default true
+   */
+  showMore?: boolean
+  /**
+   * 某些特殊的情况下，需要让文字与相册的宽度相等，这里事件的形式对外发送
+   * @param width 宽度
+   */
+  onAlbumWidth?: (width: any) => any
+  /**
+   * 图片形状
+   * @default "square"
+   */
+  shape?: 'circle' | 'square'
+  /**
+   * 圆角，默认单位px
+   * @default 0
+   */
+  radius?: string | number
+}
+
+declare interface _Album {
+  new (): {
+    $props: AllowedComponentProps &
+      VNodeProps &
+      AlbumProps
+  }
+}
+
+export declare const Album: _Album