sard-uniapp 1.29.3 → 1.30.0

package/CHANGELOG.md

@@ -1,4 +1,18 @@
 
+## 1.30.0 (2026-05-02)
+
+* Features: 允许在开关里面展示文字 ([55b9f23](https://github.com/sutras/sard-uniapp/commit/55b9f23))
+* Features: 新增 KeyboardPopout 组件 ([ff5707a](https://github.com/sutras/sard-uniapp/commit/ff5707a))
+* Features: 新增 map-label 属性 ([726f9e4](https://github.com/sutras/sard-uniapp/commit/726f9e4))
+* Features: 新增 swipe-action-group 组件 ([7bbeda3](https://github.com/sutras/sard-uniapp/commit/7bbeda3))
+* Features: 新增 swiper 组件 ([774ddd4](https://github.com/sutras/sard-uniapp/commit/774ddd4))
+* Features: 新增 variant 属性 ([d191638](https://github.com/sutras/sard-uniapp/commit/d191638))
+* Bug Fixes: 修复按钮细边框薄厚不一致问题 ([1e7f9fb](https://github.com/sutras/sard-uniapp/commit/1e7f9fb))
+
+## <small>1.29.4 (2026-04-27)</small>
+
+* Bug Fixes: 修复动态加载数据时不生成nav的问题 ([d1cdaf1](https://github.com/sutras/sard-uniapp/commit/d1cdaf1))
+
 ## <small>1.29.3 (2026-04-13)</small>
 
 * Bug Fixes: 修复textarea-base导入问题 ([fa9e57f](https://github.com/sutras/sard-uniapp/commit/fa9e57f))

package/README.md

@@ -28,7 +28,7 @@
 
 ## 特性
 
-- 🧩 115+个高质量组件，覆盖移动端主流场景
+- 🧩 117+个高质量组件，覆盖移动端主流场景
 - 💪 支持一套代码同时开发 H5 / 小程序 / App
 - 🌿 支持按需引入和 `Tree Shaking`
 - 📖 详尽的文档和案例展示

package/components/button/index.scss

@@ -124,8 +124,6 @@
   @include m(outline) {
     &::after {
       display: flex;
-      // 强化细边框渲染
-      will-change: transform;
     }
   }
 

package/components/calendar-input/calendar-input.d.ts

@@ -12,6 +12,7 @@ declare const __VLS_component: import("vue").DefineComponent<CalendarInputProps,
     rootClass: string;
     modelValue: Date | Date[] | string | string[];
     visible: boolean;
+    showCancel: boolean;
     type: CalendarType;
     max: Date;
     disabled: boolean;

package/components/calendar-input/calendar-input.vue

@@ -110,6 +110,7 @@ export default  _defineComponent({
     resettable: { type: Boolean, required: false },
     validateEvent: { type: Boolean, required: false },
     showConfirm: { type: Boolean, required: false },
+    showCancel: { type: Boolean, required: false },
     rootStyle: { type: null, required: false },
     rootClass: { type: String, required: false },
     type: { type: String, required: false },

package/components/calendar-popout/calendar-popout.d.ts

@@ -14,6 +14,7 @@ declare const __VLS_component: import("vue").DefineComponent<CalendarPopoutProps
     rootClass: string;
     modelValue: Date | Date[] | string | string[];
     visible: boolean;
+    showCancel: boolean;
     type: import("../calendar/common.js").CalendarType;
     max: Date;
     min: Date;

package/components/calendar-popout/calendar-popout.vue

@@ -94,6 +94,7 @@ export default  _defineComponent({
     resettable: { type: Boolean, required: false },
     validateEvent: { type: Boolean, required: false },
     showConfirm: { type: Boolean, required: false },
+    showCancel: { type: Boolean, required: false },
     rootStyle: { type: null, required: false },
     rootClass: { type: String, required: false },
     type: { type: String, required: false },

package/components/cascader-input/cascader-input.d.ts

@@ -13,6 +13,7 @@ declare const __VLS_component: import("vue").DefineComponent<CascaderInputProps,
     rootClass: string;
     modelValue: CascaderValue;
     visible: boolean;
+    showCancel: boolean;
     disabled: boolean;
     loading: boolean;
     readonly: boolean;

package/components/cascader-input/cascader-input.vue

@@ -118,6 +118,7 @@ export default  _defineComponent({
     resettable: { type: Boolean, required: false },
     validateEvent: { type: Boolean, required: false },
     showConfirm: { type: Boolean, required: false },
+    showCancel: { type: Boolean, required: false },
     rootStyle: { type: null, required: false },
     rootClass: { type: String, required: false },
     modelValue: { type: [String, Number, Array], required: false },

package/components/cascader-popout/cascader-popout.d.ts

@@ -12,6 +12,7 @@ declare const __VLS_component: import("vue").DefineComponent<CascaderPopoutProps
     rootClass: string;
     modelValue: import("../cascader/common.js").CascaderValue;
     visible: boolean;
+    showCancel: boolean;
     title: string;
     popoutClass: string;
     popoutStyle: string | false | import("vue").CSSProperties | import("vue").StyleValue[] | null;

package/components/cascader-popout/cascader-popout.vue

@@ -89,6 +89,7 @@ export default  _defineComponent({
     resettable: { type: Boolean, required: false },
     validateEvent: { type: Boolean, required: false },
     showConfirm: { type: Boolean, required: false },
+    showCancel: { type: Boolean, required: false },
     rootStyle: { type: null, required: false },
     rootClass: { type: String, required: false },
     modelValue: { type: [String, Number, Array], required: false },

package/components/checkbox-input/checkbox-input.d.ts

@@ -12,6 +12,7 @@ declare const __VLS_component: import("vue").DefineComponent<CheckboxInputProps,
     modelValue: any[];
     size: string;
     visible: boolean;
+    showCancel: boolean;
     type: import("../checkbox/common.js").IconType;
     disabled: boolean;
     loading: boolean;

package/components/checkbox-input/checkbox-input.vue

@@ -106,6 +106,7 @@ export default  _defineComponent({
     resettable: { type: Boolean, required: false },
     validateEvent: { type: Boolean, required: false },
     showConfirm: { type: Boolean, required: false },
+    showCancel: { type: Boolean, required: false },
     rootStyle: { type: null, required: false },
     rootClass: { type: String, required: false },
     modelValue: { type: Array, required: false },

package/components/checkbox-input/common.d.ts

@@ -19,6 +19,7 @@ export declare const defaultCheckboxInputProps: () => {
         resettable: boolean;
         validateEvent: boolean;
         showConfirm: boolean;
+        showCancel: boolean;
         rootStyle: import("vue").StyleValue;
         rootClass: string;
         modelValue: any[];
@@ -54,6 +55,7 @@ export declare const defaultCheckboxInputProps: () => {
         resettable: boolean;
         validateEvent: boolean;
         showConfirm: boolean;
+        showCancel: boolean;
         rootStyle: import("vue").StyleValue;
         rootClass: string;
         modelValue: any[];
@@ -89,6 +91,7 @@ export declare const defaultCheckboxInputProps: () => {
         resettable: boolean;
         validateEvent: boolean;
         showConfirm: boolean;
+        showCancel: boolean;
         rootStyle: import("vue").StyleValue;
         rootClass: string;
         modelValue: any[];
@@ -124,6 +127,7 @@ export declare const defaultCheckboxInputProps: () => {
         resettable: boolean;
         validateEvent: boolean;
         showConfirm: boolean;
+        showCancel: boolean;
         rootStyle: import("vue").StyleValue;
         rootClass: string;
         modelValue: any[];
@@ -159,6 +163,7 @@ export declare const defaultCheckboxInputProps: () => {
         resettable: boolean;
         validateEvent: boolean;
         showConfirm: boolean;
+        showCancel: boolean;
         rootStyle: import("vue").StyleValue;
         rootClass: string;
         modelValue: any[];
@@ -194,6 +199,7 @@ export declare const defaultCheckboxInputProps: () => {
         resettable: boolean;
         validateEvent: boolean;
         showConfirm: boolean;
+        showCancel: boolean;
         rootStyle: import("vue").StyleValue;
         rootClass: string;
         modelValue: any[];
@@ -229,6 +235,7 @@ export declare const defaultCheckboxInputProps: () => {
         resettable: boolean;
         validateEvent: boolean;
         showConfirm: boolean;
+        showCancel: boolean;
         rootStyle: import("vue").StyleValue;
         rootClass: string;
         modelValue: any[];
@@ -264,6 +271,7 @@ export declare const defaultCheckboxInputProps: () => {
         resettable: boolean;
         validateEvent: boolean;
         showConfirm: boolean;
+        showCancel: boolean;
         rootStyle: import("vue").StyleValue;
         rootClass: string;
         modelValue: any[];
@@ -299,6 +307,7 @@ export declare const defaultCheckboxInputProps: () => {
         resettable: boolean;
         validateEvent: boolean;
         showConfirm: boolean;
+        showCancel: boolean;
         rootStyle: import("vue").StyleValue;
         rootClass: string;
         modelValue: any[];
@@ -334,6 +343,7 @@ export declare const defaultCheckboxInputProps: () => {
         resettable: boolean;
         validateEvent: boolean;
         showConfirm: boolean;
+        showCancel: boolean;
         rootStyle: import("vue").StyleValue;
         rootClass: string;
         modelValue: any[];
@@ -369,6 +379,7 @@ export declare const defaultCheckboxInputProps: () => {
         resettable: boolean;
         validateEvent: boolean;
         showConfirm: boolean;
+        showCancel: boolean;
         rootStyle: import("vue").StyleValue;
         rootClass: string;
         modelValue: any[];
@@ -404,6 +415,43 @@ export declare const defaultCheckboxInputProps: () => {
         resettable: boolean;
         validateEvent: boolean;
         showConfirm: boolean;
+        showCancel: boolean;
+        rootStyle: import("vue").StyleValue;
+        rootClass: string;
+        modelValue: any[];
+        disabled: boolean;
+        readonly: boolean;
+        size: string;
+        type: import("../checkbox/common").IconType;
+        checkedColor: string;
+        direction: "horizontal" | "vertical";
+        options: CheckboxGroupOption[];
+        optionKeys: import("../..").OptionKeys;
+        loading: boolean;
+        placeholder: string;
+        clearable: boolean;
+        internalPrepend: number;
+        multiline: boolean;
+        arrow: string;
+        arrowFamily: string;
+        internalAppend: number;
+        internalArrow: number;
+        inputProps: import("../input").InputProps;
+    }) => boolean) | undefined;
+    showCancel?: boolean | ((props: {
+        valueOnClear: () => any;
+        searchable: boolean;
+        filterPlaceholder: string;
+        showCheckAll: boolean;
+        iconPosition: "left" | "right";
+        visible: boolean;
+        title: string;
+        popoutClass: string;
+        popoutStyle: import("vue").StyleValue;
+        resettable: boolean;
+        validateEvent: boolean;
+        showConfirm: boolean;
+        showCancel: boolean;
         rootStyle: import("vue").StyleValue;
         rootClass: string;
         modelValue: any[];
@@ -439,6 +487,7 @@ export declare const defaultCheckboxInputProps: () => {
         resettable: boolean;
         validateEvent: boolean;
         showConfirm: boolean;
+        showCancel: boolean;
         rootStyle: import("vue").StyleValue;
         rootClass: string;
         modelValue: any[];
@@ -474,6 +523,7 @@ export declare const defaultCheckboxInputProps: () => {
         resettable: boolean;
         validateEvent: boolean;
         showConfirm: boolean;
+        showCancel: boolean;
         rootStyle: import("vue").StyleValue;
         rootClass: string;
         modelValue: any[];
@@ -509,6 +559,7 @@ export declare const defaultCheckboxInputProps: () => {
         resettable: boolean;
         validateEvent: boolean;
         showConfirm: boolean;
+        showCancel: boolean;
         rootStyle: import("vue").StyleValue;
         rootClass: string;
         modelValue: any[];
@@ -544,6 +595,7 @@ export declare const defaultCheckboxInputProps: () => {
         resettable: boolean;
         validateEvent: boolean;
         showConfirm: boolean;
+        showCancel: boolean;
         rootStyle: import("vue").StyleValue;
         rootClass: string;
         modelValue: any[];
@@ -579,6 +631,7 @@ export declare const defaultCheckboxInputProps: () => {
         resettable: boolean;
         validateEvent: boolean;
         showConfirm: boolean;
+        showCancel: boolean;
         rootStyle: import("vue").StyleValue;
         rootClass: string;
         modelValue: any[];
@@ -614,6 +667,7 @@ export declare const defaultCheckboxInputProps: () => {
         resettable: boolean;
         validateEvent: boolean;
         showConfirm: boolean;
+        showCancel: boolean;
         rootStyle: import("vue").StyleValue;
         rootClass: string;
         modelValue: any[];
@@ -649,6 +703,7 @@ export declare const defaultCheckboxInputProps: () => {
         resettable: boolean;
         validateEvent: boolean;
         showConfirm: boolean;
+        showCancel: boolean;
         rootStyle: import("vue").StyleValue;
         rootClass: string;
         modelValue: any[];
@@ -684,6 +739,7 @@ export declare const defaultCheckboxInputProps: () => {
         resettable: boolean;
         validateEvent: boolean;
         showConfirm: boolean;
+        showCancel: boolean;
         rootStyle: import("vue").StyleValue;
         rootClass: string;
         modelValue: any[];
@@ -719,6 +775,7 @@ export declare const defaultCheckboxInputProps: () => {
         resettable: boolean;
         validateEvent: boolean;
         showConfirm: boolean;
+        showCancel: boolean;
         rootStyle: import("vue").StyleValue;
         rootClass: string;
         modelValue: any[];
@@ -754,6 +811,7 @@ export declare const defaultCheckboxInputProps: () => {
         resettable: boolean;
         validateEvent: boolean;
         showConfirm: boolean;
+        showCancel: boolean;
         rootStyle: import("vue").StyleValue;
         rootClass: string;
         modelValue: any[];
@@ -789,6 +847,7 @@ export declare const defaultCheckboxInputProps: () => {
         resettable: boolean;
         validateEvent: boolean;
         showConfirm: boolean;
+        showCancel: boolean;
         rootStyle: import("vue").StyleValue;
         rootClass: string;
         modelValue: any[];
@@ -824,6 +883,7 @@ export declare const defaultCheckboxInputProps: () => {
         resettable: boolean;
         validateEvent: boolean;
         showConfirm: boolean;
+        showCancel: boolean;
         rootStyle: import("vue").StyleValue;
         rootClass: string;
         modelValue: any[];
@@ -859,6 +919,7 @@ export declare const defaultCheckboxInputProps: () => {
         resettable: boolean;
         validateEvent: boolean;
         showConfirm: boolean;
+        showCancel: boolean;
         rootStyle: import("vue").StyleValue;
         rootClass: string;
         modelValue: any[];
@@ -894,6 +955,7 @@ export declare const defaultCheckboxInputProps: () => {
         resettable: boolean;
         validateEvent: boolean;
         showConfirm: boolean;
+        showCancel: boolean;
         rootStyle: import("vue").StyleValue;
         rootClass: string;
         modelValue: any[];
@@ -929,6 +991,7 @@ export declare const defaultCheckboxInputProps: () => {
         resettable: boolean;
         validateEvent: boolean;
         showConfirm: boolean;
+        showCancel: boolean;
         rootStyle: import("vue").StyleValue;
         rootClass: string;
         modelValue: any[];
@@ -964,6 +1027,7 @@ export declare const defaultCheckboxInputProps: () => {
         resettable: boolean;
         validateEvent: boolean;
         showConfirm: boolean;
+        showCancel: boolean;
         rootStyle: import("vue").StyleValue;
         rootClass: string;
         modelValue: any[];
@@ -999,6 +1063,7 @@ export declare const defaultCheckboxInputProps: () => {
         resettable: boolean;
         validateEvent: boolean;
         showConfirm: boolean;
+        showCancel: boolean;
         rootStyle: import("vue").StyleValue;
         rootClass: string;
         modelValue: any[];
@@ -1034,6 +1099,7 @@ export declare const defaultCheckboxInputProps: () => {
         resettable: boolean;
         validateEvent: boolean;
         showConfirm: boolean;
+        showCancel: boolean;
         rootStyle: import("vue").StyleValue;
         rootClass: string;
         modelValue: any[];
@@ -1069,6 +1135,7 @@ export declare const defaultCheckboxInputProps: () => {
         resettable: boolean;
         validateEvent: boolean;
         showConfirm: boolean;
+        showCancel: boolean;
         rootStyle: import("vue").StyleValue;
         rootClass: string;
         modelValue: any[];
@@ -1104,6 +1171,7 @@ export declare const defaultCheckboxInputProps: () => {
         resettable: boolean;
         validateEvent: boolean;
         showConfirm: boolean;
+        showCancel: boolean;
         rootStyle: import("vue").StyleValue;
         rootClass: string;
         modelValue: any[];
@@ -1139,6 +1207,7 @@ export declare const defaultCheckboxInputProps: () => {
         resettable: boolean;
         validateEvent: boolean;
         showConfirm: boolean;
+        showCancel: boolean;
         rootStyle: import("vue").StyleValue;
         rootClass: string;
         modelValue: any[];

package/components/checkbox-popout/checkbox-popout.d.ts

@@ -12,6 +12,7 @@ declare const __VLS_component: import("vue").DefineComponent<CheckboxPopoutProps
     modelValue: any[];
     size: string;
     visible: boolean;
+    showCancel: boolean;
     type: import("../checkbox/common.js").IconType;
     disabled: boolean;
     direction: "horizontal" | "vertical";

package/components/checkbox-popout/checkbox-popout.vue

@@ -171,6 +171,7 @@ export default  _defineComponent({
     resettable: { type: Boolean, required: false },
     validateEvent: { type: Boolean, required: false },
     showConfirm: { type: Boolean, required: false },
+    showCancel: { type: Boolean, required: false },
     rootStyle: { type: null, required: false },
     rootClass: { type: String, required: false },
     modelValue: { type: Array, required: false },

package/components/color-picker-input/color-picker-input.d.ts

@@ -11,6 +11,7 @@ declare const __VLS_component: import("vue").DefineComponent<ColorPickerInputPro
     rootClass: string;
     modelValue: string;
     visible: boolean;
+    showCancel: boolean;
     format: import("../../utils").ColorFormat;
     disabled: boolean;
     loading: boolean;

package/components/color-picker-input/color-picker-input.vue

@@ -94,6 +94,7 @@ export default  _defineComponent({
     resettable: { type: Boolean, required: false },
     validateEvent: { type: Boolean, required: false },
     showConfirm: { type: Boolean, required: false },
+    showCancel: { type: Boolean, required: false },
     rootStyle: { type: null, required: false },
     rootClass: { type: String, required: false },
     modelValue: { type: String, required: false },

package/components/color-picker-popout/color-picker-popout.d.ts

@@ -11,6 +11,7 @@ declare const __VLS_component: import("vue").DefineComponent<ColorPickerPopoutPr
     rootClass: string;
     modelValue: string;
     visible: boolean;
+    showCancel: boolean;
     format: import("../../utils").ColorFormat;
     disabled: boolean;
     readonly: boolean;

package/components/color-picker-popout/color-picker-popout.vue

@@ -69,6 +69,7 @@ export default  _defineComponent({
     resettable: { type: Boolean, required: false },
     validateEvent: { type: Boolean, required: false },
     showConfirm: { type: Boolean, required: false },
+    showCancel: { type: Boolean, required: false },
     rootStyle: { type: null, required: false },
     rootClass: { type: String, required: false },
     modelValue: { type: String, required: false },

package/components/config/index.d.ts

@@ -50,6 +50,7 @@ import { type ImageProps } from '../image';
 import { type IndexesProps } from '../indexes';
 import { type InputProps } from '../input';
 import { type KeyboardProps } from '../keyboard';
+import { type KeyboardPopoutProps } from '../keyboard-popout';
 import { type ListItemProps } from '../list';
 import { type LoadingProps } from '../loading';
 import { type MarqueeProps } from '../marquee';
@@ -93,6 +94,8 @@ import { type SpaceProps } from '../space';
 import { type StatusBarProps } from '../status-bar';
 import { type StepperProps } from '../stepper';
 import { type StepsProps } from '../steps';
+import { type SwipeActionGroupProps } from '../swipe-action-group';
+import { type SwiperProps } from '../swiper';
 import { type SwiperDotProps } from '../swiper-dot';
 import { type SwitchProps } from '../switch';
 import { type TabbarProps } from '../tabbar';
@@ -171,6 +174,7 @@ export interface ConfigOptions {
     indexes?: InferDefaults<LooseRequired<IndexesProps>>;
     input?: InferDefaults<LooseRequired<InputProps>>;
     keyboard?: InferDefaults<LooseRequired<KeyboardProps>>;
+    keyboardPopout?: InferDefaults<LooseRequired<KeyboardPopoutProps>>;
     listItem?: InferDefaults<LooseRequired<ListItemProps>>;
     loading?: InferDefaults<LooseRequired<LoadingProps>>;
     marquee?: InferDefaults<LooseRequired<MarqueeProps>>;
@@ -214,6 +218,8 @@ export interface ConfigOptions {
     statusBar?: InferDefaults<LooseRequired<StatusBarProps>>;
     stepper?: InferDefaults<LooseRequired<StepperProps>>;
     steps?: InferDefaults<LooseRequired<StepsProps>>;
+    swipeActionGroup?: InferDefaults<LooseRequired<SwipeActionGroupProps>>;
+    swiper?: InferDefaults<LooseRequired<SwiperProps>>;
     swiperDot?: InferDefaults<LooseRequired<SwiperDotProps>>;
     switch?: InferDefaults<LooseRequired<SwitchProps>>;
     tabbar?: InferDefaults<LooseRequired<TabbarProps>>;

package/components/datetime-picker-input/datetime-picker-input.d.ts

@@ -12,6 +12,7 @@ declare const __VLS_component: import("vue").DefineComponent<DatetimePickerInput
     rootClass: string;
     modelValue: Date | string;
     visible: boolean;
+    showCancel: boolean;
     type: string;
     max: Date | string;
     disabled: boolean;

package/components/datetime-picker-input/datetime-picker-input.vue

@@ -102,6 +102,7 @@ export default  _defineComponent({
     resettable: { type: Boolean, required: false },
     validateEvent: { type: Boolean, required: false },
     showConfirm: { type: Boolean, required: false },
+    showCancel: { type: Boolean, required: false },
     rootStyle: { type: null, required: false },
     rootClass: { type: String, required: false },
     type: { type: String, required: false },

package/components/datetime-picker-popout/datetime-picker-popout.d.ts

@@ -12,6 +12,7 @@ declare const __VLS_component: import("vue").DefineComponent<DatetimePickerPopou
     rootClass: string;
     modelValue: Date | string;
     visible: boolean;
+    showCancel: boolean;
     type: string;
     max: Date | string;
     min: Date | string;

package/components/datetime-picker-popout/datetime-picker-popout.vue

@@ -85,6 +85,7 @@ export default  _defineComponent({
     resettable: { type: Boolean, required: false },
     validateEvent: { type: Boolean, required: false },
     showConfirm: { type: Boolean, required: false },
+    showCancel: { type: Boolean, required: false },
     rootStyle: { type: null, required: false },
     rootClass: { type: String, required: false },
     type: { type: String, required: false },

package/components/datetime-range-picker-input/datetime-range-picker-input.d.ts

@@ -12,6 +12,7 @@ declare const __VLS_component: import("vue").DefineComponent<DatetimeRangePicker
     rootClass: string;
     modelValue: (Date | string)[];
     visible: boolean;
+    showCancel: boolean;
     type: string;
     max: Date | string;
     disabled: boolean;

package/components/datetime-range-picker-input/datetime-range-picker-input.vue

@@ -111,6 +111,7 @@ export default  _defineComponent({
     resettable: { type: Boolean, required: false },
     validateEvent: { type: Boolean, required: false },
     showConfirm: { type: Boolean, required: false },
+    showCancel: { type: Boolean, required: false },
     modelValue: { type: Array, required: false },
     tabs: { type: Array, required: false },
     rootStyle: { type: null, required: false },

package/components/datetime-range-picker-popout/datetime-range-picker-popout.d.ts

@@ -12,6 +12,7 @@ declare const __VLS_component: import("vue").DefineComponent<DatetimeRangePicker
     rootClass: string;
     modelValue: (Date | string)[];
     visible: boolean;
+    showCancel: boolean;
     type: string;
     max: Date | string;
     min: Date | string;

package/components/datetime-range-picker-popout/datetime-range-picker-popout.vue

@@ -93,6 +93,7 @@ export default  _defineComponent({
     resettable: { type: Boolean, required: false },
     validateEvent: { type: Boolean, required: false },
     showConfirm: { type: Boolean, required: false },
+    showCancel: { type: Boolean, required: false },
     modelValue: { type: Array, required: false },
     tabs: { type: Array, required: false },
     rootStyle: { type: null, required: false },

package/components/keyboard/README.md

@@ -50,12 +50,13 @@ import Keyboard from 'sard-uniapp/components/keyboard/keyboard.vue'
 
 ### KeyboardProps
 
-| 属性                              | 描述                | 类型                                                   | 默认值    |
-| --------------------------------- | ------------------- | ------------------------------------------------------ | --------- |
-| root-class                        | 组件根元素类名      | string                                                 | -         |
-| root-style                        | 组件根元素样式      | StyleValue                                             | -         |
-| type                              | 键盘类型            | 'number' \| 'digit' \| 'idcard' \| 'random' \| 'plate' | 'number'  |
-| mode (v-model) <sup>1.24.1+</sup> | 'plate'键盘时的模式 | 'chinese' \| 'english'                                 | 'chinese' |
+| 属性                              | 描述                | 类型                                                     | 默认值      |
+| --------------------------------- | ------------------- | -------------------------------------------------------- | ----------- |
+| root-class                        | 组件根元素类名      | `string`                                                 | -           |
+| root-style                        | 组件根元素样式      | `StyleValue`                                             | -           |
+| type                              | 键盘类型            | `'number' \| 'digit' \| 'idcard' \| 'random' \| 'plate'` | `'number'`  |
+| mode (v-model) <sup>1.24.1+</sup> | 'plate'键盘时的模式 | `'chinese' \| 'english'`                                 | `'chinese'` |
+| disabled-key <sup>1.30+</sup>     | 禁用按键的回调函数  | `(key: string) => boolean`                               | -           |
 
 ### KeyboardEmits
 
@@ -68,10 +69,10 @@ import Keyboard from 'sard-uniapp/components/keyboard/keyboard.vue'
 
 ### KeyBoardExpose
 
-| 属性                     | 描述                                 | 类型                                     |
-| ------------------------ | ------------------------------------ | ---------------------------------------- |
-| shuffle                  | 重新打乱随机键盘按键                 | `() => void`                             |
-| toggle<sup>1.23.6+</sup> | 切换车牌号的中英文按键，可选传入mode | `(mode?: 'chinese'\| 'english') => void` |
+| 属性                      | 描述                                 | 类型                                     |
+| ------------------------- | ------------------------------------ | ---------------------------------------- |
+| shuffle                   | 重新打乱随机键盘按键                 | `() => void`                             |
+| toggle <sup>1.23.6+</sup> | 切换车牌号的中英文按键，可选传入mode | `(mode?: 'chinese'\| 'english') => void` |
 
 ## 主题定制
 

package/components/keyboard/common.d.ts

@@ -5,6 +5,7 @@ export interface KeyboardProps {
     rootClass?: string;
     type?: 'number' | 'digit' | 'idcard' | 'random' | 'plate';
     mode?: KeyboardPlateMode;
+    disabledKey?: (key: string) => boolean;
 }
 export declare const defaultKeyboardProps: () => DefaultProps<KeyboardProps>;
 export interface KeyboardSlots {
@@ -21,6 +22,9 @@ export interface KeyBoardExpose {
     shuffle: () => void;
     toggle: (mode?: KeyboardPlateMode) => void;
 }
+export declare const plateProvinceKeys: string[];
+export declare const plateSuffixKeys: string[];
+export declare const plateEnglishLetterKeys: string[];
 export declare const numberKeys: string[];
 export declare const digitKeys: string[];
 export declare const idcardKeys: string[];