sard-uniapp 1.25.4 → 1.25.5

package/CHANGELOG.md

@@ -1,3 +1,19 @@
+## [1.25.5](https://github.com/sutras/sard-uniapp/compare/v1.25.4...v1.25.5) (2025-11-30)
+
+
+### Bug Fixes
+
+* **image:** 修复image动态展示时无法获取正确尺寸的问题 ([432d8b3](https://github.com/sutras/sard-uniapp/commit/432d8b368a3b49e70f79d8c0b3a7ce65969171e5))
+
+
+### Features
+
+* **cascader:** 级联组件新增多选功能 ([7f104c1](https://github.com/sutras/sard-uniapp/commit/7f104c1a393509a6b1c97b2565520f9f8e6f8361))
+* 兼容鸿蒙 ([53924d7](https://github.com/sutras/sard-uniapp/commit/53924d7f9562bb4cbe162083998f1485590c629f))
+* 阻止页面滚动(弹窗中的滚动穿透) ([21b43c0](https://github.com/sutras/sard-uniapp/commit/21b43c0924ba1197b217b6fd1020fbd07d5b04fe))
+
+
+
 ## [1.25.4](https://github.com/sutras/sard-uniapp/compare/v1.25.3...v1.25.4) (2025-11-22)
 
 

package/components/accordion/accordion.vue

@@ -28,7 +28,7 @@ export default  _defineComponent({
   },
   __name: "accordion",
   props: {
-    rootStyle: { type: [Boolean, null, String, Object, Array], required: false, skipCheck: true },
+    rootStyle: { type: null, required: false },
     rootClass: { type: String, required: false },
     modelValue: { type: [Array, String, Number], required: false },
     multiple: { type: Boolean, required: false },

package/components/accordion-item/accordion-item.vue

@@ -46,7 +46,7 @@ export default  _defineComponent({
   },
   __name: "accordion-item",
   props: {
-    rootStyle: { type: [Boolean, null, String, Object, Array], required: false, skipCheck: true },
+    rootStyle: { type: null, required: false },
     rootClass: { type: String, required: false },
     title: { type: String, required: false },
     value: { type: String, required: false },

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

@@ -100,7 +100,7 @@ export default  _defineComponent({
   },
   __name: "action-sheet",
   props:  _mergeDefaults({
-    rootStyle: { type: [Boolean, null, String, Object, Array], required: false, skipCheck: true },
+    rootStyle: { type: null, required: false },
     rootClass: { type: String, required: false },
     description: { type: String, required: false },
     itemList: { type: Array, required: false },

package/components/alert/alert.vue

@@ -43,7 +43,7 @@ export default  _defineComponent({
   },
   __name: "alert",
   props:  _mergeDefaults({
-    rootStyle: { type: [Boolean, null, String, Object, Array], required: false, skipCheck: true },
+    rootStyle: { type: null, required: false },
     rootClass: { type: String, required: false },
     showIcon: { type: Boolean, required: false },
     closable: { type: Boolean, required: false },

package/components/avatar/avatar.vue

@@ -62,7 +62,7 @@ export default  _defineComponent({
   },
   __name: "avatar",
   props:  _mergeDefaults({
-    rootStyle: { type: [Boolean, null, String, Object, Array], required: false, skipCheck: true },
+    rootStyle: { type: null, required: false },
     rootClass: { type: String, required: false },
     shape: { type: String, required: false },
     size: { type: String, required: false },

package/components/avatar-group/avatar-group.vue

@@ -31,7 +31,7 @@ export default  _defineComponent({
   },
   __name: "avatar-group",
   props:  _mergeDefaults({
-    rootStyle: { type: [Boolean, null, String, Object, Array], required: false, skipCheck: true },
+    rootStyle: { type: null, required: false },
     rootClass: { type: String, required: false },
     max: { type: Number, required: true },
     total: { type: Number, required: true },

package/components/back-top/back-top.vue

@@ -35,7 +35,7 @@ export default  _defineComponent({
   },
   __name: "back-top",
   props:  _mergeDefaults({
-    rootStyle: { type: [Boolean, null, String, Object, Array], required: false, skipCheck: true },
+    rootStyle: { type: null, required: false },
     rootClass: { type: String, required: false },
     scrollTop: { type: Number, required: false },
     visibleHeight: { type: Number, required: false },

package/components/badge/badge.vue

@@ -39,7 +39,7 @@ export default  _defineComponent({
   },
   __name: "badge",
   props:  _mergeDefaults({
-    rootStyle: { type: [Boolean, null, String, Object, Array], required: false, skipCheck: true },
+    rootStyle: { type: null, required: false },
     rootClass: { type: String, required: false },
     value: { type: [Number, String], required: false },
     max: { type: Number, required: false },

package/components/button/button.vue

@@ -119,7 +119,7 @@ export default  _defineComponent({
   },
   __name: "button",
   props:  _mergeDefaults({
-    rootStyle: { type: [Boolean, null, String, Object, Array], required: false, skipCheck: true },
+    rootStyle: { type: null, required: false },
     rootClass: { type: String, required: false },
     type: { type: String, required: false },
     theme: { type: String, required: false },

package/components/calendar/calendar.vue

@@ -169,7 +169,7 @@ export default  _defineComponent({
   },
   __name: "calendar",
   props:  _mergeDefaults({
-    rootStyle: { type: [Boolean, null, String, Object, Array], required: false, skipCheck: true },
+    rootStyle: { type: null, required: false },
     rootClass: { type: String, required: false },
     type: { type: String, required: false },
     modelValue: { type: [Date, Array, String], required: false },

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

@@ -134,9 +134,9 @@ export default  _defineComponent({
     showConfirm: { type: Boolean, required: false },
     validateEvent: { type: Boolean, required: false },
     popoutClass: { type: String, required: false },
-    popoutStyle: { type: [Boolean, null, String, Object, Array], required: false, skipCheck: true },
+    popoutStyle: { type: null, required: false },
     resettable: { type: Boolean, required: false },
-    rootStyle: { type: [Boolean, null, String, Object, Array], required: false, skipCheck: true },
+    rootStyle: { type: null, required: false },
     rootClass: { type: String, required: false },
     type: { type: String, required: false },
     modelValue: { type: [Date, Array, String], required: false },

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

@@ -106,9 +106,9 @@ export default  _defineComponent({
     showConfirm: { type: Boolean, required: false },
     validateEvent: { type: Boolean, required: false },
     popoutClass: { type: String, required: false },
-    popoutStyle: { type: [Boolean, null, String, Object, Array], required: false, skipCheck: true },
+    popoutStyle: { type: null, required: false },
     resettable: { type: Boolean, required: false },
-    rootStyle: { type: [Boolean, null, String, Object, Array], required: false, skipCheck: true },
+    rootStyle: { type: null, required: false },
     rootClass: { type: String, required: false },
     type: { type: String, required: false },
     modelValue: { type: [Date, Array, String], required: false },

package/components/card/card.vue

@@ -53,7 +53,7 @@ export default  _defineComponent({
   },
   __name: "card",
   props: {
-    rootStyle: { type: [Boolean, null, String, Object, Array], required: false, skipCheck: true },
+    rootStyle: { type: null, required: false },
     rootClass: { type: String, required: false },
     title: { type: String, required: false },
     extra: { type: String, required: false },

package/components/cascader/README.md

@@ -29,12 +29,20 @@ import Cascader from 'sard-uniapp/components/cascader/cascader.vue'
 
 @code('${DEMO_PATH}/cascader/demo/ChangeOnSelect.vue')
 
-### 异步加载
+### 异步加载（已废弃，建议使用“懒加载”）
 
-通过监听 `@select` 事件，获取当前选中的选项，将异步获取的数据作为 `children` 属性值， 再把组件的 `options` 更新一下，使组件重新渲染。如果选项的 `children` 是需要用户点击时再通过接口获取的， 此选项的 `children` 需初始化为空数组。
+通过监听 `@select` 事件，获取当前选中的选项，将异步获取的数据作为 `children` 属性值， 再把组件的 `options` 更新一下，使组件重新渲染。如果选项的 `children` 是需要用户点击时再通过接口获取的， 此选项的 `children` 需初始化为**空数组**。
 
 @code('${DEMO_PATH}/cascader/demo/Async.vue')
 
+### 懒加载 <sup>1.25.5+</sup>
+
+设置 `lazy` 属性标识为懒加载，设置 `load` 属性用于获取数据，会在点击节点时调用，当获取的数据为空时，会将点击的节点标识为叶子节点。当然，你也可以提前设置节点是否为叶子节点，以避免为叶子节点时还要请求一次接口。
+
+首次加载失败可点击提示重新加载，“无数据”状态也可点击重新加载；点击节点加载失败回退到 `idle` 状态，可再次点击进行加载。
+
+@code('${DEMO_PATH}/cascader/demo/Lazy.vue')
+
 ### 自定义面板上方内容
 
 使用 `top` 插槽可以在面板顶部展示当前面板的一些信息。
@@ -53,21 +61,51 @@ import Cascader from 'sard-uniapp/components/cascader/cascader.vue'
 
 @code('${DEMO_PATH}/cascader/demo/AllLevels.vue')
 
+### 多选 <sup>1.25.5+</sup>
+
+设置 `multiple` 属性可在每个选项前面显示复选框，点击复选框可选择多个；如果是最后一级，点击选项也可以选中复选框。
+
+@code('${DEMO_PATH}/cascader/demo/Multiple.vue')
+
+### 多选-绑定所有级别的值 <sup>1.25.5+</sup>
+
+`all-levels` 属性也可以作用于多选，当设置此属性，绑定的值会是一个二维数组。
+
+@code('${DEMO_PATH}/cascader/demo/MultipleAllLevels.vue')
+
+### 多选-选择任意级别 <sup>1.25.5+</sup>
+
+在单选模式下，你只能选择叶子节点；而在多选模式下，勾选父节点真正选中的都是叶子节点。 启用该功能后，可让父子节点取消关联，选择任意一级选项。
+
+可通过设置 `check-strictly` 来取消父子节点选中关联，从而达到选择任意一级选项的目的。
+
+@code('${DEMO_PATH}/cascader/demo/CheckStrictly.vue')
+
+### 多选-选择任意级别-绑定所有级别 <sup>1.25.5+</sup>
+
+下面综合演示多选的使用。
+
+@code('${DEMO_PATH}/cascader/demo/CheckStrictlyAllLevels.vue')
+
 ## API
 
 ### CascaderProps
 
-| 属性                              | 描述                                     | 类型                                     | 默认值           |
-| --------------------------------- | ---------------------------------------- | ---------------------------------------- | ---------------- |
-| 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            |
+| 属性                              | 描述                                          | 类型                                                                        | 默认值           |
+| --------------------------------- | --------------------------------------------- | --------------------------------------------------------------------------- | ---------------- |
+| root-class                        | 组件根元素类名                                | string                                                                      | -                |
+| root-style                        | 组件根元素样式                                | StyleValue                                                                  | -                |
+| model-value (v-model)             | 选中项的值                                    | CascaderValue                                                               | -                |
+| 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            |
+| multiple <sup>1.25.5+</sup>       | 是否多选                                      | boolean                                                                     | false            |
+| check-strictly <sup>1.25.5+</sup> | 是否严格的遵守父子节点不互相关联（用于多选）  | boolean                                                                     | false            |
+| lazy <sup>1.25.5+</sup>           | 是否懒加载子节点，需与 load 方法结合使用      | boolean                                                                     | false            |
+| load <sup>1.25.5+</sup>           | 加载子节点的方法，仅当 lazy 属性为true 时生效 | (node?: CascaderStateNode) => Promise<CascaderOption[]> \| CascaderOption[] | -                |
 
 ### CascaderSlots
 
@@ -77,11 +115,21 @@ import Cascader from 'sard-uniapp/components/cascader/cascader.vue'
 
 ### CascaderEmits
 
-| 事件                     | 描述                   | 类型                                                                                         |
-| ------------------------ | ---------------------- | -------------------------------------------------------------------------------------------- |
-| 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                                           |
+| 事件                     | 描述                   | 类型                                                              |
+| ------------------------ | ---------------------- | ----------------------------------------------------------------- |
+| update:model-value       | 全部选项选择完成后触发 | (value: CascaderValue, selectedOptions: CascaderOption[]) => void |
+| change <sup>1.9.2+</sup> | 全部选项选择完成后触发 | (value: CascaderValue, selectedOptions: CascaderOption[]) => void |
+| select                   | 选中某一项时触发       | (option: CascaderOption, tabIndex: number) => void                |
+
+### CascaderValue
+
+```ts
+type CascaderValue =
+  | string
+  | number
+  | (string | number)[]
+  | (string | number)[][]
+```
 
 ### CascaderOption
 
@@ -91,6 +139,7 @@ interface CascaderOption {
   value?: string | number
   disabled?: boolean
   children?: CascaderOption[]
+  isLeaf?: boolean
   [key: PropertyKey]: any
 }
 ```
@@ -103,6 +152,7 @@ interface CascaderFieldKeys {
   value?: string
   disabled?: string
   children?: string
+  isLeaf?: string
 }
 ```
 
@@ -114,6 +164,27 @@ const defaultFieldKeys: CascaderFieldKeys = {
   value: 'value',
   disabled: 'disabled',
   children: 'children',
+  isLeaf: 'isLeaf',
+}
+```
+
+### CascaderStateNode
+
+```ts
+interface CascaderStateNode {
+  label: string
+  value: string | number
+  key: string | number
+  disabled: boolean
+  children?: CascaderStateNode[]
+  parent: CascaderStateNode | null
+  isLeaf: boolean
+  loadStatus: 'idle' | 'loading' | 'loaded'
+  depth: number
+  indeterminate: boolean
+  checked: boolean
+  selected: boolean
+  option: CascaderOption
 }
 ```
 

package/components/cascader/cascader.d.ts

@@ -1,15 +1,15 @@
-import { type CascaderProps, type CascaderSlots, type CascaderOption } from './common';
+import { type CascaderProps, type CascaderSlots } 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 | (string | number)[], selectedOptions: any[]) => any;
-    change: (value: string | number | (string | number)[], selectedOptions: any[]) => any;
+    "update:model-value": (value: import("./common").CascaderValue, selectedOptions: any[]) => any;
+    change: (value: import("./common").CascaderValue, selectedOptions: any[]) => any;
     select: (option: any, tabIndex: number) => any;
 }, string, import("vue").PublicProps, Readonly<CascaderProps> & Readonly<{
-    "onUpdate:model-value"?: ((value: string | number | (string | number)[], selectedOptions: any[]) => any) | undefined;
-    onChange?: ((value: string | number | (string | number)[], selectedOptions: any[]) => any) | undefined;
+    "onUpdate:model-value"?: ((value: import("./common").CascaderValue, selectedOptions: any[]) => any) | undefined;
+    onChange?: ((value: import("./common").CascaderValue, selectedOptions: any[]) => any) | undefined;
     onSelect?: ((option: any, tabIndex: number) => any) | undefined;
 }>, {
-    options: CascaderOption[];
+    options: import("./common").CascaderOption[];
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, ReturnType<typeof __VLS_template>>;
 export default _default;