uview-pro 0.4.11 → 0.4.13

package/changelog.md

@@ -1,18 +1,59 @@
-## 0.4.11（2025-12-30）
+## 0.4.13（2026-01-06）
 
-### 📦‍ Build System | 打包构建
+### ✨ Features | 新功能
 
-- 添加edgeone.json配置 ([ed7ba7d](https://github.com/anyup/uView-Pro/commit/ed7ba7d94dbfa791264a624a03938dc6ac58c0bb))
+- **theme:** 主题初始化时支持默认主题设置 ([f2b61f6](https://github.com/anyup/uView-Pro/commit/f2b61f6caa1c285753b2e02f97309aa55bb77cca))
+- **theme:** 增强主题系统初始化配置，支持在初始化时设置默认主题和暗黑模式 ([d228d10](https://github.com/anyup/uView-Pro/commit/d228d100baf619799b1dc1c8e289e1e8c9a30699))
 
 ### 🐛 Bug Fixes | Bug 修复
 
-- **theme:** 修复运行时设置 color 与 theme 主题色不同步问题 ([1dcf56a](https://github.com/anyup/uView-Pro/commit/1dcf56a232f5b046e0dce5eb58ec90fb46ce19d5))
-- **u-top-tips:** 修复顶部提示组件zindex显示问题，避免影响其他组件的层级显示 ([91391a8](https://github.com/anyup/uView-Pro/commit/91391a8ca10d505936c0b45488af0a3145cab335))
+- **u-number-box:** 修复 u-number-box 步进器 disabled 时字体不显示问题 ([75b3a74](https://github.com/anyup/uView-Pro/commit/75b3a74e6e763dec1a1ee0d3b4d0a62d646ee389))
+- **u-textarea:** 修复u-textarea组件设置props.border='none'无效的问题 ([c5a97ba](https://github.com/anyup/uView-Pro/commit/c5a97ba4c00d226c8c0fd9605660d2654dec9dc2))
+
+### ♻️ Code Refactoring | 代码重构
+
+- **theme:** 调整u-bg-gray-light默认色值，优化演示示例 ([37d6bda](https://github.com/anyup/uView-Pro/commit/37d6bda939f5d7c54aec09960878f236dfa32bb2))
 
 ### 👥 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.4.12（2026-01-04）
+
+### ♻️ Code Refactoring | 代码重构
+
+- **u-action-sheet:** 优化u-action-sheet组件的类型定义 ([bc5e474](https://github.com/anyup/uView-Pro/commit/bc5e474e7117e20495504ff0e2397a147595033c))
+- **zIndex:** 统一组件z-index值配置 ([ae1da98](https://github.com/anyup/uView-Pro/commit/ae1da986d307e5b4855fa32e5b2995fdb7be69e8))
+
+### 🐛 Bug Fixes | Bug 修复
+
+- **form:** 修复field实例销毁时没有正常移除问题 ([57bfd3b](https://github.com/anyup/uView-Pro/commit/57bfd3bf9315d74c416869cd5a8c41562231166a))
+
+### ✨ Features | 新功能
+
+- **u-tabbar:** 新增z-index属性支持自定义层级 ([c75d45f](https://github.com/anyup/uView-Pro/commit/c75d45f45e237453d0248124cdbe5bb797edb117))
+- **u-modal:** 增加u-modal基础属性支持和自定义样式功能 ([201231e](https://github.com/anyup/uView-Pro/commit/201231ee2e0c25c605f12f582650b048e83213de))
+- **components:** 增加u-pagination和u-picker自定义样式支持 ([eb22265](https://github.com/anyup/uView-Pro/commit/eb222657540179fcf8359133df83da89c10b09b8))
+
+### 👥 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> <a href="https://github.com/yoshinosk"><img src="https://github.com/yoshinosk.png?size=40" width="40" height="40" alt="yoshinosk" title="yoshinosk"/></a> <a href="https://github.com/liujiayii"><img src="https://github.com/liujiayii.png?size=40" width="40" height="40" alt="liujiayii" title="liujiayii"/></a> 
+
+## 0.4.11（2025-12-30）
+
+### 📦‍ Build System | 打包构建
+
+- 添加edgeone.json配置 ([ed7ba7d](https://github.com/anyup/uView-Pro/commit/ed7ba7d94dbfa791264a624a03938dc6ac58c0bb))
+
+### 🐛 Bug Fixes | Bug 修复
+
+- **theme:** 修复运行时设置 color 与 theme 主题色不同步问题 ([1dcf56a](https://github.com/anyup/uView-Pro/commit/1dcf56a232f5b046e0dce5eb58ec90fb46ce19d5))
+- **u-top-tips:** 修复顶部提示组件zindex显示问题，避免影响其他组件的层级显示 ([91391a8](https://github.com/anyup/uView-Pro/commit/91391a8ca10d505936c0b45488af0a3145cab335))
+
+### 👥 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.4.10（2025-12-26）
 
 ### 🚀 Chore | 构建/工程依赖/工具

package/components/u-config-provider/u-config-provider.vue

@@ -13,7 +13,7 @@
  * - 组件/页面场景（推荐）：使用 `useTheme()` 组合式函数在组件内部读取响应式 `currentTheme`、`themes`、`darkMode` 并通过 `setTheme()` 和 `setDarkMode()` 切换主题/模式。
  *
  * 该组件的行为：
- * - 如果在挂载时传入 `themes`，会调用 `configProvider.init(themes)`
+ * - 如果在挂载时传入 `themes`，会调用 `configProvider.initTheme(themes)`
  * - 如果传入 `currentTheme`，会优先设置当前主题
  * - 如果传入 `darkMode`，会设置当前的暗黑模式状态，同时在 document 上添加 `u-theme-dark` 或 `u-theme-light` 类名
  *
@@ -63,7 +63,7 @@ const bootstrapTheme = () => {
 
     // 未初始化，进行初始化
     if (props.themes && props.themes.length) {
-        configProvider.init(props.themes, props.currentTheme as any);
+        configProvider.initTheme(props.themes, props.currentTheme as any);
     } else {
         // 使用 useTheme 的 initTheme，它会处理默认主题
         const { initTheme } = useTheme();
@@ -91,7 +91,7 @@ watch(
         // 那么对其做深度监听会在我们内部更新主题对象时触发该回调，进而再次调用 init 导致循环更新。
         // 为避免该情况，先做简单保护：当传入对象正是 configProvider.themesRef.value 时不重复初始化。
         if (val && val.length && val !== configProvider.themesRef.value) {
-            configProvider.init(val, props.currentTheme as any);
+            configProvider.initTheme(val, props.currentTheme as any);
         }
     },
     { deep: true }

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

@@ -121,7 +121,7 @@ defineExpose({
         if (!fields.value.includes(field)) fields.value.push(field);
     },
     removeField(field: any) {
-        fields.value = fields.value.filter(f => f !== field);
+        fields.value = fields.value.filter(f => f.prop !== field.prop)
     },
     fields,
     rules,

package/components/u-keyboard/u-keyboard.vue

@@ -58,6 +58,7 @@ export default {
 <script setup lang="ts">
 import { KeyboardProps } from './types';
 import { computed } from 'vue';
+import { $u } from '../..';
 
 /**
  * keyboard 键盘
@@ -86,7 +87,7 @@ import { computed } from 'vue';
 const props = defineProps(KeyboardProps);
 const emit = defineEmits(['change', 'update:modelValue', 'confirm', 'cancel', 'backspace']);
 
-const uZIndex = computed(() => (props.zIndex ? props.zIndex : 1075));
+const uZIndex = computed(() => (props.zIndex ? props.zIndex : $u.zIndex.popup));
 
 const popupValue = computed({
     get: () => props.modelValue,

package/components/u-modal/types.ts

@@ -1,11 +1,13 @@
 import type { ExtractPropTypes, PropType } from 'vue';
 import { getColor } from '../../';
+import { baseProps } from '../common/props';
 
 /**
  * u-modal 组件 props 类型定义
  * @description 弹窗模态框，支持多种样式和交互
  */
 export const ModalProps = {
+    ...baseProps,
     /** 是否显示模态框 */
     modelValue: {
         type: Boolean,

package/components/u-modal/u-modal.vue

@@ -11,8 +11,9 @@
             :border-radius="borderRadius"
             @close="popupClose"
             :negative-top="negativeTop"
+            :custom-class="customClass"
         >
-            <view class="u-model">
+            <view class="u-model" :style="$u.toStyle(customStyle)">
                 <view v-if="showTitle" class="u-model__title u-line-1" :style="[titleStyle]">{{ title }}</view>
                 <view class="u-model__content">
                     <view :style="[contentStyle]" v-if="slots.default">
@@ -68,6 +69,7 @@ export default {
 
 <script setup lang="ts">
 import { ref, computed, watch, useSlots } from 'vue';
+import { $u } from '../..';
 import { ModalProps } from './types';
 
 /**
@@ -113,7 +115,7 @@ const cancelBtnStyle = computed(() => {
 const confirmBtnStyle = computed(() => {
     return Object.assign({ color: props.confirmColor }, props.confirmStyle);
 });
-const uZIndex = computed(() => (props.zIndex ? props.zIndex : 10075));
+const uZIndex = computed(() => (props.zIndex ? props.zIndex : $u.zIndex.popup));
 
 const popupValue = computed({
     get: () => props.modelValue,

package/components/u-navbar/types.ts

@@ -1,4 +1,5 @@
 import type { ExtractPropTypes, PropType } from 'vue';
+import zIndex from '../../libs/config/zIndex';
 
 /**
  * u-navbar 组件 props 类型定义
@@ -88,7 +89,7 @@ export const NavbarProps = {
     /** 固定在顶部时的z-index值 */
     zIndex: {
         type: [String, Number] as PropType<string | number>,
-        default: ''
+        default: zIndex.navbar
     },
     /** 自定义返回逻辑方法 */
     customBack: {

package/components/u-no-network/types.ts

@@ -1,4 +1,5 @@
 import type { ExtractPropTypes, PropType } from 'vue';
+import zIndex from '../../libs/config/zIndex';
 
 /**
  * u-no-network 组件 props 类型定义
@@ -13,7 +14,7 @@ export const NoNetworkProps = {
     /** 一个z-index值，用于设置没有网络这个组件的层次 */
     zIndex: {
         type: [Number, String] as PropType<number | string>,
-        default: ''
+        default: zIndex.noNetwork
     },
     /** 没有网络的图片提示 */
     image: {

package/components/u-number-box/u-number-box.vue

@@ -310,12 +310,12 @@ function handleChange(value: number, type: 'update:modelValue' | 'change' | 'blu
 }
 
 .u-icon-disabled {
-    color: var(--u-bg-gray-light) !important;
+    color: var(--u-type-info-disabled) !important;
     background: var(--u-bg-gray-light) !important;
 }
 
 .u-input-disabled {
-    color: var(--u-bg-gray-light) !important;
+    color: var(--u-type-info-disabled) !important;
     background-color: var(--u-bg-gray-light) !important;
 }
 </style>

package/components/u-pagination/u-pagination.vue

@@ -1,5 +1,5 @@
 <template>
-    <view class="u-pagination">
+    <view class="u-pagination" :style="$u.toStyle(customStyle)" :class="customClass">
         <u-button
             custom-class="custom-class"
             shape="circle"
@@ -51,6 +51,7 @@ export default {
 import { computed } from 'vue';
 import { type PaginationEmits, PaginationProps } from './types.ts';
 import type { PaginationDirection } from '../../types/global';
+import { $u } from '../../';
 
 const props = defineProps(PaginationProps);
 const emit = defineEmits<PaginationEmits>();

package/components/u-picker/types.ts

@@ -1,6 +1,8 @@
 import type { ExtractPropTypes, PropType } from 'vue';
 import type { PickerMode, PickerParams } from '../../types/global';
 import { getColor } from '../../';
+import zIndex from '../../libs/config/zIndex';
+import { baseProps } from '../common/props';
 
 const defaultParams: PickerParams = {
     year: true,
@@ -19,6 +21,7 @@ const defaultParams: PickerParams = {
  * @description 支持时间、地区、单列、多列等多种模式
  */
 export const PickerProps = {
+    ...baseProps,
     /** picker中需要显示的参数 */
     params: {
         type: Object as PropType<PickerParams>,
@@ -107,7 +110,7 @@ export const PickerProps = {
     /** 弹出的z-index值 */
     zIndex: {
         type: [String, Number] as PropType<number | string>,
-        default: 0
+        default: zIndex.popup
     },
     /** 顶部标题 */
     title: {

package/components/u-picker/u-picker.vue

@@ -8,8 +8,9 @@
         :safeAreaInsetBottom="safeAreaInsetBottom"
         @close="close"
         :z-index="uZIndex"
+        :custom-class="customClass"
     >
-        <view class="u-datetime-picker">
+        <view class="u-datetime-picker" :style="$u.toStyle(customStyle)">
             <view class="u-picker-header" @touchmove.stop.prevent="">
                 <view
                     class="u-btn-picker u-btn-picker--tips"
@@ -156,6 +157,7 @@ import provinces from '../../libs/util/province';
 import citys from '../../libs/util/city';
 import areas from '../../libs/util/area';
 import { PickerProps } from './types';
+import { $u } from '../..';
 
 /**
  * picker picker弹出选择器
@@ -274,7 +276,7 @@ const regionChange = computed(() => `${province.value}-${city.value}`);
 
 const yearAndMonth = computed(() => `${year.value}-${month.value}`);
 // 如果用户有传递z-index值，优先使用
-const uZIndex = computed(() => (props.zIndex ? props.zIndex : 1075));
+const uZIndex = computed(() => (props.zIndex ? props.zIndex : $u.zIndex.popup));
 
 // 当外部的默认值被动态修改时，如果 preserveSelection 为 false，应把外部值视为新的 saved 值并在打开时生效
 watch(

package/components/u-popup/types.ts

@@ -1,10 +1,7 @@
 import type { ExtractPropTypes, PropType } from 'vue';
 import type { PopupCloseIconPos, PopupMode } from '../../types/global';
 import { baseProps } from '../common/props';
-
-/**
- * PopupMode 弹窗弹出方向类型
- */
+import zIndex from '../../libs/config/zIndex';
 
 /**
  * PopupProps 弹窗 props 类型定义
@@ -33,7 +30,7 @@ export const PopupProps = {
     /** 圆角 */
     borderRadius: { type: [Number, String] as PropType<number | string>, default: 0 },
     /** 弹窗z-index */
-    zIndex: { type: [Number, String] as PropType<number | string>, default: '' },
+    zIndex: { type: [Number, String] as PropType<number | string>, default: zIndex.popup },
     /** 是否显示关闭图标 */
     closeable: { type: Boolean, default: false },
     /** 关闭图标的名称，只能uView的内置图标 */

package/components/u-popup/u-popup.vue

@@ -2,7 +2,7 @@
     <view
         v-if="visibleSync"
         class="u-drawer"
-        :style="$u.toStyle({ zIndex: Number(uZindex) - 1 }, customStyle)"
+        :style="$u.toStyle({ zIndex: Number(uZIndex) - 1 }, customStyle)"
         :class="customClass"
         hover-stop-propagation
     >
@@ -10,7 +10,7 @@
             :duration="duration"
             :custom-style="maskCustomStyle"
             :maskClickAble="maskCloseAble"
-            :z-index="Number(uZindex) - 2"
+            :z-index="Number(uZIndex) - 2"
             :show="showDrawer && mask"
             @click="maskClick"
         ></u-mask>
@@ -124,7 +124,7 @@ const style = computed(() => {
         };
     }
     // 如果用户设置了borderRadius值，添加弹窗的圆角
-    style.zIndex = uZindex.value;
+    style.zIndex = uZIndex.value;
     if (props.borderRadius) {
         switch (props.mode) {
             case 'left':
@@ -155,7 +155,7 @@ const centerStyle = computed(() => {
 
     // 中部弹出的模式，如果没有设置高度，就用auto值，由内容撑开高度
     style.height = props.height ? getUnitValue(props.height) : 'auto';
-    style.zIndex = uZindex.value;
+    style.zIndex = uZIndex.value;
     style.marginTop = `-${$u.addUnit(props.negativeTop)}`;
     if (props.borderRadius) {
         style.borderRadius = `${props.borderRadius}rpx`;
@@ -166,7 +166,7 @@ const centerStyle = computed(() => {
 });
 
 // 计算整理后的z-index值
-const uZindex = computed(() => (props.zIndex ? props.zIndex : $u.zIndex.popup));
+const uZIndex = computed(() => (props.zIndex ? props.zIndex : $u.zIndex.popup));
 
 watch(
     () => props.modelValue,

package/components/u-select/u-select.vue

@@ -130,7 +130,7 @@ const columnNum = ref(0);
 // 列是否还在滑动中，微信小程序如果在滑动中就点确定，结果可能不准确
 const moving = ref(false);
 // 如果用户有传递z-index值，优先使用
-const uZIndex = computed(() => (props.zIndex ? props.zIndex : 10075));
+const uZIndex = computed(() => (props.zIndex ? props.zIndex : $u.zIndex.popup));
 
 const popupValue = computed({
     get: () => props.modelValue,

package/components/u-sticky/types.ts

@@ -1,5 +1,6 @@
 import type { ExtractPropTypes, PropType } from 'vue';
 import { baseProps } from '../common/props';
+import zIndex from '../../libs/config/zIndex';
 
 /**
  * StickyProps 吸顶组件 props 类型定义
@@ -18,7 +19,7 @@ export const StickyProps = {
     /** 吸顶区域的背景颜色 */
     bgColor: { type: String, default: 'var(--u-bg-white)' },
     /** z-index值 */
-    zIndex: { type: [Number, String] as PropType<number | string>, default: '' }
+    zIndex: { type: [Number, String] as PropType<number | string>, default: zIndex.sticky }
 };
 
 export type StickyProps = ExtractPropTypes<typeof StickyProps>;

package/components/u-tabbar/types.ts

@@ -1,6 +1,7 @@
 import type { ExtractPropTypes, PropType } from 'vue';
 import { baseProps } from '../common/props';
 import type { TabbarItem } from '../../types/global';
+import zIndex from '../../libs/config/zIndex';
 
 /**
  * TabbarProps 底部导航栏 props 类型定义
@@ -35,7 +36,9 @@ export const TabbarProps = {
     /** 是否显示顶部横线 */
     borderTop: { type: Boolean, default: true },
     /** 是否隐藏原生tabbar */
-    hideTabBar: { type: Boolean, default: true }
+    hideTabBar: { type: Boolean, default: true },
+    /** z-index层级 */
+    zIndex: { type: [String, Number] as PropType<string | number>, default: zIndex.tabbar }
 };
 
 export type TabbarProps = ExtractPropTypes<typeof TabbarProps>;

package/components/u-tabbar/u-tabbar.vue

@@ -8,7 +8,7 @@
     >
         <view
             class="u-tabbar__content safe-area-inset-bottom"
-            :style="{ height: $u.addUnit(props.height), backgroundColor: props.bgColor }"
+            :style="{ height: $u.addUnit(props.height), backgroundColor: props.bgColor, zIndex: uZIndex }"
             :class="{ 'u-border-top': props.borderTop }"
         >
             <view
@@ -110,6 +110,9 @@ const props = defineProps(TabbarProps);
 
 const emit = defineEmits<{ (e: 'change', index: number): void; (e: 'update:modelValue', index: number): void }>();
 
+// 计算z-index值
+const uZIndex = computed(() => props?.zIndex ?? $u.zIndex.tabbar);
+
 // 由于安卓太菜了，通过css居中凸起按钮的外层元素有误差，故通过js计算将其居中
 const midButtonLeft = ref('50%');
 const pageUrl = ref(''); // 当前页面URL

package/components/u-textarea/types.ts

@@ -1,5 +1,6 @@
 import type { ExtractPropTypes, PropType } from 'vue';
 import { baseProps } from '../common/props';
+import type { TextareaBorder } from '../../types/global';
 
 const textarea = {
     value: '',
@@ -72,7 +73,7 @@ export const TextareaProps = {
     // 最大输入长度，设置为 -1 的时候不限制最大长度
     maxlength: { type: [String, Number] as PropType<string | number>, default: textarea.maxlength },
     // 边框类型，surround-四周边框，bottom-底部边框
-    border: { type: [String, Boolean] as PropType<string | boolean>, default: textarea.border },
+    border: { type: [String, Boolean] as PropType<TextareaBorder | boolean>, default: textarea.border },
     // 用于处理或者过滤输入框内容的方法
     formatter: { type: Function as PropType<((val: any) => any) | null>, default: textarea.formatter },
     // 是否忽略组件内对文本合成系统事件的处理

package/components/u-textarea/u-textarea.vue

@@ -165,7 +165,7 @@ watch(
 // 组件的类名
 const textareaClass = computed(() => {
     let classes: string[] = [];
-    if (props.border) {
+    if (props.border && props.border !== 'none') {
         if (props.border === 'surround') {
             classes = classes.concat(['u-textarea--border', 'u-textarea--radius']);
         } else if (props.border === 'bottom') {
@@ -181,7 +181,7 @@ const textareaClass = computed(() => {
 // 组件的样式
 const textareaStyle = computed(() => {
     const style: Record<string, any> = {};
-    if (props.border) {
+    if (props.border && props.border !== 'none') {
         style.padding = `${props.border ? 20 : 0}rpx`;
     }
     // #ifdef APP-NVUE

package/components/u-toast/types.ts

@@ -1,6 +1,7 @@
 import type { ExtractPropTypes, PropType } from 'vue';
 import type { ThemeType, ToastPosition } from '../../types/global';
 import { baseProps } from '../common/props';
+import zIndex from '../../libs/config/zIndex';
 
 /**
  * ToastProps toast props 类型定义
@@ -9,7 +10,7 @@ import { baseProps } from '../common/props';
 export const ToastProps = {
     ...baseProps,
     /** 层级 z-index */
-    zIndex: { type: [Number, String] as PropType<number | string>, default: '' },
+    zIndex: { type: [Number, String] as PropType<number | string>, default: zIndex.toast },
     /** 提示类型，success/warning/error/loading 等 */
     type: { type: String as PropType<ThemeType | 'default'>, default: '' },
     /** 显示时长，单位ms */

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

@@ -1,5 +1,6 @@
 import type { ExtractPropTypes, PropType } from 'vue';
 import { baseProps } from '../common/props';
+import zIndex from '../../libs/config/zIndex';
 
 /**
  * TopTipsProps top-tips props 类型定义
@@ -10,7 +11,7 @@ export const TopTipsProps = {
     /** 导航栏高度，用于提示的初始化 */
     navbarHeight: { type: [Number, String] as PropType<number | string>, default: 0 },
     /** z-index值 */
-    zIndex: { type: [Number, String] as PropType<number | string>, default: '' }
+    zIndex: { type: [Number, String] as PropType<number | string>, default: zIndex.topTips }
 };
 
 export type TopTipsProps = ExtractPropTypes<typeof TopTipsProps>;

package/index.ts

@@ -17,14 +17,19 @@ const install = (app: any, options?: UViewProOptions): void => {
     try {
         if (options) {
             // 配置主题：统一使用 useTheme 的 initTheme 初始化，避免重复初始化
-            if (options.theme) {
-                // 如果是数组，则为多主题配置
-                // 直接使用 useTheme 的 initTheme，它会智能处理重复初始化
-                if (Array.isArray(options.theme)) {
-                    initTheme(options.theme);
+            if (options?.theme) {
+                const optTheme = options.theme as any;
+                // 1.如果是数组，则为多主题配置
+                if (Array.isArray(optTheme)) {
+                    initTheme(optTheme);
+                } else if (typeof optTheme === 'object' && optTheme.themes) {
+                    // 2.如果为对象且有themes，则为多主题配置+设置默认主题
+                    initTheme(optTheme.themes, {
+                        defaultTheme: optTheme.defaultTheme,
+                        defaultDarkMode: optTheme.defaultDarkMode
+                    });
                 } else {
-                    // 兼容之前只有一套样式的情况,需要覆盖默认主题
-                    // 获取默认主题（uviewpro）
+                    // 3.兼容之前只有一套样式的情况,需要覆盖默认主题，默认系统主题（uviewpro）
                     const defaultTheme = defaultThemes[0];
                     if (defaultTheme) {
                         // 创建新主题对象，用用户的 theme 覆盖默认主题的 color
@@ -32,7 +37,7 @@ const install = (app: any, options?: UViewProOptions): void => {
                             ...defaultTheme,
                             color: {
                                 ...defaultTheme.color,
-                                ...options.theme
+                                ...optTheme
                             }
                         };
                         // 初始化主题（只包含覆盖后的默认主题）

package/libs/config/config.ts

@@ -1,8 +1,7 @@
-// 此版本发布于2023-03-27
 /**
  * 组件库配置项类型定义
  */
-
+import { reactive } from 'vue';
 import { version } from '../../package.json';
 import type { DarkMode } from '../../types/global';
 
@@ -19,9 +18,7 @@ export interface AppConfig {
     defaultDarkMode: DarkMode;
 }
 
-// const version: string = '1.8.8';
-
-const config: AppConfig = {
+export const config = reactive<AppConfig>({
     v: version,
     version: version,
     // 主题名称
@@ -30,6 +27,6 @@ const config: AppConfig = {
     defaultTheme: 'uviewpro',
     // 默认为亮色模式
     defaultDarkMode: 'light'
-};
+});
 
 export default config;

package/libs/config/theme-tokens.ts

@@ -34,7 +34,7 @@ export const lightPalette: ThemeColor = {
     shadowColor: 'rgba(0, 0, 0, 0.1)',
     bgColor: '#f3f4f6',
     bgWhite: '#ffffff',
-    bgGrayLight: '#f5f7fa',
+    bgGrayLight: '#f1f1f1',
     bgGrayDark: '#2f343c',
     bgBlack: '#000000'
 };

package/libs/config/zIndex.ts

@@ -1,37 +1,30 @@
-// uniapp在H5中各API的z-index值如下：
-/**
- * actionsheet: 999
- * modal: 999
- * navigate: 998
- * tabbar: 998
- * toast: 999
- */
-
 /**
  * 组件库 z-index 配置项类型定义
  */
 export interface ZIndexConfig {
     toast: number;
     noNetwork: number;
-    /** popup包含popup，actionsheet，keyboard，picker的值 */
+    /** popup包含popup，actionSheet，keyboard，picker的值 */
     popup: number;
     mask: number;
     navbar: number;
     topTips: number;
     sticky: number;
     indexListSticky: number;
+    tabbar: number;
 }
 
 const zIndex: ZIndexConfig = {
     toast: 10090,
     noNetwork: 10080,
-    // popup包含popup，actionsheet，keyboard，picker的值
+    // popup包含popup，actionSheet，keyboard，picker的值
     popup: 10075,
     mask: 10070,
     navbar: 980,
     topTips: 975,
     sticky: 970,
-    indexListSticky: 965
+    indexListSticky: 965,
+    tabbar: 998
 };
 
 export default zIndex;

package/libs/hooks/useTheme.ts

@@ -7,7 +7,7 @@
  */
 
 import type { DarkMode, Theme } from '../../types/global';
-import configProvider from '../util/config-provider';
+import configProvider, { type DefaultThemeConfig } from '../util/config-provider';
 import { defaultThemes } from '../config/theme-tokens';
 
 const THEME_STORAGE_KEY = 'uview-pro-theme';
@@ -64,42 +64,44 @@ function getAvailableThemes() {
 /**
  * 初始化主题系统
  * @param themes 可选的主题列表，如果未提供则尝试从 uni.$u.themes 读取
- * @param defaultThemeName 可选的默认主题名
+ * @param defaultConfig 可选的默认主题配置，支持字符串（默认主题名）或对象（{ defaultTheme?, defaultDarkMode? }）
  */
-export function initTheme(themes?: any[], defaultThemeName?: string) {
+export function initTheme(themes?: Theme[], defaultConfig?: string | DefaultThemeConfig) {
     // 如果有传入主题列表，使用传入的
     if (Array.isArray(themes) && themes.length > 0) {
-        configProvider.init(themes, defaultThemeName);
+        configProvider.initTheme(themes, defaultConfig);
         return;
     }
 
-    // 若已通过插件或其他方式完成初始化，则不再覆盖，最多按需切换默认主题
-    const existingThemes = configProvider.getThemes();
-    if (existingThemes.length > 0) {
-        if (defaultThemeName) {
-            configProvider.setTheme(defaultThemeName);
-        } else if (!configProvider.getCurrentTheme()) {
-            configProvider.setTheme(existingThemes[0].name);
-        } else {
-            // 触发一次 apply，便于初始化 CSS 变量
-            configProvider.setTheme(configProvider.getCurrentTheme()!.name);
-        }
-        return;
-    }
-
-    // 初始化 configProvider（如果运行时提供了内置主题）
-    try {
-        const builtin = (typeof uni !== 'undefined' && (uni as any).$u && (uni as any).$u.themes) || [];
-        if (Array.isArray(builtin) && builtin.length > 0) {
-            configProvider.init(builtin as Theme[], defaultThemeName);
-            return;
-        }
-    } catch (e) {
-        // ignore
-    }
+    // // 若已通过插件或其他方式完成初始化，则不再覆盖，最多按需切换默认主题
+    // const existingThemes = configProvider.getThemes();
+    // if (existingThemes.length > 0) {
+    //     if (typeof defaultConfig === 'string') {
+    //         configProvider.setTheme(defaultConfig);
+    //     } else if (defaultConfig && typeof defaultConfig === 'object' && (defaultConfig as any).defaultTheme) {
+    //         configProvider.setTheme(defaultConfig.defaultTheme);
+    //     } else if (!configProvider.getCurrentTheme()) {
+    //         configProvider.setTheme(existingThemes[0].name);
+    //     } else {
+    //         // 触发一次 apply，便于初始化 CSS 变量
+    //         configProvider.setTheme(configProvider.getCurrentTheme()!.name);
+    //     }
+    //     return;
+    // }
+
+    // // 初始化 configProvider（如果运行时提供了内置主题）
+    // try {
+    //     const builtin = (typeof uni !== 'undefined' && (uni as any).$u && (uni as any).$u.themes) || [];
+    //     if (Array.isArray(builtin) && builtin.length > 0) {
+    //         configProvider.initTheme(builtin as Theme[], defaultConfig);
+    //         return;
+    //     }
+    // } catch (e) {
+    //     // ignore
+    // }
 
     // 回退到内置默认主题
-    configProvider.init(defaultThemes as Theme[], defaultThemeName);
+    configProvider.initTheme(defaultThemes as Theme[], defaultConfig);
 }
 
 /**

package/libs/util/config-provider.ts

@@ -33,6 +33,17 @@ const STRUCTURAL_TOKENS = new Set([
     'shadowColor'
 ]);
 
+export type DefaultThemeConfig = {
+    /**
+     * 默认主题
+     */
+    defaultTheme?: string;
+    /**
+     * 默认暗黑模式
+     */
+    defaultDarkMode?: DarkMode;
+};
+
 /**
  * ConfigProvider: 管理全局主题
  * - init(themes, defaultName): 初始化主题系统
@@ -141,28 +152,39 @@ export class ConfigProvider {
     /**
      * 初始化主题系统
      * @param themes 可用主题数组
-     * @param defaultThemeName 可选默认主题名
+     * @param defaultTheme 可选默认主题名
      */
-    init(themes?: Theme[], defaultThemeName?: string) {
+    initTheme(themes?: Theme[], defaultConfig?: string | DefaultThemeConfig) {
         const normalizedThemes = this.normalizeThemes(themes);
         if (!normalizedThemes.length) {
             console.warn('[ConfigProvider] init called with empty themes');
             return;
         }
 
+        // 配置默认主题
+        if (defaultConfig) {
+            if (typeof defaultConfig === 'string') {
+                config.defaultTheme = defaultConfig || config.defaultTheme;
+            } else if (typeof defaultConfig === 'object') {
+                const { defaultTheme, defaultDarkMode } = defaultConfig;
+                config.defaultTheme = defaultTheme || config.defaultTheme;
+                config.defaultDarkMode = defaultDarkMode || config.defaultDarkMode;
+            }
+        }
+
+        // 设置主题列表，响应式
         this.themesRef.value = normalizedThemes.slice();
 
         // 先尝试从 Storage 读取已保存主题名
         const saved = this.readStorage<string>(THEME_STORAGE_KEY);
-
-        let initialName = saved || defaultThemeName || this.themesRef.value[0].name;
+        let initialName = saved || config.defaultTheme || this.themesRef.value[0].name;
         const found = this.themesRef.value.find(t => t.name === initialName) || this.themesRef.value[0];
 
+        // 设置当前主题，响应式
         this.currentThemeRef.value = found;
 
-        // 尝试从 Storage 读取暗黑模式设置
-        const savedDarkMode = this.readStorage<DarkMode>(DARK_MODE_STORAGE_KEY);
-        this.darkModeRef.value = savedDarkMode || config.defaultDarkMode;
+        // 初始化暗黑模式设置
+        this.initDarkMode(config.defaultDarkMode);
 
         // 应用主题
         this.applyTheme(found);
@@ -173,6 +195,16 @@ export class ConfigProvider {
         return this;
     }
 
+    /**
+     * 初始化暗黑模式设置
+     * @param darkMode
+     */
+    initDarkMode(darkMode?: DarkMode) {
+        // 尝试从 Storage 读取暗黑模式设置
+        const savedDarkMode = this.readStorage<DarkMode>(DARK_MODE_STORAGE_KEY);
+        this.darkModeRef.value = savedDarkMode || darkMode || config.defaultDarkMode;
+    }
+
     /**
      * 获取所有可用主题
      */

package/package.json

@@ -2,8 +2,8 @@
     "id": "uview-pro",
     "name": "uview-pro",
     "displayName": "【支持鸿蒙】uView Pro｜基于Vue3+TS的高质量UI组件库，支持多主题、暗黑模式",
-    "version": "0.4.11",
-    "description": "uView Pro 是为 Vue 3 + TypeScript 的 uni-app 生态量身打造的多平台 UI 框架。提供 80+ 高质量组件、丰富主题与暗黑模式、实用开发工具与模板，显著提升 H5/APP/鸿蒙/小程序 的多端开发效率，目前已在华为鸿蒙应用商店上线，欢迎体验。",
+    "version": "0.4.13",
+    "description": "uView Pro是基于Vue3+TS的多平台UI框架，提供80+高质量组件、便捷工具和常用模板，支持多主题与暗黑模式，支持H5/APP/鸿蒙/小程序等多端开发。已在华为鸿蒙应用商店上架，欢迎体验！",
     "main": "index.ts",
     "module": "index.ts",
     "browser": "index.ts",

package/theme.scss

@@ -25,7 +25,7 @@ page {
     /* 背景色 */
     --u-bg-color: #f3f4f6;
     --u-bg-white: #ffffff;
-    --u-bg-gray-light: #f5f7fa;
+    --u-bg-gray-light: #f1f1f1;
     --u-bg-gray-dark: #2f343c;
     --u-bg-black: #000000;
 

package/types/global.d.ts

@@ -21,7 +21,7 @@ export type ActionSheetItem = {
     text: string;
     subText?: string;
     color?: string;
-    fontSize?: string;
+    fontSize?: string | number;
     disabled?: boolean;
 };
 
@@ -29,7 +29,7 @@ export type ActionSheetItem = {
 export type ActionSheetTips = {
     text: string;
     color?: string;
-    fontSize?: string;
+    fontSize?: string | number;
 };
 
 // avatar-cropper 裁剪矩形框的样式
@@ -160,6 +160,8 @@ export type InputConfirmType = 'send' | 'search' | 'next' | 'go' | 'done';
 
 export type InputLabelPosition = 'left' | 'top';
 
+export type TextareaBorder = 'surround' | 'none' | 'bottom';
+
 export type FormErrorType = 'message' | 'border' | 'border-bottom' | 'none' | 'toast';
 
 export type IconLabelPosition = 'left' | 'top' | 'right' | 'bottom';
@@ -372,6 +374,12 @@ export type Theme = {
     darkCss?: Record<string, string>;
 };
 
+export type Themes = {
+    themes: Theme[];
+    defaultTheme?: string;
+    defaultDarkMode?: DarkMode;
+};
+
 export type LogConfig = Partial<{
     debug?: boolean;
     prefix?: string;
@@ -379,7 +387,7 @@ export type LogConfig = Partial<{
 }>;
 
 export interface UViewProOptions {
-    theme?: ThemeColor | Theme[];
+    theme?: ThemeColor | Theme[] | Themes;
     log?: LogConfig;
     // 可扩展更多配置项
 }