uview-pro 0.3.5 → 0.3.6

package/changelog.md

@@ -1,3 +1,25 @@
+## 0.3.6（2025-10-24）
+
+### ✨ Features | 新功能
+
+- **u-select:** 优化选择器组件 u-select 默认值处理逻辑，添加 preserveSelection 属性，用于控制是否保留用户上次确认的选择 ([8493ff1](https://github.com/anyup/uView-Pro/commit/8493ff16d2eee42fabe926917d940a350b86abe0))
+- **u-picker:** 优化 picker 的初始化和渲染流程，实现多次打开 picker 时保留用户选择的逻辑，新增 preserveSelection 属性支持 ([974872e](https://github.com/anyup/uView-Pro/commit/974872ec944fbb28cdb3c40fda08c9039bf0b960))
+
+### ♻️ Code Refactoring | 代码重构
+
+- **components:** 使用主题色替代硬编码颜色值，统一组件的颜色风格，便于未来主题颜色的调整和维护 ([ec348d4](https://github.com/anyup/uView-Pro/commit/ec348d4a8bff4dee62da78eadd23fc3a292ebdca))
+- **example:** 代码示例中使用主题色替换硬编码颜色值 ([3216497](https://github.com/anyup/uView-Pro/commit/32164973d54cfff3edcbe765a8ed27158f4bec7d))
+- **u-steps:** 新增u-step ([6b86eea](https://github.com/anyup/uView-Pro/commit/6b86eeaf7699eb13f739fc038d86efb4e3b48f8a))
+- **u-step:** 替换步骤条组件中的默认硬编码颜色值 ([f3408ef](https://github.com/anyup/uView-Pro/commit/f3408ef006991702895432e775f266fb196ddf12))
+
+### 🐛 Bug Fixes | Bug 修复
+
+- **u-picker:** 修复使用u-picker组件选择地区不设置默认值报错的问题 ([7941135](https://github.com/anyup/uView-Pro/commit/7941135a87a3511a562ed10e34573ef7f786fb57))
+
+### 👥 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/lonelyflyer"><img src="https://github.com/lonelyflyer.png?size=40" width="40" height="40" alt="Lonelyflyer" title="Lonelyflyer"/></a>
+
 ## 0.3.5（2025-10-21）
 
 ### 🐛 Bug Fixes | Bug 修复

package/components/u-calendar/types.ts

@@ -1,6 +1,7 @@
 import { type ExtractPropTypes, type PropType } from 'vue';
 import type { CalendarChangeDate, CalendarChangeRange, CalendarMode, ThemeType } from '../../types/global';
 import { baseProps } from '../common/props';
+import { $u } from '../../';
 
 /**
  * calendar 日历类型定义
@@ -39,13 +40,13 @@ export const CalendarProps = {
     /** 默认日期字体颜色 */
     color: { type: String, default: '#303133' },
     /** 选中|起始结束日期背景色 */
-    activeBgColor: { type: String, default: '#2979ff' },
+    activeBgColor: { type: String, default: $u.color.primary },
     /** 选中|起始结束日期字体颜色 */
     activeColor: { type: String, default: '#ffffff' },
     /** 范围内日期背景色 */
     rangeBgColor: { type: String, default: 'rgba(41,121,255,0.13)' },
     /** 范围内日期字体颜色 */
-    rangeColor: { type: String, default: '#2979ff' },
+    rangeColor: { type: String, default: $u.color.primary },
     /** mode=range时生效，起始日期自定义文案 */
     startText: { type: String, default: '开始' },
     /** mode=range时生效，结束日期自定义文案 */

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

@@ -270,11 +270,11 @@ import Calendar from '../../libs/util/calendar';
  * @property {String} month-arrow-color 月份切换按钮箭头颜色(默认#606266)
  * @property {String} year-arrow-color 年份切换按钮箭头颜色(默认#909399)
  * @property {String} color 日期字体的默认颜色(默认#303133)
- * @property {String} active-bg-color 起始/结束日期按钮的背景色(默认#2979ff)
+ * @property {String} active-bg-color 起始/结束日期按钮的背景色(默认主题色primary)
  * @property {String Number} z-index 弹出时的z-index值(默认10075)
  * @property {String} active-color 起始/结束日期按钮的字体颜色(默认#ffffff)
  * @property {String} range-bg-color 起始/结束日期之间的区域的背景颜色(默认rgba(41,121,255,0.13))
- * @property {String} range-color 选择范围内字体颜色(默认#2979ff)
+ * @property {String} range-color 选择范围内字体颜色(默认主题色primary)
  * @property {String} start-text 起始日期底部的提示文字(默认 '开始')
  * @property {String} end-text 结束日期底部的提示文字(默认 '结束')
  * @property {String} btn-type 底部确定按钮的主题(默认 'primary')

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

@@ -1,6 +1,7 @@
 import { type ExtractPropTypes, type PropType } from 'vue';
 import type { Shape } from '../../types/global';
 import { baseProps } from '../common/props';
+import { $u } from '../../';
 
 /**
  * checkbox-group 复选框组类型定义
@@ -20,7 +21,7 @@ export const CheckboxGroupProps = {
     /** 形状，square为方形，circle为原型 */
     shape: { type: String as PropType<Shape>, default: 'square' },
     /** 选中状态下的颜色 */
-    activeColor: { type: String, default: '#2979ff' },
+    activeColor: { type: String, default: $u.color.primary },
     /** 组件的整体大小 */
     size: { type: [String, Number], default: 34 },
     /** 每个checkbox占u-checkbox-group的宽度 */

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

@@ -34,7 +34,7 @@ import { CheckboxGroupProps } from './types';
  * @property {String} width 宽度，需带单位
  * @property {String} shape 外观形状，shape-方形，circle-圆形(默认circle)
  * @property {Boolean} wrap 是否每个checkbox都换行（默认false）
- * @property {String} active-color 选中时的颜色，应用到所有子Checkbox组件（默认#2979ff）
+ * @property {String} active-color 选中时的颜色，应用到所有子Checkbox组件（默认主题色primary）
  * @event {Function} change 任一个checkbox状态发生变化时触发，回调为一个对象
  * @example <u-checkbox-group></u-checkbox-group>
  */

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

@@ -116,13 +116,13 @@ import { $u } from '../..';
  * u-city-select 城市选择器
  * @description 用于选择省、市、区三级行政区域，支持回显和自定义初始值。
  * @property {Boolean} modelValue 控制弹窗显示与隐藏（v-model）
- * @property {Array} defaultRegion 默认选中的省市区名称数组，如 ['广东省', '广州市', '天河区']
+ * @property {Array} defaultRegion 默认选中的省市区名称数组，如 ['山东省', '青岛市', '崂山区']
  * @property {Array} areaCode 默认选中的省市区编码数组，如 ['440000', '440100', '440106']
  * @property {Boolean} maskCloseAble 是否允许点击遮罩关闭弹窗（默认 true）
  * @property {String|Number} zIndex 弹窗层级（默认 0，自动适配）
  * @event update:modelValue v-model 绑定值变化时触发
  * @event city-change 选择省市区后触发，返回选中的省市区对象
- * @example <u-city-select v-model="show" :defaultRegion="['广东省','广州市','天河区']" @city-change="onChange"></u-city-select>
+ * @example <u-city-select v-model="show" :defaultRegion="['山东省', '青岛市', '崂山区']" @city-change="onChange"></u-city-select>
  */
 const props = defineProps(CitySelectProps);
 

package/components/u-dropdown/types.ts

@@ -1,5 +1,6 @@
 import type { ExtractPropTypes, PropType } from 'vue';
 import { baseProps } from '../common/props';
+import { $u } from '../../';
 
 /**
  * u-dropdown 下拉菜单 Props
@@ -8,9 +9,9 @@ import { baseProps } from '../common/props';
 export const DropdownProps = {
     ...baseProps,
     /** 菜单标题和选项的激活态颜色 */
-    activeColor: { type: String, default: '#2979ff' },
+    activeColor: { type: String, default: $u.color.primary },
     /** 菜单标题和选项的未激活态颜色 */
-    inactiveColor: { type: String, default: '#606266' },
+    inactiveColor: { type: String, default: $u.color.contentColor },
     /** 点击遮罩是否关闭菜单 */
     closeOnClickMask: { type: Boolean, default: true },
     /** 点击当前激活项标题是否关闭菜单 */

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

@@ -83,7 +83,7 @@ import { DropdownProps } from './types';
  * dropdown 下拉菜单
  * @description 该组件一般用于向下展开菜单，同时可切换多个选项卡的场景
  * @tutorial https://uviewpro.cn/zh/components/dropdown.html
- * @property {String} active-color 标题和选项卡选中的颜色（默认#2979ff）
+ * @property {String} active-color 标题和选项卡选中的颜色（默认主题色primary）
  * @property {String} inactive-color 标题和选项卡未选中的颜色（默认#606266）
  * @property {Boolean} close-on-click-mask 点击遮罩是否关闭菜单（默认true）
  * @property {Boolean} close-on-click-self 点击当前激活项标题是否关闭菜单（默认true）

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

@@ -114,7 +114,7 @@ defineExpose({
 .u-index-anchor--active {
     right: 0;
     left: 0;
-    color: #2979ff;
+    color: $u-type-primary;
     background-color: #fff;
 }
 </style>

package/components/u-index-list/types.ts

@@ -1,4 +1,5 @@
 import type { ExtractPropTypes, PropType } from 'vue';
+import { $u } from '../../';
 
 /**
  * u-index-list 组件 props 类型定义
@@ -33,7 +34,7 @@ export const IndexListProps = {
     /** 锚点和右边索引字符高亮颜色 */
     activeColor: {
         type: String,
-        default: '#2979ff'
+        default: $u.color.primary
     }
 };
 

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

@@ -61,7 +61,7 @@ import { IndexListProps } from './types';
  * @property {Number|String} z-index 锚点吸顶时的层级（默认965）
  * @property {Boolean} sticky 是否开启锚点自动吸顶（默认true）
  * @property {Number|String} offset-top 锚点自动吸顶时与顶部的距离（默认0）
- * @property {String} highlight-color 锚点和右边索引字符高亮颜色（默认#2979ff）
+ * @property {String} highlight-color 锚点和右边索引字符高亮颜色（默认主题色primary）
  * @event {Function} select 选中右边索引字符时触发
  * @example <u-index-list :scrollTop="scrollTop"></u-index-list>
  */

package/components/u-link/types.ts

@@ -1,4 +1,5 @@
 import type { ExtractPropTypes, PropType } from 'vue';
+import { $u } from '../../';
 
 /**
  * u-link 组件 props 类型定义
@@ -8,7 +9,7 @@ export const LinkProps = {
     /** 文字颜色 */
     color: {
         type: String,
-        default: '#2979ff'
+        default: $u.color.primary
     },
     /** 字体大小，单位rpx */
     fontSize: {

package/components/u-message-input/types.ts

@@ -1,5 +1,6 @@
 import type { ExtractPropTypes, PropType } from 'vue';
 import type { MessageInputMode } from '../../types/global';
+import { $u } from '../../';
 
 /**
  * u-message-input 组件 props 类型定义
@@ -49,12 +50,12 @@ export const MessageInputProps = {
     /** 激活样式 */
     activeColor: {
         type: String,
-        default: '#2979ff'
+        default: $u.color.primary
     },
     /** 未激活的样式 */
     inactiveColor: {
         type: String,
-        default: '#606266'
+        default: $u.color.contentColor
     },
     /** 输入框的大小，单位rpx，宽等于高 */
     width: {

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

@@ -99,7 +99,7 @@ import { MessageInputProps } from './types';
  * @property {Boolean} focus 是否自动获取焦点（默认false）
  * @property {Boolean} bold 字体和输入横线是否加粗（默认true）
  * @property {String|Number} font-size 字体大小，单位rpx（默认60）
- * @property {String} active-color 当前激活输入框的样式（默认#2979ff）
+ * @property {String} active-color 当前激活输入框的样式（默认主题色primary）
  * @property {String} inactive-color 非激活输入框的样式，文字颜色同此值（默认#606266）
  * @property {String|Number} width 输入框宽度，单位rpx，高等于宽（默认80）
  * @property {Boolean} disabled-keyboard 禁止点击输入框唤起系统键盘（默认false）

package/components/u-modal/types.ts

@@ -1,4 +1,5 @@
 import type { ExtractPropTypes, PropType } from 'vue';
+import { $u } from '../../';
 
 /**
  * u-modal 组件 props 类型定义
@@ -58,12 +59,12 @@ export const ModalProps = {
     /** 确认按钮颜色 */
     confirmColor: {
         type: String,
-        default: '#2979ff'
+        default: $u.color.primary
     },
     /** 取消文字颜色 */
     cancelColor: {
         type: String,
-        default: '#606266'
+        default: $u.color.contentColor
     },
     /** 圆角值 */
     borderRadius: {

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

@@ -88,7 +88,7 @@ import { ModalProps } from './types';
  * @property {String} confirm-text 确认按钮的文字内容（默认"确认"）
  * @property {String} cancel-text 取消按钮的文字内容（默认"取消"）
  * @property {String} cancel-color 取消按钮的颜色（默认"#606266"）
- * @property {String} confirm-color 确认按钮的文字内容（默认"#2979ff"）
+ * @property {String} confirm-color 确认按钮的文字内容（默认主题色primary）
  * @property {String | Number} border-radius 模态框圆角值，单位rpx（默认16）
  * @property {Object} title-style 自定义标题样式，对象形式
  * @property {Object} content-style 自定义内容样式，对象形式

package/components/u-picker/types.ts

@@ -1,5 +1,6 @@
 import type { ExtractPropTypes, PropType } from 'vue';
 import type { PickerMode, PickerParams } from '../../types/global';
+import { $u } from '../../';
 
 const defaultParams: PickerParams = {
     year: true,
@@ -33,6 +34,11 @@ export const PickerProps = {
         type: Array as PropType<any[]>,
         default: () => [0]
     },
+    /** 是否保留用户上次确认的选择（true：优先使用已保存选择；false：优先使用外部传入的 defaultSelector/defaultTime/defaultRegion） */
+    preserveSelection: {
+        type: Boolean,
+        default: true
+    },
     /** 当 range 是一个 Array<Object> 时，通过 range-key 来指定 Object 中 key 的值作为选择器显示内容 */
     rangeKey: {
         type: String,
@@ -56,12 +62,12 @@ export const PickerProps = {
     /** "取消"按钮的颜色 */
     cancelColor: {
         type: String,
-        default: '#606266'
+        default: $u.color.contentColor
     },
     /** "确定"按钮的颜色 */
     confirmColor: {
         type: String,
-        default: '#2979ff'
+        default: $u.color.primary
     },
     /** 默认显示的时间，2025-07-02 || 2025-07-02 13:01:00 || 2025/07/02 */
     defaultTime: {