uview-pro 0.5.3 → 0.5.5

package/changelog.md

@@ -1,22 +1,59 @@
-## 0.5.3（2026-01-26）
+## 0.5.5（2026-02-02）
 
-### ♻️ Code Refactoring | 代码重构
-
-- **demo-page:** 移除标签栏外层sticky组件 ([ed49275](https://github.com/anyup/uView-Pro/commit/ed49275bc2962426dc4f9185b4b35f6a994cf383))
+### ✨ Features | 新功能
 
-### 👷 Continuous Integration | CI 配置
+- **u-toast:** 新增页面级toast功能并优化loading逻辑 ([4eae5b7](https://github.com/anyup/uView-Pro/commit/4eae5b7ef5d4494c4619bee383e62490994b4317))
+- **useModal:** 新增useModal函数式调用API和全局modal功能（#101） ([724edf3](https://github.com/anyup/uView-Pro/commit/724edf3cd69607a6d4e33954f8d2d701f9502ff3))
+- **locale:** 新增语言配置的标签字段label和区域设置字段locale ([49ba6cb](https://github.com/anyup/uView-Pro/commit/49ba6cbea6b53712496e465dd40654af7608a02d))
 
-- 添加 npm 包测试脚本 ([78c5524](https://github.com/anyup/uView-Pro/commit/78c5524abbbc368949ec58437361c995f5146234))
-
-### 🐛 Bug Fixes | Bug 修复
+### ♻️ Code Refactoring | 代码重构
 
-- **locale:** 修复本地运行时locale国际化字段未加载成功的问题 ([10c017a](https://github.com/anyup/uView-Pro/commit/10c017a401232224ca1642274d65f031f74f12f0))
-- **u-picker:** 修复u-picker/u-select选择器在亮色/暗黑模式下背景色显示问题 ([072a6cc](https://github.com/anyup/uView-Pro/commit/072a6cc1095b5f17b0c15c3cd2a3d6a75d8a9f08))
+- **demo:** 调整demo演示中吸顶组件默认偏移量为200 ([165da80](https://github.com/anyup/uView-Pro/commit/165da80eb9eec54cf1a5fa8511d82e2b3d11fed1))
 
 ### 👥 Contributors
 
 <a href="https://github.com/anyup"><img src="https://github.com/anyup.png?size=40" width="40" height="40" alt="anyup" title="anyup"/></a> 
 
+## 0.5.4（2026-01-30）
+
+### 🐛 Bug Fixes | Bug 修复
+
+- **types:** 优化组件库类型定义和代码健壮性 ([e83eac8](https://github.com/anyup/uView-Pro/commit/e83eac8192476dea5e2d4e5b8b3c68b7da992673))
+- **u-navbar:** 修复状态栏高度获取的条件判断，区分鸿蒙、微信小程序和其他 ([b13d112](https://github.com/anyup/uView-Pro/commit/b13d112be80c46f62bfa343a089f2de70a00f774))
+
+### ✨ Features | 新功能
+
+- **u-loading:** 增强u-loading的自定义样式功能 ([c9151ce](https://github.com/anyup/uView-Pro/commit/c9151ce4bee44c762bd7970ab280184c730e97b1))
+- **u-toast:** 新增函数式调用API和全局toast功能（#101） ([b8c8fbf](https://github.com/anyup/uView-Pro/commit/b8c8fbff70c14fe0a6106794a638e450cecbeddf))
+- **components:** 优化组件类型安全 ([02b638f](https://github.com/anyup/uView-Pro/commit/02b638f6e251c9b52e5e3ebb1e40d644d895308a))
+
+### ♻️ Code Refactoring | 代码重构
+
+- **demo:** 移除多余的toast引用 ([67b2677](https://github.com/anyup/uView-Pro/commit/67b26772eb67e9e2b830c95359688b0116395452))
+
+### 👥 Contributors
+
+<a href="https://github.com/anyup"><img src="https://github.com/anyup.png?size=40" width="40" height="40" alt="anyup" title="anyup"/></a> 
+
+## 0.5.3（2026-01-26）
+
+### ♻️ Code Refactoring | 代码重构
+
+- **demo-page:** 移除标签栏外层sticky组件 ([ed49275](https://github.com/anyup/uView-Pro/commit/ed49275bc2962426dc4f9185b4b35f6a994cf383))
+
+### 👷 Continuous Integration | CI 配置
+
+- 添加 npm 包测试脚本 ([78c5524](https://github.com/anyup/uView-Pro/commit/78c5524abbbc368949ec58437361c995f5146234))
+
+### 🐛 Bug Fixes | Bug 修复
+
+- **locale:** 修复本地运行时locale国际化字段未加载成功的问题 ([10c017a](https://github.com/anyup/uView-Pro/commit/10c017a401232224ca1642274d65f031f74f12f0))
+- **u-picker:** 修复u-picker/u-select选择器在亮色/暗黑模式下背景色显示问题 ([072a6cc](https://github.com/anyup/uView-Pro/commit/072a6cc1095b5f17b0c15c3cd2a3d6a75d8a9f08))
+
+### 👥 Contributors
+
+<a href="https://github.com/anyup"><img src="https://github.com/anyup.png?size=40" width="40" height="40" alt="anyup" title="anyup"/></a> 
+
 ## 0.5.2（2026-01-23）
 
 ### ✨ Features | 新功能

package/components/u-action-sheet/types.ts

@@ -1,4 +1,4 @@
-import { type ExtractPropTypes, type PropType } from 'vue';
+import type { ExtractPropTypes, PropType } from 'vue';
 import type { ActionSheetItem, ActionSheetTips } from '../../types/global';
 import { baseProps } from '../common/props';
 import { getColor, useLocale } from '../../';

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

@@ -95,18 +95,18 @@ const popupValue = computed({
 // 顶部提示的样式
 const tipsStyle = computed(() => {
     let style: Record<string, string> = {};
-    style.color = props.tips?.color || $u.color.tipsColor;
-    style.fontSize = $u.addUnit(props.tips?.fontSize || '26rpx');
+    style.color = String(props.tips?.color || $u.color.tipsColor);
+    style.fontSize = $u.addUnit(String(props.tips?.fontSize || '26rpx'));
     return style;
 });
 
 // 操作项目的样式
 const itemStyle = (index: number) => {
     let style: Record<string, string> = {};
-    style.color = props.list[index]?.color || props.color;
-    style.fontSize = $u.addUnit(props.list[index]?.fontSize || props.fontSize);
+    style.color = String(props.list[index]?.color || props.color);
+    style.fontSize = $u.addUnit(String(props.list[index]?.fontSize || props.fontSize));
     // 选项被禁用的样式
-    if (props.list[index]?.disabled) style.color = $u.color.lightColor;
+    if (props.list[index]?.disabled) style.color = String($u.color.lightColor || '');
     return style;
 };
 

package/components/u-action-sheet-item/types.ts

@@ -1,4 +1,4 @@
-import { type ExtractPropTypes, type PropType } from 'vue';
+import type { ExtractPropTypes, PropType } from 'vue';
 import { baseProps } from '../common/props';
 import { getColor } from '../../';
 

package/components/u-alert-tips/types.ts

@@ -1,4 +1,4 @@
-import { type ExtractPropTypes, type PropType } from 'vue';
+import type { ExtractPropTypes, PropType } from 'vue';
 import type { ThemeType } from '../../types/global';
 import { baseProps } from '../common/props';
 

package/components/u-alert-tips/u-alert-tips.vue

@@ -118,7 +118,7 @@ const uTitleStyle = computed(() => {
  */
 const uIconName = computed(() => {
     // 如果有设置icon名称就使用，否则根据type主题，推定一个默认的图标
-    return props.icon ? props.icon : $u.type2icon(props.type);
+    return props.icon ? props.icon : $u.type2icon(props.type as any);
 });
 
 /**

package/components/u-avatar/types.ts

@@ -1,4 +1,4 @@
-import { type ExtractPropTypes, type PropType } from 'vue';
+import type { ExtractPropTypes, PropType } from 'vue';
 import type { ImgMode } from '../../types/global';
 import { baseProps } from '../common/props';
 

package/components/u-avatar-cropper/types.ts

@@ -1,4 +1,4 @@
-import { type ExtractPropTypes, type PropType } from 'vue';
+import type { ExtractPropTypes, PropType } from 'vue';
 import type { AvatarCropperBoundStyle } from '../../types/global';
 
 export const AvatarCropperProps = {

package/components/u-back-top/types.ts

@@ -1,4 +1,4 @@
-import { type ExtractPropTypes, type PropType } from 'vue';
+import type { ExtractPropTypes, PropType } from 'vue';
 import type { Shape } from '../../types/global';
 import { baseProps } from '../common/props';
 

package/components/u-badge/types.ts

@@ -1,4 +1,4 @@
-import { type ExtractPropTypes, type PropType } from 'vue';
+import type { ExtractPropTypes, PropType } from 'vue';
 import type { BadgeSize, ThemeType } from '../../types/global';
 import { baseProps } from '../common/props';
 

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

@@ -1,4 +1,5 @@
 <template>
+    <!-- prettier-ignore -->
     <button
         id="u-wave-btn"
         class="u-btn u-line-1 u-fix-ios-appearance"
@@ -15,13 +16,13 @@
         :hover-start-time="Number(hoverStartTime)"
         :hover-stay-time="Number(hoverStayTime)"
         :disabled="disabled"
-        :form-type="formType"
+        :form-type="(formType as any)"
         :open-type="disabled || loading ? undefined : openType"
         :app-parameter="appParameter"
         :hover-stop-propagation="hoverStopPropagation"
         :send-message-title="sendMessageTitle"
-        send-message-path="sendMessagePath"
-        :lang="lang"
+        :send-message-path="sendMessagePath"
+        :lang="(lang as any)"
         :data-name="dataName"
         :session-from="sessionFrom"
         :send-message-img="sendMessageImg"

package/components/u-calendar/types.ts

@@ -1,4 +1,4 @@
-import { type ExtractPropTypes, type PropType } from 'vue';
+import type { ExtractPropTypes, PropType } from 'vue';
 import type { CalendarChangeDate, CalendarChangeRange, CalendarMode, ThemeType } from '../../types/global';
 import { baseProps } from '../common/props';
 import { getColor, useLocale } from '../../';

package/components/u-calendar/u-calendar.vue

@@ -518,7 +518,7 @@ function changeData() {
 /**
  * 获取农历
  */
-function getLunar(year, month, day) {
+function getLunar(year: any, month: any, day: any) {
     const val = Calendar.solar2lunar(year, month, day);
     return {
         dayCn: val.IDayCn,

package/components/u-car-keyboard/types.ts

@@ -1,4 +1,4 @@
-import { type ExtractPropTypes } from 'vue';
+import type { ExtractPropTypes } from 'vue';
 import { baseProps } from '../common/props';
 
 /**

package/components/u-card/types.ts

@@ -1,4 +1,4 @@
-import { type ExtractPropTypes, type PropType } from 'vue';
+import type { ExtractPropTypes, PropType } from 'vue';
 import { baseProps } from '../common/props';
 
 /**

package/components/u-cell-group/types.ts

@@ -1,4 +1,4 @@
-import { type ExtractPropTypes, type PropType } from 'vue';
+import type { ExtractPropTypes, PropType } from 'vue';
 import { baseProps } from '../common/props';
 
 /**

package/components/u-cell-item/types.ts

@@ -1,4 +1,4 @@
-import { type ExtractPropTypes, type PropType } from 'vue';
+import type { ExtractPropTypes, PropType } from 'vue';
 import type { CellItemArrowDirection } from '../../types/global';
 import { baseProps } from '../common/props';
 

package/components/u-checkbox/types.ts

@@ -1,4 +1,4 @@
-import { type ExtractPropTypes, type PropType } from 'vue';
+import type { ExtractPropTypes, PropType } from 'vue';
 import type { Shape } from '../../types/global';
 import { baseProps } from '../common/props';
 

package/components/u-checkbox-group/types.ts

@@ -1,4 +1,4 @@
-import { type ExtractPropTypes, type PropType } from 'vue';
+import type { ExtractPropTypes, PropType } from 'vue';
 import type { Shape } from '../../types/global';
 import { baseProps } from '../common/props';
 import { getColor } from '../../';

package/components/u-circle-progress/types.ts

@@ -1,4 +1,4 @@
-import { type ExtractPropTypes, type PropType } from 'vue';
+import type { ExtractPropTypes, PropType } from 'vue';
 import type { ThemeType } from '../../types/global';
 import { baseProps } from '../common/props';
 import { $u } from '../../libs';

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

@@ -165,7 +165,7 @@ onMounted(() => {
 /**
  * 获取canvas上下文
  */
-function getContext(canvasId) {
+function getContext(canvasId: any) {
     return new Promise<UniApp.CanvasContext>(resolve => {
         let ctx = null;
         // #ifndef MP-WEIXIN || MP-TOUTIAO

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

@@ -8,7 +8,7 @@
         @tap.stop.prevent
     >
         <block v-if="!slots.default && !slots.$default">
-            <scroll-view scroll-y="true" :style="{ height: $u.addUnit(height) }">
+            <scroll-view :scroll-y="true" :style="{ height: $u.addUnit(String(height)) }">
                 <view class="u-dropdown-item__options">
                     <u-cell-group>
                         <u-cell-item

package/components/u-empty/u-empty.vue

@@ -8,7 +8,7 @@
         <u-icon
             :name="src ? src : 'empty-' + mode"
             :custom-style="iconStyle"
-            :label="text ? text : icons[mode]"
+            :label="text ? text : (icons as any)[mode]"
             label-pos="bottom"
             :label-color="color"
             :label-size="fontSize"

package/components/u-fab/u-fab.vue

@@ -41,7 +41,7 @@ export default {
 </script>
 
 <script setup lang="ts">
-import { directionConfig, FabProps } from './types.ts';
+import { directionConfig, FabProps } from './types';
 import { computed, getCurrentInstance, onMounted, reactive, ref, useSlots, watch } from 'vue';
 import { $u } from '../../';
 

package/components/u-field/types.ts

@@ -9,17 +9,17 @@ import { baseProps } from '../common/props';
 export const FieldProps = {
     ...baseProps,
     /** label左边的图标，限uView的图标名称 */
-    icon: String,
+    icon: { type: String, default: '' },
     /** 输入框右边的图标名称，限uView的图标名称（默认false） */
-    rightIcon: String,
+    rightIcon: { type: String, default: '' },
     /** 方向属性 */
     arrowDirection: { type: String, default: 'right' },
     /** 是否必填，左边显示红色"*"号（默认false） */
-    required: Boolean,
+    required: { type: Boolean, default: false },
     /** 输入框左边的文字提示 */
-    label: String,
+    label: { type: String, default: '' },
     /** 是否密码输入方式(用点替换文字)，type为text时有效（默认false） */
-    password: Boolean,
+    password: { type: Boolean, default: false },
     /** 是否显示右侧清空内容的图标控件（默认true） */
     clearable: { type: Boolean, default: true },
     /** label的宽度，单位rpx（默认130） */
@@ -35,13 +35,13 @@ export const FieldProps = {
     /** 显示的错误提示内容，如果为空字符串或者false，则不显示错误信息 */
     errorMessage: { type: [String, Boolean] as PropType<string | boolean>, default: '' },
     /** 输入框的提示文字 */
-    placeholder: String,
+    placeholder: { type: String, default: '' },
     /** placeholder的样式(内联样式，字符串)，如"color: var(--u-divider-color)" */
-    placeholderStyle: String,
+    placeholderStyle: { type: String, default: '' },
     /** 是否自动获得焦点（默认false） */
-    focus: Boolean,
+    focus: { type: Boolean, default: false },
     /** 如果type为textarea，且在一个"position:fixed"的区域，需要指明为true（默认false） */
-    fixed: Boolean,
+    fixed: { type: Boolean, default: false },
     /** 输入框绑定值 */
     modelValue: [Number, String],
     /** 输入框类型（text/textarea/password等，默认text） */

package/components/u-field/u-field.vue

@@ -35,9 +35,9 @@
                     <textarea
                         v-if="props.type === 'textarea'"
                         class="u-flex-1 u-textarea-class"
-                        :style="[props.fieldStyle]"
-                        :value="props.modelValue"
-                        :placeholder="props.placeholder"
+                        :style="$u.toStyle(props.fieldStyle)"
+                        :value="String(props.modelValue)"
+                        :placeholder="String(props.placeholder)"
                         :placeholderStyle="props.placeholderStyle"
                         :disabled="props.disabled"
                         :maxlength="inputMaxlength"
@@ -50,14 +50,15 @@
                         @confirm="onConfirm"
                         @tap="fieldClick"
                     />
+                    <!-- prettier-ignore -->
                     <input
                         v-else
-                        :style="[props.fieldStyle]"
-                        :type="props.type"
                         class="u-flex-1 u-field__input-wrap"
-                        :value="props.modelValue"
+                        :style="$u.toStyle(props.fieldStyle)"
+                        :type="(props.type as any)"
+                        :value="String(props.modelValue)"
                         :password="props.password || props.type === 'password'"
-                        :placeholder="props.placeholder"
+                        :placeholder="String(props.placeholder)"
                         :placeholderStyle="props.placeholderStyle"
                         :disabled="props.disabled"
                         :maxlength="inputMaxlength"

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

@@ -350,7 +350,7 @@ onMounted(() => {
             // 继承父表单配置
             // 历遍parentData中的属性，将parent中的同名属性赋值给parentData
             Object.keys(parentData.value).forEach(key => {
-                parentData.value[key] = parentExposed?.value?.props[key];
+                (parentData.value as any)[key] = parentExposed?.value?.props[key];
             });
             // 如果没有传入prop，或者uForm为空(如果u-form-input单独使用，就不会有uForm注入)，就不进行校验
             if (props.prop) {

package/components/u-image/types.ts

@@ -1,4 +1,4 @@
-import { type ComponentPublicInstance, type ExtractPropTypes, type PropType } from 'vue';
+import type { ComponentPublicInstance, ExtractPropTypes, PropType } from 'vue';
 import type { ImgMode, Shape } from '../../types/global';
 import { baseProps } from '../common/props';
 

package/components/u-index-anchor/u-index-anchor.vue

@@ -62,23 +62,23 @@ onMounted(() => {
     }
 });
 
-function setTop(val) {
+function setTop(val: any) {
     top.value = val;
 }
 
-function setHeight(val) {
+function setHeight(val: any) {
     height.value = val;
 }
 
-function setActive(val) {
+function setActive(val: any) {
     active.value = val;
 }
 
-function setAnchorStyle(val) {
+function setAnchorStyle(val: any) {
     anchorStyle.value = val;
 }
 
-function setWrapperStyle(val) {
+function setWrapperStyle(val: any) {
     wrapperStyle.value = val;
 }
 

package/components/u-input/u-input.vue

@@ -19,7 +19,7 @@
             v-if="type == 'textarea'"
             class="u-input__input u-input__textarea"
             :style="getStyle"
-            :value="defaultValue"
+            :value="String(defaultValue)"
             :placeholder="placeholder"
             :placeholderStyle="placeholderStyle"
             :disabled="disabled"
@@ -27,8 +27,8 @@
             :fixed="fixed"
             :focus="focus"
             :autoHeight="autoHeight"
-            :selection-end="uSelectionEnd"
-            :selection-start="uSelectionStart"
+            :selection-end="Number(uSelectionEnd)"
+            :selection-start="Number(uSelectionStart)"
             :cursor-spacing="getCursorSpacing"
             :show-confirm-bar="showConfirmbar"
             :adjust-position="adjustPosition"
@@ -37,12 +37,13 @@
             @focus="onFocus"
             @confirm="onConfirm"
         />
+        <!-- prettier-ignore -->
         <input
             v-else
             class="u-input__input"
-            :type="type == 'password' ? 'text' : type"
+            :type="((type == 'password' ? 'text' : type) as any)"
             :style="getStyle"
-            :value="defaultValue"
+            :value="String(defaultValue)"
             :password="type == 'password' && !showPassword"
             :placeholder="placeholder"
             :placeholderStyle="placeholderStyle"
@@ -51,8 +52,8 @@
             :focus="focus"
             :confirmType="confirmType"
             :cursor-spacing="getCursorSpacing"
-            :selection-end="uSelectionEnd"
-            :selection-start="uSelectionStart"
+            :selection-end="Number(uSelectionEnd)"
+            :selection-start="Number(uSelectionStart)"
             :show-confirm-bar="showConfirmbar"
             :adjust-position="adjustPosition"
             @focus="onFocus"

package/components/u-loading/types.ts

@@ -1,4 +1,5 @@
 import type { ExtractPropTypes, PropType } from 'vue';
+import { baseProps } from '../common/props';
 
 type LoadingMode = 'circle' | 'flower';
 
@@ -7,6 +8,7 @@ type LoadingMode = 'circle' | 'flower';
  * @description 加载动画，支持多种模式
  */
 export const LoadingProps = {
+    ...baseProps,
     /** 动画的类型 */
     mode: {
         type: String as PropType<LoadingMode>,

package/components/u-loading/u-loading.vue

@@ -2,8 +2,8 @@
     <view
         v-if="show"
         class="u-loading"
-        :class="mode === 'circle' ? 'u-loading-circle' : 'u-loading-flower'"
-        :style="[cricleStyle]"
+        :class="[mode === 'circle' ? 'u-loading-circle' : 'u-loading-flower', customClass]"
+        :style="$u.toStyle(cricleStyle, customStyle)"
     >
     </view>
 </template>
@@ -24,6 +24,7 @@ export default {
 <script setup lang="ts">
 import { computed } from 'vue';
 import { LoadingProps } from './types';
+import { $u } from '../../';
 
 /**
  * loading 加载动画

package/components/u-loadmore/types.ts

@@ -1,5 +1,6 @@
 import type { ExtractPropTypes, PropType } from 'vue';
 import type { LoadmoreIconType, LoadmoreStatus, LoadmoreText } from '../../types/global';
+import { baseProps } from '../common/props';
 import { useLocale } from '../../';
 
 const { t } = useLocale();
@@ -10,6 +11,7 @@ const { t } = useLocale();
  */
 
 export const LoadmoreProps = {
+    ...baseProps,
     /** 组件背景色 */
     bgColor: {
         type: String,

package/components/u-loadmore/u-loadmore.vue

@@ -1,12 +1,15 @@
 <template>
     <view
         class="u-load-more-wrap"
-        :style="{
-            backgroundColor: props.bgColor,
-            marginBottom: props.marginBottom + 'rpx',
-            marginTop: props.marginTop + 'rpx',
-            height: $u.addUnit(props.height)
-        }"
+        :class="props.customClass"
+        :style="
+            $u.toStyle(props.customStyle, {
+                backgroundColor: props.bgColor,
+                marginBottom: props.marginBottom + 'rpx',
+                marginTop: props.marginTop + 'rpx',
+                height: $u.addUnit(props.height)
+            })
+        "
     >
         <u-line color="var(--u-divider-color)" length="50"></u-line>
         <!-- 加载中和没有更多的状态才显示两边的横线 -->
@@ -22,7 +25,7 @@
             <!-- 如果没有更多的状态下，显示内容为dot（粗点），加载特定样式 -->
             <view
                 class="u-line-1"
-                :style="loadTextStyle"
+                :style="$u.toStyle(loadTextStyle)"
                 :class="[props.status == 'nomore' && props.isDot == true ? 'u-dot-text' : 'u-more-text']"
                 @tap="loadMore"
             >
@@ -79,7 +82,7 @@ const loadTextStyle = computed(() => {
     return {
         color: props.color,
         fontSize: props.fontSize + 'rpx',
-        position: 'relative',
+        position: 'relative' as const,
         zIndex: 1,
         backgroundColor: props.bgColor
         // 如果是加载中状态，动画和文字需要距离近一点

package/components/u-message-input/u-message-input.vue

@@ -1,12 +1,13 @@
 <template>
     <view class="u-char-box" :class="customClass" :style="$u.toStyle(customStyle)">
         <view class="u-char-flex">
+            <!-- prettier-ignore -->
             <input
                 :disabled="props.disabledKeyboard"
                 :value="valueModel"
-                :type="type"
+                :type="(type as any)"
                 :focus="props.focus"
-                :maxlength="props.maxlength"
+                :maxlength="Number(props.maxlength)"
                 class="u-input"
                 @input="getVal"
             />
@@ -137,7 +138,7 @@ const loopCharArr = computed(() => new Array(Number(props.maxlength)));
  * 输入事件处理
  * @param e input事件对象
  */
-function getVal(e: { detail: { value: string } }) {
+function getVal(e: any) {
     const { value } = e.detail;
     valueModel.value = value;
     // 判断长度是否超出了maxlength值，理论上不会发生，因为input组件设置了maxlength属性值

package/components/u-modal/service.ts

@@ -0,0 +1,29 @@
+/**
+ * u-modal 函数式调用事件名（全平台）
+ * @description
+ * - useModal() 通过 uni.$emit 派发事件
+ * - <u-modal /> 通过 uni.$on 监听事件并转调自身 show/hide
+ */
+
+import type { ModalProps } from './types';
+
+// 普通（页面级）modal 事件
+export const U_MODAL_EVENT_SHOW = 'uview-pro:u-modal:show';
+export const U_MODAL_EVENT_HIDE = 'uview-pro:u-modal:hide';
+export const U_MODAL_EVENT_CLEAR_LOADING = 'uview-pro:u-modal:clear-loading';
+
+// 全局（App 根部）modal 事件，供 useModal() 使用
+export const U_MODAL_GLOBAL_EVENT_SHOW = 'uview-pro:u-modal:global:show';
+export const U_MODAL_GLOBAL_EVENT_HIDE = 'uview-pro:u-modal:global:hide';
+export const U_MODAL_GLOBAL_EVENT_CLEAR_LOADING = 'uview-pro:u-modal:global:clear-loading';
+
+/**
+ * u-modal 函数式调用载荷类型
+ * @description 完整覆盖 u-modal 的所有 props（除 modelValue 外）
+ */
+export type ModalPayload = Partial<Omit<ModalProps, 'modelValue'>> & {
+    /** 确认回调 */
+    onConfirm?: () => void;
+    /** 取消回调 */
+    onCancel?: () => void;
+};

package/components/u-modal/types.ts

@@ -33,7 +33,7 @@ export const ModalProps = {
     /** 弹窗内容 */
     content: {
         type: String,
-        default: () => t('uModal.content')
+        default: ''
     },
     /** 是否显示标题 */
     showTitle: {
@@ -114,6 +114,16 @@ export const ModalProps = {
     negativeTop: {
         type: [String, Number] as PropType<number | string>,
         default: 0
+    },
+    /** 是否作为全局根部 modal（通常放在 App.vue 中，给 useModal() 使用） */
+    global: {
+        type: Boolean,
+        default: false
+    },
+    /** 是否作为页面级 modal（通常放在页面中，给 useModal({ page: true }) 使用） */
+    page: {
+        type: Boolean,
+        default: false
     }
 };