@10yun/cv-mobile-ui 0.5.43 → 0.5.45

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

@@ -1,12 +1,14 @@
 <template>
   <up-popup :show="show" mode="bottom" @close="closeHandler" :safeAreaInsetBottom="safeAreaInsetBottom" :round="round">
     <view class="u-action-sheet">
+      <!-- 顶部标题区域 -->
       <view class="u-action-sheet__header" v-if="title">
         <text class="u-action-sheet__header__title u-line-1">{{ title }}</text>
         <view class="u-action-sheet__header__icon-wrap" @tap.stop="cancel">
           <up-icon name="close" size="17" color="#c8c9cc" bold></up-icon>
         </view>
       </view>
+      <!-- 描述信息 -->
       <text
         class="u-action-sheet__description"
         :style="[
@@ -19,7 +21,9 @@
         {{ description }}
       </text>
       <slot>
+        <!-- 分割线 -->
         <up-line v-if="description"></up-line>
+        <!-- 操作项列表 -->
         <scroll-view scroll-y class="u-action-sheet__item-wrap" :style="{ maxHeight: wrapMaxHeight }">
           <view :key="index" v-for="(item, index) in actions">
             <!-- #ifdef MP -->
@@ -48,21 +52,26 @@
                 @tap.stop="selectHandler(index)"
                 :hover-class="!item.disabled && !item.loading ? 'u-action-sheet--hover' : ''"
                 :hover-stay-time="150"
+                :style="getItemHoverStyle(index)"
               >
                 <template v-if="!item.loading">
                   <text class="u-action-sheet__item-wrap__item__name" :style="[itemStyle(index)]">{{ item.name }}</text>
                   <text v-if="item.subname" class="u-action-sheet__item-wrap__item__subname">{{ item.subname }}</text>
                 </template>
+                <!-- 加载状态图标 -->
                 <up-loading-icon v-else custom-class="van-action-sheet__loading" size="18" mode="circle" />
               </view>
               <!-- #ifdef MP -->
             </button>
             <!-- #endif -->
+            <!-- 选项间分割线 -->
             <up-line v-if="index !== actions.length - 1"></up-line>
           </view>
         </scroll-view>
       </slot>
+      <!-- 取消按钮前的分割区域 -->
       <up-gap bgColor="#eaeaec" height="6" v-if="cancelText"></up-gap>
+      <!-- 取消按钮 -->
       <view
         class="u-action-sheet__item-wrap__item u-action-sheet__cancel"
         hover-class="u-action-sheet--hover"
