sard-uniapp 1.22.2 → 1.23.1

package/CHANGELOG.md

@@ -1,3 +1,23 @@
+## [1.23.1](https://github.com/sutras/sard-uniapp/compare/v1.23.0...v1.23.1) (2025-07-28)
+
+
+### Bug Fixes
+
+* 修复 rate 清空问题 ([ac43638](https://github.com/sutras/sard-uniapp/commit/ac43638b3802d759221df5b65cb36c71c21a50ef))
+
+
+
+# [1.23.0](https://github.com/sutras/sard-uniapp/compare/v1.22.2...v1.23.0) (2025-07-26)
+
+
+### Features
+
+* cascader 新增 allLevels 属性 ([d40fc98](https://github.com/sutras/sard-uniapp/commit/d40fc98100553b8ffdbd035640107062433dc33e))
+* crop-image 组件新增 cancel 回调 ([572991f](https://github.com/sutras/sard-uniapp/commit/572991f199c2c10b0a8b50c63356297fad33d715))
+* 新增 FormPlain, FormItemPlain 组件 ([95c6721](https://github.com/sutras/sard-uniapp/commit/95c67215f69c5f5a8f3aec370e53a3b99031232e))
+
+
+
 ## [1.22.2](https://github.com/sutras/sard-uniapp/compare/v1.22.1...v1.22.2) (2025-07-24)
 
 

package/components/cascader/README.md

@@ -47,20 +47,27 @@ import { Cascader } from 'sard'
 
 @code('${DEMO_PATH}/cascader/demo/Disabled.vue')
 
+### 绑定所有级别的值 <sup>1.23+</sup>
+
+如果要绑定所有级别的值，即绑定数组值，而不单单是最后一级，可以使用 `all-levels` 属性。
+
+@code('${DEMO_PATH}/cascader/demo/AllLevels.vue')
+
 ## API
 
 ### CascaderProps
 
-| 属性                              | 描述                      | 类型                               | 默认值           |
-| --------------------------------- | ------------------------- | ---------------------------------- | ---------------- |
-| root-class                        | 组件根元素类名            | string                             | -                |
-| root-style                        | 组件根元素样式            | StyleValue                         | -                |
-| model-value (v-model)             | 选中项的值                | string \| number                   | -                |
-| options                           | 可选项数据源              | CascaderOption[]                   | []               |
-| field-keys                        | 自定义 `options` 中的字段 | CascaderFieldKeys                  | defaultFieldKeys |
-| hint-text                         | 未选中时的提示文案        | string                             | '请选择'         |
-| label-render                      | 自定义可选项渲染          | (option: CascaderOption) => string | -                |
-| change-on-select <sup>1.14+</sup> | 点击每级选项都会触发变化  | boolean                            | false            |
+| 属性                              | 描述                                     | 类型                                     | 默认值           |
+| --------------------------------- | ---------------------------------------- | ---------------------------------------- | ---------------- |
+| root-class                        | 组件根元素类名                           | string                                   | -                |
+| root-style                        | 组件根元素样式                           | StyleValue                               | -                |
+| model-value (v-model)             | 选中项的值                               | string \| number \| (string \| number)[] | -                |
+| options                           | 可选项数据源                             | CascaderOption[]                         | []               |
+| field-keys                        | 自定义 `options` 中的字段                | CascaderFieldKeys                        | defaultFieldKeys |
+| hint-text                         | 未选中时的提示文案                       | string                                   | '请选择'         |
+| label-render                      | 自定义可选项渲染                         | (option: CascaderOption) => string       | -                |
+| change-on-select <sup>1.14+</sup> | 点击每级选项都会触发变化                 | boolean                                  | false            |
+| all-levels <sup>1.23+</sup>       | 是否绑定所有级别的值，而不单单是最后一级 | boolean                                  | false            |
 
 ### CascaderSlots
 
@@ -70,11 +77,11 @@ import { Cascader } from 'sard'
 
 ### CascaderEmits
 
-| 事件                     | 描述                   | 类型                                                                 |
-| ------------------------ | ---------------------- | -------------------------------------------------------------------- |
-| update:model-value       | 全部选项选择完成后触发 | (value: string \| number, selectedOptions: CascaderOption[]) => void |
-| change <sup>1.9.2+</sup> | 全部选项选择完成后触发 | (value: string \| number, selectedOptions: CascaderOption[]) => void |
-| select                   | 选中某一项时触发       | (option: CascaderOption, tabIndex: number) => void                   |
+| 事件                     | 描述                   | 类型                                                                                         |
+| ------------------------ | ---------------------- | -------------------------------------------------------------------------------------------- |
+| update:model-value       | 全部选项选择完成后触发 | (value: string \| number \| (string \| number)[], selectedOptions: CascaderOption[]) => void |
+| change <sup>1.9.2+</sup> | 全部选项选择完成后触发 | (value: string \| number \| (string \| number)[], selectedOptions: CascaderOption[]) => void |
+| select                   | 选中某一项时触发       | (option: CascaderOption, tabIndex: number) => void                                           |
 
 ### CascaderOption
 

package/components/cascader/cascader.d.ts

@@ -1,12 +1,12 @@
 import { type CascaderProps, type CascaderSlots, type CascaderOption } from './common';
 declare function __VLS_template(): Readonly<CascaderSlots> & CascaderSlots;
 declare const __VLS_component: import("vue").DefineComponent<CascaderProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
-    "update:model-value": (value: string | number, selectedOptions: any[]) => any;
-    change: (value: string | number, selectedOptions: any[]) => any;
+    "update:model-value": (value: string | number | (string | number)[], selectedOptions: any[]) => any;
+    change: (value: string | number | (string | number)[], selectedOptions: any[]) => any;
     select: (option: any, tabIndex: number) => any;
 }, string, import("vue").PublicProps, Readonly<CascaderProps> & Readonly<{
-    "onUpdate:model-value"?: ((value: string | number, selectedOptions: any[]) => any) | undefined;
-    onChange?: ((value: string | number, selectedOptions: any[]) => any) | undefined;
+    "onUpdate:model-value"?: ((value: string | number | (string | number)[], selectedOptions: any[]) => any) | undefined;
+    onChange?: ((value: string | number | (string | number)[], selectedOptions: any[]) => any) | undefined;
     onSelect?: ((option: any, tabIndex: number) => any) | undefined;
 }>, {
     options: CascaderOption[];

package/components/cascader/cascader.vue

@@ -1,28 +1,28 @@
 <template>
   <view :class="cascaderClass" :style="cascaderStyle">
-    <sar-tabs scrollable v-model:current="tabsCurrent" :list="tabsList" />
+    <sar-tabs scrollable v-model:current="currentTab" :list="tabList" />
 
-    <slot name="top" :tab-index="tabsCurrent"></slot>
+    <slot name="top" :tab-index="currentTab"></slot>
 
     <view :class="bem.e('container')">
       <view
         :class="bem.e('wrapper')"
         :style="
           stringifyStyle({
-            transform: `translateX(${-Number(tabsCurrent) * 100}%)`,
+            transform: `translateX(${-Number(currentTab) * 100}%)`,
             transitionDuration: renderedPane ? null : '0s',
           })
         "
       >
         <view
-          v-for="(tab, tabIndex) in tabs"
-          :key="tabIndex"
+          v-for="(panel, panelIndex) in panels"
+          :key="panelIndex"
           :class="bem.e('pane')"
         >
           <view :class="bem.e('options')">
             <scroll-view scroll-y trap-scroll :class="bem.e('scroll')">
               <view
-                v-for="(option, optionIndex) in tab.options"
+                v-for="(option, optionIndex) in panel.options"
                 :key="optionIndex"
                 :class="
                   classNames(
@@ -30,8 +30,8 @@
                     bem.em(
                       'option',
                       'selected',
-                      tab.selected &&
-                        tab.selected[mergedFieldKeys.value] ===
+                      panel.selected &&
+                        panel.selected[mergedFieldKeys.value] ===
                           option[mergedFieldKeys.value],
                     ),
                     bem.em(
@@ -41,7 +41,7 @@
                     ),
                   )
                 "
-                @click="onOptionClick(option, tabIndex)"
+                @click="onOptionClick(option, panelIndex)"
               >
                 <view :class="bem.e('option-label')">
                   {{
@@ -59,7 +59,7 @@
               :class="
                 classNames(
                   bem.e('loading-wrapper'),
-                  bem.em('loading-wrapper', 'show', tab.options.length === 0),
+                  bem.em('loading-wrapper', 'show', panel.options.length === 0),
                 )
               "
             >
@@ -81,7 +81,8 @@ import {
   classNames,
   stringifyStyle,
   createBem,
-  isEmptyBinding
+  isEmptyBinding,
+  isEmptyArray
 } from "../../utils";
 import { useTranslate } from "../locale";
 import SarTabs from "../tabs/tabs.vue";
@@ -95,14 +96,15 @@ import {
 /**
  * @property {string} rootClass 组件根元素类名，默认值：-。
  * @property {StyleValue} rootStyle 组件根元素样式，默认值：-。
- * @property {string | number} modelValue 选中项的值，默认值：-。
+ * @property {string | number | (string | number)[]} modelValue 选中项的值，默认值：-。
  * @property {CascaderOption[]} options 可选项数据源，默认值：[]。
  * @property {CascaderFieldKeys} fieldKeys 自定义 `options` 中的字段，默认值：defaultFieldKeys。
  * @property {string} hintText 未选中时的提示文案，默认值：'请选择'。
  * @property {(option: CascaderOption) => string} labelRender 自定义可选项渲染，默认值：-。
  * @property {boolean} changeOnSelect 点击每级选项都会触发变化，默认值：false。
- * @event {(value: string | number, selectedOptions: CascaderOption[]) => void} update 全部选项选择完成后触发
- * @event {(value: string | number, selectedOptions: CascaderOption[]) => void} change 全部选项选择完成后触发
+ * @property {boolean} allLevels 是否绑定所有级别的值，而不单单是最后一级，默认值：false。
+ * @event {(value: string | number | (string | number)[], selectedOptions: CascaderOption[]) => void} update 全部选项选择完成后触发
+ * @event {(value: string | number | (string | number)[], selectedOptions: CascaderOption[]) => void} change 全部选项选择完成后触发
  * @event {(option: CascaderOption, tabIndex: number) => void} select 选中某一项时触发
  */
 export default  _defineComponent({
@@ -121,12 +123,13 @@ export default  _defineComponent({
   props:  _mergeDefaults({
     rootStyle: { type: [Boolean, null, String, Object, Array], required: false, skipCheck: true },
     rootClass: { type: String, required: false },
-    modelValue: { type: [String, Number], required: false },
+    modelValue: { type: [String, Number, Array], required: false },
     options: { type: Array, required: false },
     fieldKeys: { type: Object, required: false },
     hintText: { type: String, required: false },
     labelRender: { type: Function, required: false },
-    changeOnSelect: { type: Boolean, required: false }
+    changeOnSelect: { type: Boolean, required: false },
+    allLevels: { type: Boolean, required: false }
   }, defaultCascaderProps),
   emits: ["update:model-value", "change", "select"],
   setup(__props, { expose: __expose, emit: __emit }) {
@@ -135,10 +138,10 @@ export default  _defineComponent({
     const emit = __emit;
     const bem = createBem("cascader");
     const { t } = useTranslate("cascader");
-    const updateTabs = () => {
-      let nextTabs;
-      if (isEmptyBinding(tempValue)) {
-        nextTabs = [
+    const updatePanels = () => {
+      let nextPanels;
+      if (isEmptyBinding(tempValue) || isEmptyArray(tempValue)) {
+        nextPanels = [
           {
             options: props.options || [],
             selected: null
@@ -150,24 +153,24 @@ export default  _defineComponent({
           tempValue,
           mergedFieldKeys.value
         );
-        if (selectedOptions) {
+        if (selectedOptions && selectedOptions.length > 0) {
           let nextOptions = props.options;
-          nextTabs = selectedOptions.map((option) => {
-            const tab = {
-              options: nextOptions,
+          nextPanels = selectedOptions.map((option) => {
+            const panel = {
+              options: nextOptions || [],
               selected: option
             };
             nextOptions = option[mergedFieldKeys.value.children];
-            return tab;
+            return panel;
           });
           if (nextOptions) {
-            nextTabs.push({
+            nextPanels.push({
               options: nextOptions,
               selected: null
             });
           }
         } else {
-          nextTabs = [
+          nextPanels = [
             {
               options: props.options || [],
               selected: null
@@ -175,47 +178,47 @@ export default  _defineComponent({
           ];
         }
       }
-      if (nextTabs) {
-        tabs.value = nextTabs;
-        tabsCurrent.value = nextTabs.length - 1;
-        if (!renderedPane.value) {
-          setTimeout(() => {
-            renderedPane.value = true;
-          }, 30);
-        }
+      panels.value = nextPanels;
+      currentTab.value = nextPanels.length - 1;
+      if (!renderedPane.value) {
+        setTimeout(() => {
+          renderedPane.value = true;
+        }, 30);
       }
     };
     const isLastOption = (option) => {
       return !Array.isArray(option[mergedFieldKeys.value.children]);
     };
-    const onOptionClick = (option, tabIndex) => {
+    const onOptionClick = (option, panelIndex) => {
       if (option.disabled) {
         return;
       }
-      let nextTabs = tabs.value.slice();
-      nextTabs[tabIndex].selected = option;
-      const selectBack = tabIndex < nextTabs.length - 1;
+      let nextPanels = panels.value.slice();
+      nextPanels[panelIndex].selected = option;
+      const selectBack = panelIndex < nextPanels.length - 1;
       if (selectBack) {
-        nextTabs = nextTabs.slice(0, tabIndex + 1);
+        nextPanels = nextPanels.slice(0, panelIndex + 1);
       }
       const isLast = isLastOption(option);
       if (!isLast) {
-        const nextTab = {
+        const nextPanel = {
           options: option[mergedFieldKeys.value.children],
           selected: null
         };
-        nextTabs.push(nextTab);
+        nextPanels.push(nextPanel);
+      }
+      currentTab.value = isLast ? panelIndex : nextPanels.length - 1;
+      if (props.allLevels) {
+        tempValue = nextPanels.map((panel) => panel.selected).filter(Boolean).map((option2) => option2[mergedFieldKeys.value.value]);
+      } else {
+        tempValue = option[mergedFieldKeys.value.value];
       }
-      tabsCurrent.value = isLast ? tabIndex : nextTabs.length - 1;
-      tempValue = option[mergedFieldKeys.value.value];
-      tabs.value = nextTabs;
-      emit("select", option, tabIndex);
+      panels.value = nextPanels;
+      emit("select", option, panelIndex);
       if (isLast || props.changeOnSelect) {
-        const nextValue = option[mergedFieldKeys.value.value];
-        innerValue.value = nextValue;
-        const selectedOptions = nextTabs.map((tab) => tab.selected).filter(Boolean);
-        emit("update:model-value", nextValue, selectedOptions);
-        emit("change", nextValue, selectedOptions);
+        const selectedOptions = nextPanels.map((panel) => panel.selected).filter(Boolean);
+        emit("update:model-value", tempValue, selectedOptions);
+        emit("change", tempValue, selectedOptions);
       }
     };
     const innerPaceholder = computed(() => {
@@ -228,39 +231,47 @@ export default  _defineComponent({
         props.fieldKeys
       );
     });
-    const innerValue = ref(props.modelValue);
-    let tempValue = innerValue.value;
-    const tabsCurrent = ref(0);
+    let tempValue = props.modelValue;
+    const currentTab = ref(0);
     const renderedPane = ref(false);
-    const tabs = ref([]);
-    const tabsList = computed(() => {
-      return tabs.value.map((tab) => {
-        const { selected } = tab;
-        const tabLabel = selected ? selected[mergedFieldKeys.value.label] : innerPaceholder.value;
+    const panels = ref([]);
+    const tabList = computed(() => {
+      return panels.value.map((panel) => {
+        const { selected } = panel;
+        const label = selected ? selected[mergedFieldKeys.value.label] : innerPaceholder.value;
         return {
-          title: tabLabel
+          title: label
         };
       });
     });
     watch(
       () => props.modelValue,
       () => {
-        innerValue.value = props.modelValue;
-        if (!isEmptyBinding(props.modelValue)) {
-          if (tabs.value.some(
-            (tab) => tab.selected?.[mergedFieldKeys.value.value] === props.modelValue
-          )) {
-            return;
+        if (Array.isArray(props.modelValue)) {
+          if (props.modelValue.length > 0) {
+            if (props.modelValue.every(
+              (item, index) => panels.value[index].selected?.[mergedFieldKeys.value.value] === item
+            )) {
+              return;
+            }
+          }
+        } else {
+          if (!isEmptyBinding(props.modelValue)) {
+            if (panels.value.some(
+              (panel) => panel.selected?.[mergedFieldKeys.value.value] === props.modelValue
+            )) {
+              return;
+            }
           }
         }
         tempValue = props.modelValue;
-        updateTabs();
+        updatePanels();
       }
     );
     watch(
       () => props.options,
       () => {
-        updateTabs();
+        updatePanels();
       },
       {
         immediate: true
@@ -272,11 +283,11 @@ export default  _defineComponent({
     const cascaderStyle = computed(() => {
       return stringifyStyle(props.rootStyle);
     });
-    const __returned__ = { props, emit, bem, t, updateTabs, isLastOption, onOptionClick, innerPaceholder, mergedFieldKeys, innerValue, get tempValue() {
+    const __returned__ = { props, emit, bem, t, updatePanels, isLastOption, onOptionClick, innerPaceholder, mergedFieldKeys, get tempValue() {
       return tempValue;
     }, set tempValue(v) {
       tempValue = v;
-    }, tabsCurrent, renderedPane, tabs, tabsList, cascaderClass, cascaderStyle, get classNames() {
+    }, currentTab, renderedPane, panels, tabList, cascaderClass, cascaderStyle, get classNames() {
       return classNames;
     }, get stringifyStyle() {
       return stringifyStyle;

package/components/cascader/common.d.ts

@@ -15,12 +15,13 @@ export interface CascaderOption {
 export interface CascaderProps {
     rootStyle?: StyleValue;
     rootClass?: string;
-    modelValue?: string | number;
+    modelValue?: string | number | (string | number)[];
     options?: CascaderOption[];
     fieldKeys?: CascaderFieldKeys;
     hintText?: string;
     labelRender?: (option: CascaderOption) => string;
     changeOnSelect?: boolean;
+    allLevels?: boolean;
 }
 export declare const defaultCascaderProps: {
     options: () => never[];
@@ -31,13 +32,13 @@ export interface CascaderSlots {
     }): any;
 }
 export interface CascaderEmits {
-    (e: 'update:model-value', value: string | number, selectedOptions: any[]): void;
-    (e: 'change', value: string | number, selectedOptions: any[]): void;
+    (e: 'update:model-value', value: string | number | (string | number)[], selectedOptions: any[]): void;
+    (e: 'change', value: string | number | (string | number)[], selectedOptions: any[]): void;
     (e: 'select', option: any, tabIndex: number): void;
 }
-export interface CascaderTab {
+export interface CascaderPanel {
     options: CascaderOption[];
     selected: CascaderOption | null;
 }
 export declare const defaultFieldKeys: CascaderFieldKeys;
-export declare function getSelectedOptionsByValue(options: CascaderOption[], value: string | number, fieldKeys: Required<CascaderFieldKeys>): CascaderOption[] | undefined;
+export declare function getSelectedOptionsByValue(options: CascaderOption[], value: string | number | (string | number)[], fieldKeys: Required<CascaderFieldKeys>): CascaderOption[] | undefined;

package/components/cascader/common.js

@@ -8,14 +8,30 @@ export const defaultFieldKeys = {
     children: 'children',
 };
 export function getSelectedOptionsByValue(options, value, fieldKeys) {
-    for (const option of options) {
-        if (option[fieldKeys.value] === value) {
-            return [option];
+    if (Array.isArray(value)) {
+        const selectedOptions = [];
+        let list = options;
+        for (const item of value) {
+            const option = list.find((option) => option[fieldKeys.value] === item);
+            if (!option)
+                break;
+            selectedOptions.push(option);
+            list = option[fieldKeys.children];
+            if (!Array.isArray(list))
+                break;
         }
-        if (Array.isArray(option[fieldKeys.children])) {
-            const selectedOptions = getSelectedOptionsByValue(option[fieldKeys.children], value, fieldKeys);
-            if (selectedOptions) {
-                return [option, ...selectedOptions];
+        return selectedOptions;
+    }
+    else {
+        for (const option of options) {
+            if (option[fieldKeys.value] === value) {
+                return [option];
+            }
+            if (Array.isArray(option[fieldKeys.children])) {
+                const selectedOptions = getSelectedOptionsByValue(option[fieldKeys.children], value, fieldKeys);
+                if (selectedOptions) {
+                    return [option, ...selectedOptions];
+                }
             }
         }
     }

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

@@ -58,12 +58,13 @@ import {
 /**
  * @property {string} rootClass 弹出式输入框根元素类名，默认值：-。
  * @property {StyleValue} rootStyle 弹出式输入框根元素样式，默认值：-。
- * @property {string | number} modelValue 选中项的值，默认值：-。
+ * @property {string | number | (string | number)[]} modelValue 选中项的值，默认值：-。
  * @property {CascaderOption[]} options 可选项数据源，默认值：[]。
  * @property {CascaderFieldKeys} fieldKeys 自定义 `options` 中的字段，默认值：defaultFieldKeys。
  * @property {string} hintText 未选中时的提示文案，默认值：'请选择'。
  * @property {(option: CascaderOption) => string} labelRender 自定义可选项渲染，默认值：-。
  * @property {boolean} changeOnSelect 点击每级选项都会触发变化，默认值：false。
+ * @property {boolean} allLevels 是否绑定所有级别的值，而不单单是最后一级，默认值：false。
  * @property {string} popoutClass 弹窗框根元素类名，默认值：-。
  * @property {StyleValue} popoutStyle 弹窗框根元素样式，默认值：-。
  * @property {boolean} visible 是否显示弹出框，默认值：-。
@@ -115,12 +116,13 @@ export default  _defineComponent({
     popoutStyle: { type: [Boolean, null, String, Object, Array], required: false, skipCheck: true },
     rootStyle: { type: [Boolean, null, String, Object, Array], required: false, skipCheck: true },
     rootClass: { type: String, required: false },
-    modelValue: { type: [String, Number], required: false },
+    modelValue: { type: [String, Number, Array], required: false },
     options: { type: Array, required: false },
     fieldKeys: { type: Object, required: false },
     hintText: { type: String, required: false },
     labelRender: { type: Function, required: false },
     changeOnSelect: { type: Boolean, required: false },
+    allLevels: { type: Boolean, required: false },
     placeholder: { type: String, required: false },
     readonly: { type: Boolean, required: false },
     disabled: { type: Boolean, required: false },

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

@@ -40,12 +40,13 @@ import { useFormPopout } from "../../use";
 /**
  * @property {string} rootClass 组件根元素类名，默认值：-。
  * @property {StyleValue} rootStyle 组件根元素样式，默认值：-。
- * @property {string | number} modelValue 选中项的值，默认值：-。
+ * @property {string | number | (string | number)[]} modelValue 选中项的值，默认值：-。
  * @property {CascaderOption[]} options 可选项数据源，默认值：[]。
  * @property {CascaderFieldKeys} fieldKeys 自定义 `options` 中的字段，默认值：defaultFieldKeys。
  * @property {string} hintText 未选中时的提示文案，默认值：'请选择'。
  * @property {(option: CascaderOption) => string} labelRender 自定义可选项渲染，默认值：-。
  * @property {boolean} changeOnSelect 点击每级选项都会触发变化，默认值：false。
+ * @property {boolean} allLevels 是否绑定所有级别的值，而不单单是最后一级，默认值：false。
  * @property {string} popoutClass 弹窗框根元素类名，默认值：-。
  * @property {StyleValue} popoutStyle 弹窗框根元素样式，默认值：-。
  * @property {boolean} visible 是否显示弹出框，默认值：-。
@@ -87,12 +88,13 @@ export default  _defineComponent({
     popoutStyle: { type: [Boolean, null, String, Object, Array], required: false, skipCheck: true },
     rootStyle: { type: [Boolean, null, String, Object, Array], required: false, skipCheck: true },
     rootClass: { type: String, required: false },
-    modelValue: { type: [String, Number], required: false },
+    modelValue: { type: [String, Number, Array], required: false },
     options: { type: Array, required: false },
     fieldKeys: { type: Object, required: false },
     hintText: { type: String, required: false },
     labelRender: { type: Function, required: false },
-    changeOnSelect: { type: Boolean, required: false }
+    changeOnSelect: { type: Boolean, required: false },
+    allLevels: { type: Boolean, required: false }
   }, defaultCascaderPopoutProps),
   emits: ["update:visible", "update:model-value", "change", "select", "confirm", "before-enter", "enter", "after-enter", "enter-cancelled", "before-leave", "leave", "after-leave", "leave-cancelled", "visible-hook"],
   setup(__props, { expose: __expose, emit: __emit }) {

package/components/config/index.d.ts

@@ -9,6 +9,7 @@ import { type CheckboxInputProps } from '../checkbox-input';
 import { type DatetimePickerInputProps } from '../datetime-picker-input';
 import { type DatetimeRangePickerInputProps } from '../datetime-range-picker-input';
 import { type DialogProps } from '../dialog';
+import { type DividerProps } from '../divider';
 import { type DropdownProps } from '../dropdown';
 import { type FloatingBubbleProps } from '../floating-bubble';
 import { type FormProps } from '../form';
@@ -42,7 +43,6 @@ import { type TagProps } from '../tag';
 import { type ToastProps } from '../toast';
 import { type TreeProps } from '../tree';
 import { type UploadPreviewProps, type UploadProps } from '../upload';
-import { type DividerProps } from '../divider';
 type DeepPartial<T> = {
     [P in keyof T]?: T[P] extends Record<any, any> ? DeepPartial<T[P]> : T[P];
 };

package/components/crop-image/README.md

@@ -50,20 +50,21 @@ import { cropImage } from 'sard-uniapp'
 
 ### CropImageProps
 
-| 属性        | 描述                                                   | 类型                                      | 默认值 |
-| ----------- | ------------------------------------------------------ | ----------------------------------------- | ------ |
-| root-class  | 组件根元素类名                                         | string                                    | -      |
-| root-style  | 组件根元素样式                                         | StyleValue                                | -      |
-| visible     | 是否显示裁剪弹框                                       | boolean                                   | false  |
-| src         | 要裁剪的图片                                           | string                                    | false  |
-| crop-scale  | 裁剪的比例                                             | string                                    | '1:1'  |
-| type        | 导出图片类型                                           | 'png' \| 'jpg'                            | 'png'  |
-| quality     | 导出图片的质量                                         | number                                    | 0.92   |
-| duration    | 弹窗显隐过渡时间（单位 ms）                            | number                                    | 150    |
-| success     | 裁剪成功回调                                           | (filePath: string) => void                | -      |
-| fail        | 裁剪成功回调                                           | (err: any) => void                        | -      |
-| complete    | 裁剪成功或失败回调                                     | () => void                                | -      |
-| before-crop | 裁剪前回调，可以修改裁剪的尺寸；接收宽高，返回缩放比例 | (width: number, height: number) => number | -      |
+| 属性                    | 描述                                                   | 类型                                      | 默认值 |
+| ----------------------- | ------------------------------------------------------ | ----------------------------------------- | ------ |
+| root-class              | 组件根元素类名                                         | string                                    | -      |
+| root-style              | 组件根元素样式                                         | StyleValue                                | -      |
+| visible                 | 是否显示裁剪弹框                                       | boolean                                   | false  |
+| src                     | 要裁剪的图片                                           | string                                    | false  |
+| crop-scale              | 裁剪的比例                                             | string                                    | '1:1'  |
+| type                    | 导出图片类型                                           | 'png' \| 'jpg'                            | 'png'  |
+| quality                 | 导出图片的质量                                         | number                                    | 0.92   |
+| duration                | 弹窗显隐过渡时间（单位 ms）                            | number                                    | 150    |
+| success                 | 裁剪成功回调                                           | (filePath: string) => void                | -      |
+| fail                    | 裁剪失败回调                                           | (err: any) => void                        | -      |
+| complete                | 裁剪成功或失败回调                                     | () => void                                | -      |
+| cancel <sup>1.23+</sup> | 点击取消按钮时触发                                     | () => void                                | -      |
+| before-crop             | 裁剪前回调，可以修改裁剪的尺寸；接收宽高，返回缩放比例 | (width: number, height: number) => number | -      |
 
 ### CropImageEmits
 

package/components/crop-image/common.d.ts

@@ -12,6 +12,7 @@ export interface CropImageProps {
     success?: (filePath: string) => void;
     fail?: (err: any) => void;
     complete?: () => void;
+    cancel?: () => void;
     id?: string;
     beforeCrop?: (width: number, height: number) => number;
     cancelText?: string;

package/components/crop-image/crop-image.vue

@@ -129,8 +129,9 @@ const maxScale = 5;
  * @property {number} quality 导出图片的质量，默认值：0.92。
  * @property {number} duration 弹窗显隐过渡时间（单位 ms），默认值：150。
  * @property {(filePath: string) => void} success 裁剪成功回调，默认值：-。
- * @property {(err: any) => void} fail 裁剪成功回调，默认值：-。
+ * @property {(err: any) => void} fail 裁剪失败回调，默认值：-。
  * @property {() => void} complete 裁剪成功或失败回调，默认值：-。
+ * @property {() => void} cancel 点击取消按钮时触发，默认值：-。
  * @property {(width: number, height: number) => number} beforeCrop 裁剪前回调，可以修改裁剪的尺寸；接收宽高，返回缩放比例，默认值：-。
  * @event {(visible: boolean) => void} update 弹出框显隐时触发
  * @event {(name: TransitionHookName) => void} visible-hook 入场/退场动画状态改变时触发
@@ -169,6 +170,7 @@ export default  _defineComponent({
     success: { type: Function, required: false },
     fail: { type: Function, required: false },
     complete: { type: Function, required: false },
+    cancel: { type: Function, required: false },
     id: { type: String, required: false },
     beforeCrop: { type: Function, required: false },
     cancelText: { type: String, required: false },
@@ -643,6 +645,7 @@ export default  _defineComponent({
       });
     };
     const onCancel = () => {
+      props.cancel?.();
       close();
     };
     const onReset = () => {

package/components/crop-image-agent/crop-image-agent.vue

@@ -35,6 +35,7 @@ export default  _defineComponent({
     success: { type: Function, required: false },
     fail: { type: Function, required: false },
     complete: { type: Function, required: false },
+    cancel: { type: Function, required: false },
     beforeCrop: { type: Function, required: false },
     cancelText: { type: String, required: false },
     confirmText: { type: String, required: false }