uview-pro 0.0.3 → 0.0.5

package/changelog.md

@@ -1,9 +1,164 @@
+## 0.0.5（2025-08-19）
+
+### ✨ Features | 新功能
+
+-   新增 u-city-select 城市选择器组件 ([0eb4806](https://gitee.com/anyup/uView-Pro/commit/0eb4806db3be39e1a6c6f33c9ea511d8445da884))
+-   完善 u-button 的 open-type 支持类型 ([37c0db5](https://gitee.com/anyup/uView-Pro/commit/37c0db527258bca57dbd55d7013b633230489853))
+
+### 🐛 Bug Fixes | Bug 修复
+
+-   u-upload 暴露 lists 属性 ([09f8424](https://gitee.com/anyup/uView-Pro/commit/09f8424774baaee3b6fc7a42458949f8d5903951))
+-   u-upload 深度监听文件列表变化并优化事件触发 ([a41a571](https://gitee.com/anyup/uView-Pro/commit/a41a5719ddf9d6793b78c55a13025bbdc88fdfe3))
+
+### 🚀 Demos | 示例页面优化
+
+-   优化关于页面布局和内容 ([ad5f6a4](https://gitee.com/anyup/uView-Pro/commit/ad5f6a47847999268b43b8c5dbf1a34cb8f70802))
+-   删除分类数据文件 ([5ed7a11](https://gitee.com/anyup/uView-Pro/commit/5ed7a1113db58ff493ad606296a210358348affe))
+-   重构 index list 页面 ([13d780e](https://gitee.com/anyup/uView-Pro/commit/13d780ea5acc4c8eed72062482735df826d4b37a))
+-   更新商场菜单组件引用 ([a5f1bf3](https://gitee.com/anyup/uView-Pro/commit/a5f1bf3f256705d6cad028d60701b4b0544332de))
+-   修改图片地址 ([c459893](https://gitee.com/anyup/uView-Pro/commit/c459893848936aa9a44e7bda3277ab1428109869))
+-   重构 upload 上传组件示例页面 ([686831d](https://gitee.com/anyup/uView-Pro/commit/686831de357aca67bbf7015e2f0696cf6bf48164))
+-   优化多个组件的代码结构和样式 ([f2af44c](https://gitee.com/anyup/uView-Pro/commit/f2af44ca1710334495e4c4fad99d04027b3788f8))
+-   添加提交规范相关配置文件 git-cz/husky/changelog ([d93b816](https://gitee.com/anyup/uView-Pro/commit/d93b816a5a3e468c4bc45e3161d7c006cba5fbf6))
+-   优化 deepClone 和 deepMerge 页面的结果展示 ([b0daa70](https://gitee.com/anyup/uView-Pro/commit/b0daa700b6a385e037d38dc1f10b3612596e2403))
+-   新增优惠券模板 ([1b77762](https://gitee.com/anyup/uView-Pro/commit/1b777621615f7ebe9d83606d53650987c8b2c4e0))
+-   更新 easycom 配置说明，一定要放在 custom 里，否则不生效 ([fc14bf9](https://gitee.com/anyup/uView-Pro/commit/fc14bf90cb77088d258e20e79e3d25820f37e97e))
+-   添加模板示例页面 ([3336af4](https://gitee.com/anyup/uView-Pro/commit/3336af406161648d18578c988d9b3ad79b86059a))
+-   新增模版相关页面 ([8925a02](https://gitee.com/anyup/uView-Pro/commit/8925a02f9fa88f4742d984f2ff02909afc6ad0d7))
+-   重构 request 类，优化泛型支持 ([d7b2e6a](https://gitee.com/anyup/uView-Pro/commit/d7b2e6a224d96f717e5bdbaf09edb19b712ced47))
+
+## 0.0.4（2025-08-14）
+
+### 新增
+
+-   `u-icon` 组件新增 `space` 属性，表示`label` 在四周时与图标的距离，权重高于 `margin`，单位 rpx
+-   新增`$u`工具库各类方法，同步文档
+-   组件全部 setup 化，全面支持 TypeScript 和 Vue3
+-   工具库示例页面全部 setup 化
+
+### 优化
+
+-   组件样式兼容多端
+-   代码注释与类型完善
+-   优化演示代码兼容性
+
+### 修复
+
+-   修复类型声明、变量冲突、lint 报错等问题
+
 ## 0.0.3（2025-08-06）
-- 添加插件使用示例工程
+
+-   添加插件使用示例工程
+
 ## 0.0.2（2025-08-04）
+
 -   解决一些 npm 包依赖问题
+
 ## 0.0.1（2025-08-04）
+
 -   70+精选组件，使用 Vue3+TS 全面重构，功能丰富，多端兼容，让您快速集成，开箱即用
 -   兼容安卓，iOS，微信小程序，H5 等
 -   详尽的文档支持，现代化的演示效果
 -   按需引入，精简打包体积
+
+### 基础组件（8）
+
+-   Color 色彩
+-   Icon 图标
+-   Image 图片
+-   Button 按钮
+-   Layout 布局
+-   Cell 单元格
+-   Badge 徽标数
+-   Tag 标签
+
+---
+
+### 表单组件（15）
+
+-   Form 表单
+-   Calendar 日历
+-   Select 列选择器
+-   Keyboard 键盘
+-   Picker 选择器
+-   Rate 评分
+-   Search 搜索
+-   NumberBox 步进器
+-   Upload 上传
+-   VerificationCode 验证码倒计时
+-   Field 输入框
+-   Checkbox 复选框
+-   Radio 单选框
+-   Switch 开关选择器
+-   Slider 滑动选择器
+
+---
+
+### 数据组件（4）
+
+-   Progress 进度条
+-   Table 表格
+-   CountDown 倒计时
+-   CountTo 数字滚动
+
+---
+
+### 反馈组件（10）
+
+-   ActionSheet 操作菜单
+-   AlertTips 警告提示
+-   Toast 消息提示
+-   NoticeBar 滚动通知
+-   TopTips 顶部提示
+-   SwipeAction 滑动单元格
+-   Collapse 折叠面板
+-   Popup 弹出层
+-   Modal 模态框
+-   fullScreen 压窗屏
+
+---
+
+### 布局组件（11）
+
+-   Line 线条
+-   Card 卡片
+-   Mask 遮罩层
+-   NoNetwork 无网络提示
+-   Grid 宫格布局
+-   Swiper 轮播图
+-   TimeLine 时间轴
+-   Skeleton 骨架屏
+-   Sticky 吸顶
+-   Waterfall 瀑布流
+-   Divider 分割线
+
+---
+
+### 导航组件（11）
+
+-   Dropdown 下拉菜单
+-   Tabbar 底部导航栏
+-   BackTop 返回顶部
+-   Navbar 导航栏
+-   Tabs 标签
+-   TabsSwiper 全屏选项卡
+-   Subsection 分段器
+-   IndexList 索引列表
+-   Steps 步骤条
+-   Empty 内容为空
+-   Section 查看更多
+
+---
+
+### 其他组件（8）
+
+-   MessageInput 验证码输入
+-   Loadmore 加载更多
+-   ReadMore 展开阅读更多
+-   LazyLoad 懒加载
+-   Gap 间隔槽
+-   Avatar 头像
+-   Link 超链接
+-   Loading 加载动画
+
+---

package/components/u-action-sheet/u-action-sheet.vue

@@ -44,9 +44,9 @@ defineOptions({
 /**
  * actionSheet 操作菜单
  * @description 本组件用于从底部弹出一个操作菜单，供用户选择并返回结果。本组件功能类似于uni的uni.showActionSheetAPI，配置更加灵活，所有平台都表现一致。
- * @tutorial https://uview-pro.anyup.cn/docs/components/actionSheet.html
- * @property {Array<Object>} list 按钮的文字数组，见官方文档示例
- * @property {Object} tips 顶部的提示文字，见官方文档示例
+ * @tutorial https://uview-pro.netlify.app/components/actionSheet.html
+ * @property {Array<{ text: string; subText?: string; color?: string; fontSize?: string; disabled?: boolean }>} list 按钮的文字数组，见官方文档示例
+ * @property {{text: string; color?: string; fontSize?: string}} tips 顶部的提示文字，见官方文档示例
  * @property {String} cancel-text 取消按钮的提示文字
  * @property {Boolean} cancel-btn 是否显示底部的取消按钮（默认true）
  * @property {Number String} border-radius 弹出部分顶部左右的圆角值，单位rpx（默认0）
@@ -67,7 +67,7 @@ const props = defineProps({
     },
     /** 按钮的文字数组，可以自定义颜色和字体大小，字体单位为rpx */
     list: {
-        type: Array as () => Array<any>,
+        type: Array as () => Array<{ text: string; subText?: string; color?: string; fontSize?: string; disabled?: boolean }>,
         default: () => []
     },
     /** 顶部的提示文字 */

package/components/u-avatar/u-avatar.vue

@@ -25,7 +25,7 @@ let base64Avatar =
 /**
  * avatar 头像
  * @description 本组件一般用于展示头像的地方，如个人中心，或者评论列表页的用户头像展示等场所。
- * @tutorial https://uview-pro.anyup.cn/docs/components/avatar.html
+ * @tutorial https://uview-pro.netlify.app/components/avatar.html
  * @property {String} bg-color 背景颜色，一般显示文字时用（默认#ffffff）
  * @property {String} src 头像路径，如加载失败，将会显示默认头像
  * @property {String Number} size 头像尺寸，可以为指定字符串(large, default, mini)，或者数值，单位rpx（默认default）

package/components/u-badge/u-badge.vue

@@ -29,7 +29,7 @@ defineOptions({
 /**
  * badge 角标
  * @description 本组件一般用于展示头像的地方，如个人中心，或者评论列表页的用户头像展示等场所。
- * @tutorial https://uview-pro.anyup.cn/docs/components/badge.html
+ * @tutorial https://uview-pro.netlify.app/components/badge.html
  * @property {String|Number} count 展示的数字，大于 overflowCount 时显示为 ${overflowCount}+，为0且show-zero为false时隐藏
  * @property {Boolean} is-dot 不展示数字，只有一个小点（默认false）
  * @property {Boolean} absolute 组件是否绝对定位，为true时，offset参数才有效（默认true）

package/components/u-button/u-button.vue

@@ -15,7 +15,7 @@
         :hover-stay-time="Number(hoverStayTime)"
         :disabled="disabled"
         :form-type="formType"
-        :open-type="openType"
+        :open-type="disabled || loading ? undefined : openType"
         :app-parameter="appParameter"
         :hover-stop-propagation="hoverStopPropagation"
         :send-message-title="sendMessageTitle"
@@ -25,11 +25,15 @@
         :session-from="sessionFrom"
         :send-message-img="sendMessageImg"
         :show-message-card="showMessageCard"
-        @getphonenumber="getphonenumber"
+        @getAuthorize="getAuthorize"
         @getuserinfo="getuserinfo"
+        @contact="contact"
+        @getphonenumber="getphonenumber"
         @error="error"
-        @opensetting="opensetting"
         @launchapp="launchapp"
+        @opensetting="opensetting"
+        @chooseavatar="chooseavatar"
+        @agreeprivacyauthorization="agreeprivacyauthorization"
         :style="[
             customStyle,
             {
@@ -57,7 +61,7 @@
 </template>
 
 <script setup lang="ts">
-import { ref, computed, nextTick } from 'vue';
+import { ref, computed, nextTick, type PropType } from 'vue';
 import { $u } from '../../';
 
 defineOptions({
@@ -66,7 +70,7 @@ defineOptions({
 /**
  * button 按钮
  * @description Button 按钮
- * @tutorial https://uview-pro.anyup.cn/docs/components/button.html
+ * @tutorial https://uview-pro.netlify.app/components/button.html
  * @property {String} size 按钮的大小
  * @property {Boolean} ripple 是否开启点击水波纹效果
  * @property {String} ripple-bg-color 水波纹的背景色，ripple为true时有效
@@ -74,7 +78,7 @@ defineOptions({
  * @property {Boolean} plain 按钮是否镂空，背景色透明
  * @property {Boolean} disabled 是否禁用
  * @property {Boolean} hair-line 是否显示按钮的细边框(默认true)
- * @property {Boolean} shape 按钮外观形状，见文档说明
+ * @property {String} shape 按钮外观形状，见文档说明
  * @property {Boolean} loading 按钮名称前是否带 loading 图标(App-nvue 平台，在 ios 上为雪花，Android上为圆圈)
  * @property {String} form-type 用于 <form> 组件，点击分别会触发 <form> 组件的 submit/reset 事件
  * @property {String} open-type 开放能力
@@ -83,23 +87,60 @@ defineOptions({
  * @property {Number} hover-start-time 按住后多久出现点击态，单位毫秒
  * @property {Number} hover-stay-time 手指松开后点击态保留时间，单位毫秒
  * @property {Object} custom-style 对按钮的自定义样式，对象形式，见文档说明
+ * @property {String} app-parameter 打开 APP 时，向 APP 传递的参数，open-type=launchApp时有效
+ * @property {Boolean} hover-stop-propagation 指定是否阻止本节点的祖先节点出现点击态，微信小程序有效
+ * @property {String} lang 指定返回用户信息的语言，zh_CN 简体中文，zh_TW 繁体中文，en 英文。只微信小程序有效
+ * @property {String} session-from 会话来源，open-type="contact"时有效。只微信小程序有效
+ * @property {String} send-message-title 会话内消息卡片标题，open-type="contact"时有效
+ * @property {String} send-message-path 会话内消息卡片点击跳转小程序路径，open-type="contact"时有效
+ * @property {String} send-message-img 会话内消息卡片图片，open-type="contact"时有效
+ * @property {Boolean} show-message-card 是否显示会话内消息卡片，open-type="contact"时有效
+ * @property {Number|String} throttle-time 节流，一定时间内只能触发一次，单位毫秒
+ * @property {String} scope 支付宝小程序，当 open-type 为 getAuthorize 时有效。可选值：'phoneNumber' | 'userInfo'
  * @event {Function} click 按钮点击
  * @event {Function} getphonenumber open-type="getPhoneNumber"时有效
  * @event {Function} getuserinfo 用户点击该按钮时，会返回获取到的用户信息，从返回参数的detail中获取到的值同uni.getUserInfo
  * @event {Function} error 当使用开放能力时，发生错误的回调
  * @event {Function} opensetting 在打开授权设置页并关闭后回调
  * @event {Function} launchapp 打开 APP 成功的回调
+ * @event {Function} contact 客服消息回调
+ * @event {Function} chooseavatar 头像选择回调
+ * @event {Function} agreeprivacyauthorization 用户点击允许授权回调
  * @example <u-button>月落</u-button>
  */
 
-const emit = defineEmits<{
-    (e: 'click', event: any): void;
-    (e: 'getphonenumber', res: any): void;
-    (e: 'getuserinfo', res: any): void;
-    (e: 'error', res: any): void;
-    (e: 'opensetting', res: any): void;
-    (e: 'launchapp', res: any): void;
-}>();
+const emit = defineEmits(['click', 'getuserinfo', 'contact', 'getphonenumber', 'error', 'launchapp', 'opensetting', 'chooseavatar', 'agreeprivacyauthorization']);
+
+type ButtonScope = 'phoneNumber' | 'userInfo';
+
+type ButtonOpenType =
+    | 'feedback'
+    | 'share'
+    | 'getUserInfo'
+    | 'contact'
+    | 'getPhoneNumber'
+    | 'launchApp'
+    | 'openSetting'
+    | 'chooseAvatar'
+    | 'getAuthorize'
+    | 'lifestyle'
+    | 'contactShare'
+    | 'openGroupProfile'
+    | 'openGuildProfile'
+    | 'openPublicProfile'
+    | 'shareMessageToFriend'
+    | 'addFriend'
+    | 'addColorSign'
+    | 'addGroupApp'
+    | 'addToFavorites'
+    | 'chooseAddress'
+    | 'chooseInvoiceTitle'
+    | 'login'
+    | 'subscribe'
+    | 'favorite'
+    | 'watchLater'
+    | 'openProfile'
+    | 'agreePrivacyAuthorization';
 
 const props = defineProps({
     /** 是否细边框 */
@@ -116,8 +157,10 @@ const props = defineProps({
     disabled: { type: Boolean, default: false },
     /** 是否加载中 */
     loading: { type: Boolean, default: false },
+    /** 支付宝小程序，当 open-type 为 getAuthorize 时有效 */
+    scope: { type: String as PropType<ButtonScope>, default: '' },
     /** 开放能力，具体请看uniapp稳定关于button组件部分说明 */
-    openType: { type: String, default: '' },
+    openType: { type: String as PropType<ButtonOpenType>, default: '' },
     /** 用于 <form> 组件，点击分别会触发 <form> 组件的 submit/reset 事件 */
     formType: { type: String, default: '' },
     /** 打开 APP 时，向 APP 传递的参数，open-type=launchApp时有效 */
@@ -278,32 +321,66 @@ function getElQuery(): Promise<any[]> {
 /**
  * open-type="getPhoneNumber"时有效
  */
-function getphonenumber(res: any) {
-    emit('getphonenumber', res);
+function getphonenumber(event: any) {
+    emit('getphonenumber', event);
 }
 /**
  * 用户点击该按钮时，会返回获取到的用户信息，从返回参数的detail中获取到的值同uni.getUserInfo
  */
-function getuserinfo(res: any) {
-    emit('getuserinfo', res);
+function getuserinfo(event: any) {
+    emit('getuserinfo', event);
 }
 /**
  * 当使用开放能力时，发生错误的回调
  */
-function error(res: any) {
-    emit('error', res);
+function error(event: any) {
+    emit('error', event);
 }
 /**
  * 在打开授权设置页并关闭后回调
  */
-function opensetting(res: any) {
-    emit('opensetting', res);
+function opensetting(event: any) {
+    emit('opensetting', event);
 }
 /**
  * 打开 APP 成功的回调
  */
-function launchapp(res: any) {
-    emit('launchapp', res);
+function launchapp(event: any) {
+    emit('launchapp', event);
+}
+
+/**
+ * 支付宝小程序授权
+ * @param event
+ */
+function getAuthorize(event: any) {
+    if (props.scope === 'phoneNumber') {
+        getphonenumber(event);
+    } else if (props.scope === 'userInfo') {
+        getuserinfo(event);
+    }
+}
+
+/**
+ * 客服消息回调
+ * @param event
+ */
+function contact(event: any) {
+    emit('contact', event);
+}
+/**
+ * 头像选择回调
+ * @param event
+ */
+function chooseavatar(event: any) {
+    emit('chooseavatar', event);
+}
+/**
+ * 用户点击允许授权回调
+ * @param event
+ */
+function agreeprivacyauthorization(event: any) {
+    emit('agreeprivacyauthorization', event);
 }
 </script>
 

package/components/u-card/u-card.vue

@@ -82,7 +82,7 @@ defineOptions({
 /**
  * card 卡片
  * @description 卡片组件一般用于多个列表条目，且风格统一的场景
- * @tutorial https://uview-pro.anyup.cn/docs/components/card.html
+ * @tutorial https://uview-pro.netlify.app/components/card.html
  * @property {Boolean} full 卡片与屏幕两侧是否留空隙（默认false）
  * @property {String} title 头部左边的标题
  * @property {String} title-color 标题颜色（默认#303133）

package/components/u-cell-group/u-cell-group.vue

@@ -17,7 +17,7 @@ defineOptions({
 /**
  * cellGroup 单元格父组件Group
  * @description cell单元格一般用于一组列表的情况，比如个人中心页，设置页等。搭配u-cell-item
- * @tutorial https://uview-pro.anyup.cn/docs/components/cell.html
+ * @tutorial https://uview-pro.netlify.app/components/cell.html
  * @property {String} title 分组标题
  * @property {Boolean} border 是否显示外边框（默认true）
  * @property {Object} title-style 分组标题的的样式，对象形式，如{'font-size': '24rpx'} 或 {'fontSize': '24rpx'}

package/components/u-cell-item/u-cell-item.vue

@@ -45,7 +45,7 @@ defineOptions({
 /**
  * cellItem 单元格Item
  * @description cell单元格一般用于一组列表的情况，比如个人中心页，设置页等。搭配u-cell-group使用
- * @tutorial https://uview-pro.anyup.cn/docs/components/cell.html
+ * @tutorial https://uview-pro.netlify.app/components/cell.html
  * @property {String} title 左侧标题
  * @property {String} icon 左侧图标名，只支持uView内置图标，见Icon 图标
  * @property {Object} icon-style 左边图标的样式，对象形式

package/components/u-checkbox/u-checkbox.vue

@@ -26,7 +26,7 @@ defineOptions({
 /**
  * checkbox 复选框
  * @description 该组件需要搭配checkboxGroup组件使用，以便用户进行操作时，获得当前复选框组的选中情况。
- * @tutorial https://uview-pro.anyup.cn/docs/components/checkbox.html
+ * @tutorial https://uview-pro.netlify.app/components/checkbox.html
  * @property {String Number} icon-size 图标大小，单位rpx（默认20）
  * @property {String Number} label-size label字体大小，单位rpx（默认28）
  * @property {String Number} name checkbox组件的标示符

package/components/u-checkbox-group/u-checkbox-group.vue

@@ -15,7 +15,7 @@ defineOptions({
 /**
  * checkboxGroup 开关选择器父组件Group
  * @description 复选框组件一般用于需要多个选择的场景，该组件功能完整，使用方便
- * @tutorial https://uview-pro.anyup.cn/docs/components/checkbox.html
+ * @tutorial https://uview-pro.netlify.app/components/checkbox.html
  * @property {String Number} max 最多能选中多少个checkbox（默认999）
  * @property {String Number} size 组件整体的大小，单位rpx（默认40）
  * @property {Boolean} disabled 是否禁用所有checkbox（默认false）

package/components/u-circle-progress/u-circle-progress.vue

@@ -43,7 +43,7 @@ defineOptions({
 /**
  * circleProgress 环形进度条
  * @description 展示操作或任务的当前进度，比如上传文件，是一个圆形的进度条。注意：此组件的percent值只能动态增加，不能动态减少。
- * @tutorial https://uview-pro.anyup.cn/docs/components/circleProgress.html
+ * @tutorial https://uview-pro.netlify.app/components/circleProgress.html
  * @property {String Number} percent 圆环进度百分比值，为数值类型，0-100
  * @property {String} inactive-color 圆环的底色，默认为灰色(该值无法动态变更)（默认#ececec）
  * @property {String} active-color 圆环激活部分的颜色(该值无法动态变更)（默认#19be6b）