@@ -84,7 +93,7 @@ import { addUnit } from '../../libs/function/index';
 /**
  * ActionSheet 操作菜单
  * @description 本组件用于从底部弹出一个操作菜单，供用户选择并返回结果。本组件功能类似于uni的uni.showActionSheetAPI，配置更加灵活，所有平台都表现一致。
- * @tutorial https://ijry.github.io/uview-plus/components/actionSheet.html
+ * @tutorial https://uview-plus.jiangruyi.com/components/actionSheet.html
  *
  * @property {Boolean}			show				操作菜单是否展示 （默认 false ）
  * @property {String}			title				操作菜单标题
@@ -136,6 +145,7 @@ export default {
   },
   emits: ['close', 'select', 'update:show'],
   methods: {
+    // 关闭操作菜单事件处理
     closeHandler() {
       // 允许点击遮罩关闭时，才发出close事件
       if (this.closeOnClickOverlay) {
@@ -148,6 +158,7 @@ export default {
       this.$emit('update:show', false);
       this.$emit('close');
     },
+    // 选择操作项处理
     selectHandler(index) {
       const item = this.actions[index];
       if (item && !item.disabled && !item.loading) {
@@ -157,6 +168,16 @@ export default {
           this.$emit('close');
         }
       }
+    },
+    // 动态处理Hover时候第一个item的圆角
+    getItemHoverStyle(index) {
+      if (index === 0 && this.round && !this.title && !this.description) {
+        return {
+          borderTopLeftRadius: `${this.round}px`,
+          borderTopRightRadius: `${this.round}px`
+        };
+      }
+      return {};
     }
   }
 };

package/uview-plus/components/u-agreement/style.css

@@ -0,0 +1,10 @@
+.agreement-content {
+  width: 100%;
+  display: inline-block;
+  flex-direction: column;
+}
+.agreement-content .agreement-url {
+  display: inline-block;
+  color: blue;
+  cursor: pointer;
+}

package/uview-plus/components/u-agreement/style.scss

@@ -0,0 +1,12 @@
+.agreement-content {
+  width: 100%;
+  display: inline-block;
+  flex-direction: column;
+  .agreement-url {
+    display: inline-block;
+    color: blue;
+    // #ifdef H5
+    cursor: pointer;
+    // #endif
+  }
+}

package/uview-plus/components/u-agreement/u-agreement.vue

@@ -0,0 +1,65 @@
+<style scoped>
+@import './style.css';
+</style>
+<template>
+  <view class="up-agreement">
+    <up-modal v-model:show="show" showCancelButton @confirm="confirm" @cancel="close" confirmText="阅读并同意">
+      <view class="agreement-content">
+        <slot>
+          我们非常重视您的个人信息和隐私保护。为了更好地保障您的个人权益，在您使用我们的产品前， 请务必审慎阅读《
+          <text class="agreement-url" @click="urlClick('urlProtocol')">用户协议</text>
+          》 和《
+          <text class="agreement-url" @click="urlClick('urlPrivacy')">隐私政策</text>
+          》内的所有条款， 尤其是:1.我们对您的个人信息的收集/保存/使用/对外提供/保护等规则条款，以及您的用户权利等条款;2.
+          约定我们的限制责任、免责
+          条款;3.其他以颜色或加粗进行标识的重要条款。如您对以上协议有任何疑问，请先不要同意，您点击“同意并继续”的行为即表示您已阅读
+          完毕并同意以上协议的全部内容。
+        </slot>
+      </view>
+    </up-modal>
+  </view>
+</template>
+<script>
+export default {
+  name: 'up-agreement',
+  props: {
+    urlProtocol: {
+      type: String,
+      default: '/pages/user_agreement/agreement/info?title=用户协议'
+    },
+    urlPrivacy: {
+      type: String,
+      default: '/pages/user_agreement/agreement/info?title=隐私政策'
+    }
+  },
+  emits: ['confirm'],
+  data() {
+    return {
+      show: false
+    };
+  },
+  methods: {
+    close() {
+      // #ifdef H5
+      window.opener = null;
+      window.close();
+      // #endif
+      // #ifdef APP-PLUS
+      plus.runtime.quit();
+      // #endif
+    },
+    confirm() {
+      this.show = false;
+      this.$emit('confirm', 1);
+    },
+    showModal() {
+      this.show = true;
+    },
+    urlClick(type) {
+      uni.navigateTo({
+        url: this[type]
+      });
+    }
+  }
+};
+</script>

package/uview-plus/components/u-album/album.js

@@ -3,9 +3,9 @@
  * @Description  :
  * @version      : 1.0
  * @Date         : 2021-08-20 16:44:21
- * @LastAuthor   : LQ
- * @lastTime     : 2021-08-20 16:47:24
- * @FilePath     : /u-view2.0/uview-ui/libs/config/props/album.js
+ * @LastAuthor   : jry
+ * @lastTime     : 2025-08-16 16:32:24
+ * @FilePath     : /uview-plus/libs/config/props/album.js
  */
 export default {
     // album 组件

package/uview-plus/components/u-album/props.js

@@ -1,5 +1,14 @@
+/*
+ * @Author       : jry
+ * @Description  :
+ * @version      : 3.0
+ * @LastAuthor   : jry
+ * @lastTime     : 2025-08-16 16:35:24
+ * @FilePath     : /uview-plus/components/u-album/props.js
+ */
 import { defineMixin } from '../../libs/vue';
 import defProps from '../../libs/config/props.js';
+
 export const props = defineMixin({
   props: {
     // 图片地址，Array<String>|Array<Object>形式

package/uview-plus/components/u-album/style.css

@@ -1,29 +1,3 @@
-/* #ifndef APP-NVUE */
-.u-empty,
-.u-empty__wrap,
-.u-tabs,
-.u-tabs__wrapper,
-.u-tabs__wrapper__scroll-view-wrapper,
-.u-tabs__wrapper__scroll-view,
-.u-tabs__wrapper__nav,
-.u-tabs__wrapper__nav__line,
-.up-empty,
-.up-empty__wrap,
-.up-tabs,
-.up-tabs__wrapper,
-.up-tabs__wrapper__scroll-view-wrapper,
-.up-tabs__wrapper__scroll-view,
-.up-tabs__wrapper__nav,
-.up-tabs__wrapper__nav__line {
-  display: flex;
-  flex-direction: column;
-  flex-shrink: 0;
-  flex-grow: 0;
-  flex-basis: auto;
-  align-items: stretch;
-  align-content: flex-start;
-}
-/* #endif */
 .u-album {
   /* #ifndef APP-NVUE */
   display: flex;

package/uview-plus/components/u-album/style.scss

@@ -1,5 +1,3 @@
-@import '../../libs/css/components.scss';
-
 .u-album {
   @include flex(column);
 

package/uview-plus/components/u-album/u-album.vue

@@ -1,5 +1,6 @@
 <template>
   <view class="u-album">
+    <!-- 相册行容器，每行显示 rowCount 个图片 -->
     <view
       class="u-album__row"
       ref="u-album__row"
@@ -8,13 +9,15 @@
       :key="index"
       :style="{ flexWrap: autoWrap ? 'wrap' : 'nowrap' }"
     >
+      <!-- 图片包装容器 -->
       <view
         class="u-album__row__wrapper"
         v-for="(item, index1) in arr"
         :key="index1"
         :style="[imageStyle(index + 1, index1 + 1)]"
-        @tap="previewFullImage ? onPreviewTap($event, getSrc(item)) : ''"
+        @tap="onPreviewTap($event, getSrc(item))"
       >
+        <!-- 图片显示 -->
         <image
           :src="getSrc(item)"
           :mode="urls.length === 1 ? (imageHeight > 0 ? singleMode : 'widthFix') : multipleMode"
@@ -26,6 +29,7 @@
             }
           ]"
         ></image>
+        <!-- 超出最大显示数量时的更多提示 -->
         <view
           v-if="
             showMore &&
@@ -57,13 +61,13 @@ import { mixin } from '../../libs/mixin/mixin';
 import { addUnit, sleep } from '../../libs/function/index';
 import test from '../../libs/function/test';
 // #ifdef APP-NVUE
-// 由于weex为阿里的KPI业绩考核的产物，所以不支持百分比单位，这里需要通过dom查询组件的宽度
+// 不支持百分比单位，这里需要通过dom查询组件的宽度
 const dom = uni.requireNativePlugin('dom');
 // #endif
 /**
  * Album 相册
  * @description 本组件提供一个类似相册的功能，让开发者开发起来更加得心应手。减少重复的模板代码
- * @tutorial https://ijry.github.io/uview-plus/components/album.html
+ * @tutorial https://uview-plus.jiangruyi.com/components/album.html
  *
  * @property {Array}           urls             图片地址列表 Array<String>|Array<Object>形式
  * @property {String}          keyName          指定从数组的对象元素中读取哪个属性作为图片地址
@@ -100,14 +104,20 @@ export default {
     urls: {
       immediate: true,
       handler(newVal) {
+        // 当只有一张图片时，获取图片尺寸信息
         if (newVal.length === 1) {
           this.getImageRect();
         }
       }
     }
   },
-  emits: ['albumWidth'],
   computed: {
+    /**
+     * 计算图片样式
+     * @param {Number} index1 - 行索引
+     * @param {Number} index2 - 列索引
+     * @returns {Object} 图片样式对象
+     */
     imageStyle() {
       return (index1, index2) => {
         const { space, rowCount, multipleSize, urls } = this,
@@ -126,11 +136,16 @@ export default {
         return style;
       };
     },
-    // 将数组划分为二维数组
+    /**
+     * 将图片地址数组划分为二维数组，用于按行显示
+     * @returns {Array} 二维数组，每个子数组代表一行图片
+     */
     showUrls() {
       if (this.autoWrap) {
+        // 自动换行模式下，所有图片放在一行中显示
         return [this.urls.slice(0, this.maxCount)];
       } else {
+        // 固定行数模式下，按 rowCount 分割图片
         const arr = [];
         this.urls.map((item, index) => {
           // 限制最大展示数量
@@ -147,14 +162,25 @@ export default {
         return arr;
       }
     },
+    /**
+     * 计算图片宽度
+     * @returns {String} 图片宽度样式值
+     */
     imageWidth() {
       return addUnit(this.urls.length === 1 ? this.singleWidth : this.multipleSize, this.unit);
     },
+    /**
+     * 计算图片高度
+     * @returns {String} 图片高度样式值
+     */
     imageHeight() {
       return addUnit(this.urls.length === 1 ? this.singleHeight : this.multipleSize, this.unit);
     },
-    // 此变量无实际用途，仅仅是为了利用computed特性，让其在urls长度等变化时，重新计算图片的宽度
-    // 因为用户在某些特殊的情况下，需要让文字与相册的宽度相等，所以这里事件的形式对外发送
+    /**
+     * 计算相册总宽度，用于外部组件对齐
+     * 此变量无实际用途，仅仅是为了利用computed特性，让其在urls长度等变化时，重新计算图片的宽度
+     * @returns {Number} 相册宽度
+     */
     albumWidth() {
       let width = 0;
       if (this.urls.length === 1) {
@@ -166,52 +192,91 @@ export default {
       return width;
     }
   },
+  emits: ['preview', 'albumWidth'],
   methods: {
     addUnit,
-    // 预览图片
+    /**
+     * 点击图片预览
+     * @param {Event} e - 点击事件对象
+     * @param {String} url - 当前点击图片的地址
+     */
     onPreviewTap(e, url) {
+      // 获取所有图片地址
       const urls = this.urls.map((item) => {
         return this.getSrc(item);
       });
-      uni.previewImage({
-        current: url,
-        urls
-      });
-      // 是否阻止事件传播
-      this.stop && this.preventEvent(e);
+      if (this.previewFullImage) {
+        // 使用系统默认预览图片功能
+        uni.previewImage({
+          current: url,
+          urls
+        });
+        // 是否阻止事件传播
+        this.stop && this.preventEvent(e);
+      } else {
+        // 发送自定义预览事件
+        this.$emit('preview', {
+          urls,
+          currentIndex: urls.indexOf(url)
+        });
+      }
     },
-    // 获取图片的路径
+    /**
+     * 获取图片地址
+     * @param {String|Object} item - 图片项，可以是字符串或对象
+     * @returns {String} 图片地址
+     */
     getSrc(item) {
       return test.object(item) ? (this.keyName && item[this.keyName]) || item.src : item;
     },
-    // 单图时，获取图片的尺寸
-    // 在小程序中，需要将网络图片的的域名添加到小程序的download域名才可能获取尺寸
-    // 在没有添加的情况下，让单图宽度默认为盒子的一定宽度(singlePercent)
+    /**
+     * 单图时，获取图片的尺寸
+     * 在小程序中，需要将网络图片的的域名添加到小程序的download域名才可能获取尺寸
+     * 在没有添加的情况下，让单图宽度默认为盒子的一定宽度(singlePercent)
+     */
     getImageRect() {
       const src = this.getSrc(this.urls[0]);
       uni.getImageInfo({
         src,
         success: (res) => {
+          let singleSize = this.singleSize;
+          // 单位
+          let unit = '';
+          if (Number.isNaN(Number(this.singleSize))) {
+            // 大小中有字符 则记录字符
+            unit = this.singleSize.replace(/\d+/g, ''); // 单位
+            singleSize = Number(this.singleSize.replace(/\D+/g, ''), 10); // 具体值
+          }
           // 判断图片横向还是竖向展示方式
           const isHorizotal = res.width >= res.height;
-          this.singleWidth = isHorizotal ? this.singleSize : (res.width / res.height) * this.singleSize;
-          this.singleHeight = !isHorizotal ? this.singleSize : (res.height / res.width) * this.singleWidth;
+          this.singleWidth = isHorizotal ? singleSize : (res.width / res.height) * singleSize;
+          this.singleHeight = !isHorizotal ? singleSize : (res.height / res.width) * this.singleWidth;
+          // 如果有单位统一设置单位
+          if (unit != null && unit !== '') {
+            this.singleWidth = this.singleWidth + unit;
+            this.singleHeight = this.singleHeight + unit;
+          }
         },
         fail: () => {
+          // 获取图片信息失败时，通过组件宽度计算
           this.getComponentWidth();
         }
       });
     },
-    // 获取组件的宽度
+    /**
+     * 获取组件的宽度，用于计算单图显示尺寸
+     */
     async getComponentWidth() {
       // 延时一定时间，以获取dom尺寸
       await sleep(30);
       // #ifndef APP-NVUE
+      // H5、小程序等平台通过 $uGetRect 获取组件宽度
       this.$uGetRect('.u-album__row').then((size) => {
         this.singleWidth = size.width * this.singlePercent;
       });
       // #endif
       // #ifdef APP-NVUE
+      // NVUE 平台通过 dom 插件获取组件宽度
       // 这里ref="u-album__row"所在的标签为通过for循环出来，导致this.$refs['u-album__row']是一个数组
       const ref = this.$refs['u-album__row'][0];
       ref &&

package/uview-plus/components/u-alert/alert.js

@@ -1,11 +1,11 @@
 /*
  * @Author       : LQ
  * @Description  :
- * @version      : 1.0
+ * @version      : 3.0
  * @Date         : 2021-08-20 16:44:21
- * @LastAuthor   : LQ
- * @lastTime     : 2021-08-20 16:48:53
- * @FilePath     : /u-view2.0/uview-ui/libs/config/props/alert.js
+ * @LastAuthor   : jry
+ * @lastTime     : 2025-08-17 17:23:53
+ * @FilePath     : /uview-plus/libs/config/props/alert.js
  */
 export default {
     // alert警告组件
@@ -17,6 +17,10 @@ export default {
         showIcon: false,
         effect: 'light',
         center: false,
-        fontSize: 14
+        fontSize: 14,
+        transitionMode: 'fade',
+        duration: 0,
+        icon: '',
+        value: true
     }
 }

package/uview-plus/components/u-alert/props.js

@@ -1,5 +1,14 @@
+/*
+ * @Author       : jry
+ * @Description  :
+ * @version      : 3.0
+ * @LastAuthor   : jry
+ * @lastTime     : 2025-08-17 17:23:53
+ * @FilePath     : /uview-plus/libs/config/props/props.js
+ */
 import { defineMixin } from '../../libs/vue';
 import defProps from '../../libs/config/props.js';
+
 export const props = defineMixin({
   props: {
     // 显示文字
@@ -41,6 +50,26 @@ export const props = defineMixin({
     fontSize: {
       type: [String, Number],
       default: () => defProps.alert.fontSize
+    },
+    // 动画类型
+    transitionMode: {
+      type: [String],
+      default: () => defProps.alert.transitionMode
+    },
+    // 自动定时关闭毫秒
+    duration: {
+      type: [Number],
+      default: () => defProps.alert.duration
+    },
+    // 自定义图标
+    icon: {
+      type: [String],
+      default: () => defProps.alert.icon
+    },
+    // 是否显示
+    modelValue: {
+      type: [Boolean],
+      default: () => defProps.alert.value
     }
   }
 });

package/uview-plus/components/u-alert/style.css

@@ -1,29 +1,3 @@
-/* #ifndef APP-NVUE */
-.u-empty,
-.u-empty__wrap,
-.u-tabs,
-.u-tabs__wrapper,
-.u-tabs__wrapper__scroll-view-wrapper,
-.u-tabs__wrapper__scroll-view,
-.u-tabs__wrapper__nav,
-.u-tabs__wrapper__nav__line,
-.up-empty,
-.up-empty__wrap,
-.up-tabs,
-.up-tabs__wrapper,
-.up-tabs__wrapper__scroll-view-wrapper,
-.up-tabs__wrapper__scroll-view,
-.up-tabs__wrapper__nav,
-.up-tabs__wrapper__nav__line {
-  display: flex;
-  flex-direction: column;
-  flex-shrink: 0;
-  flex-grow: 0;
-  flex-basis: auto;
-  align-items: stretch;
-  align-content: flex-start;
-}
-/* #endif */
 .u-alert {
   position: relative;
   background-color: var(--u-primary);

package/uview-plus/components/u-alert/style.scss

@@ -1,5 +1,3 @@
-@import '../../libs/css/components.scss';
-
 .u-alert {
   position: relative;
   background-color: $u-primary;