sard-uniapp 1.19.2 → 1.19.4

package/components/calendar-month/calendar-month.vue

@@ -64,7 +64,10 @@ export default  _defineComponent({
     weekStartsOn: { type: Number, required: true },
     severalMonths: { type: Boolean, required: false },
     t: { type: Function, required: true },
-    bem: { type: null, required: true }
+    bem: { type: null, required: true },
+    startDateText: { type: String, required: false },
+    endDateText: { type: String, required: false },
+    sameDateText: { type: String, required: false }
   },
   emits: ["day-click"],
   setup(__props, { expose: __expose, emit: __emit }) {
@@ -132,7 +135,7 @@ export default  _defineComponent({
           disabled,
           top: "",
           text: date.getDate() + "",
-          bottom: isStart && isEnd ? `${props.t("start")}/${props.t("end")}` : isStart ? props.t("start") : isEnd ? props.t("end") : "",
+          bottom: isStart && isEnd ? props.sameDateText || `${props.t("start")}/${props.t("end")}` : isStart ? props.startDateText || props.t("start") : isEnd ? props.endDateText || props.t("end") : "",
           type: isStart && isEnd ? "same" : isStart ? "start" : isMiddle ? "middle" : isEnd ? "end" : selected ? "selected" : "normal"
         };
         if (within && props.formatter) {

package/components/calendar-popout/README.md

@@ -0,0 +1,100 @@
+---
+nav: 组件
+title: CalendarPopout
+subtitle: 日历弹出框
+group: 表单组件
+version: 1.16+
+---
+
+## 介绍
+
+组合了日历、弹出框组件，实现了便捷快速的日历选择功能。
+
+## 引入
+
+```ts
+import CalendarPopout from 'sard-uniapp/components/calendar-popout/calendar-popout.vue'
+```
+
+## 代码演示
+
+### 基础使用
+
+使用 `v-model` 双向绑定当前值，使用 `v-model:visible` 控制弹出框显隐。
+
+@code('${DEMO_PATH}/calendar-popout/demo/Basic.vue')
+
+### 类型
+
+日历组件可以选择单个值、多个值以及进行范围选择。
+
+@code('${DEMO_PATH}/calendar-popout/demo/Type.vue')
+
+### 自定义日期范围
+
+可以使用 `min` 和 `max` 属性限制可以选择的日期的范围。
+
+@code('${DEMO_PATH}/calendar-popout/demo/MinMax.vue')
+
+### 最多选择天数
+
+在多个值和范围选择中，使用 `maxDays` 属性可以限制最多可选的天数。
+超出允许选择的天数后会调用 `overMaxDays` 属性配置的函数。
+
+@code('${DEMO_PATH}/calendar-popout/demo/MaxDays.vue')
+
+### 禁用日期
+
+`disabledDate` 属性配置的函数接收一个日期对象，如果此函数返回真则禁用这个日期。
+
+@code('${DEMO_PATH}/calendar-popout/demo/DisabledDate.vue')
+
+### 自定义起始周
+
+默认一周从星期天开始，使用 `weekStartsOn` 属性可以配置一周从任意星期开始。
+0 表示从周日开始，1 表示从周一开始。
+
+@code('${DEMO_PATH}/calendar-popout/demo/WeekStartsOn.vue')
+
+### 格式化日期
+
+`formatter` 属性可以配置一个接收 `CalendarDay` 类型的对象，通过此对象可以自定义当前日期展示的内容和样式。
+
+@code('${DEMO_PATH}/calendar-popout/demo/Formatter.vue')
+
+### 展示多个月
+
+默认只展示一个月，如果要表现上下月之间的强关联性，可以设置 `severalMonths` 属性以展示多个月。
+这时设置的最大最小值范围不能太大，避免渲染大量节点造成性能问题。
+
+@code('${DEMO_PATH}/calendar-popout/demo/Several.vue')
+
+## API
+
+### CalendarPopoutProps
+
+继承 [`CalendarProps`](./calendar#CalendarProps) 并有以下额外属性：
+
+| 属性              | 描述                                     | 类型       | 默认值 |
+| ----------------- | ---------------------------------------- | ---------- | ------ |
+| popout-class      | 弹窗框根元素类名                         | string     | -      |
+| popout-style      | 弹窗框根元素样式                         | StyleValue | -      |
+| visible (v-model) | 是否显示弹出框                           | boolean    | -      |
+| title             | 弹出框标题                               | string     | -      |
+| show-confirm      | 是否显示确定按钮，隐藏按钮可用于快捷选择 | boolean    | true   |
+| validate-event    | 是否触发表单验证                         | boolean    | true   |
+
+### CalendarPopoutSlots
+
+| 插槽                             | 描述               | 属性 |
+| -------------------------------- | ------------------ | ---- |
+| title <sup>1.19.2+</sup>         | 自定义标题         | -    |
+| title-prepend <sup>1.19.2+</sup> | 自定义标题前面内容 | -    |
+
+### CalendarPopoutEmits
+
+| 事件               | 描述                 | 类型                                                               |
+| ------------------ | -------------------- | ------------------------------------------------------------------ |
+| update:model-value | 日历组件值改变时触发 | (value: Date \| Date[] \| string \| string[] \| undefined) => void |
+| change             | 日历组件值改变时触发 | (value: Date \| Date[] \| string \| string[] \| undefined) => void |
+| update:visible     | 弹出框显隐时触发     | (visible: boolean) => void                                         |

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

@@ -28,6 +28,9 @@
         :week-starts-on="weekStartsOn"
         :formatter="formatter"
         :allow-same-day="allowSameDay"
+        :start-date-text="startDateText"
+        :end-date-text="endDateText"
+        :same-date-text="sameDateText"
         :several-months="severalMonths"
         :value-format="valueFormat"
         @change="onChange"
@@ -45,6 +48,34 @@ import {
   defaultCalendarPopoutProps
 } from "./common";
 import { useFormPopout } from "../../use";
+/**
+ * @property {string} rootClass 组件根元素类名，默认值：-。
+ * @property {StyleValue} rootStyle 组件根元素样式，默认值：-。
+ * @property {CalendarType} type 日历类型，默认值：'single'。
+ * @property {Date | Date[] | string | string[]} modelValue 选中的日期，单选时为当个日期，多选时为日期数组，范围时为两个日期数组，默认值：-。
+ * @property {Date} min 可选择的最小日期，默认值：前十年，或者当前月（设置了 `several-months`）。
+ * @property {Date} max 可选择的最大日期，默认值：后十年，或者三个月后（设置了 `several-months`）。
+ * @property {Date} currentDate 当前展示月份的日期，默认值：-。
+ * @property {(date: Date) => boolean} disabledDate 指定禁选日期，返回 `true` 表示禁选，默认值：-。
+ * @property {number} maxDays 最多可选天数，用于多选和范围，默认值：Number.MAX_SAFE_INTEGER。
+ * @property {() => void} overMaxDays 超出最多可选天数时触发，默认值：-。
+ * @property {number} weekStartsOn 指定一周以周几开始，`0` 表示周日，`1-6` 分别表示周一至周六，默认值：0。
+ * @property {(day: CalendarDay) => void} formatter 通过修改 `CalendarDay` 对象属性值，来自定义日期的文案和样式，默认值：-。
+ * @property {boolean} allowSameDay 范围选择中，是否允许起始和结束为同一天，默认值：false。
+ * @property {boolean} severalMonths 是否显示多个月，默认值：false。
+ * @property {string [详见特殊符号](../guide/date#日期格式特殊符号)} valueFormat 绑定值的格式，不指定则绑定值为 Date 对象，默认值：-。
+ * @property {string} startDateText 开始日期文字，默认值：'开始'。
+ * @property {string} endDateText 结束日期文字，默认值：'结束'。
+ * @property {string} sameDateText 选择同一天日期文字，默认值：'开始/结束'。
+ * @property {string} popoutClass 弹窗框根元素类名，默认值：-。
+ * @property {StyleValue} popoutStyle 弹窗框根元素样式，默认值：-。
+ * @property {boolean} visible 是否显示弹出框，默认值：-。
+ * @property {string} title 弹出框标题，默认值：-。
+ * @property {boolean} showConfirm 是否显示确定按钮，隐藏按钮可用于快捷选择，默认值：true。
+ * @property {boolean} validateEvent 是否触发表单验证，默认值：true。
+ * @event {(visible: boolean) => void} update 弹出框显隐时触发
+ * @event {(value: Date | Date[] | string | string[] | undefined) => void} change 日历组件值改变时触发
+ */
 export default  _defineComponent({
   components: {
     SarPopout,
@@ -78,7 +109,10 @@ export default  _defineComponent({
     formatter: { type: Function, required: false },
     allowSameDay: { type: Boolean, required: false },
     severalMonths: { type: Boolean, required: false },
-    valueFormat: { type: String, required: false }
+    valueFormat: { type: String, required: false },
+    startDateText: { type: String, required: false },
+    endDateText: { type: String, required: false },
+    sameDateText: { type: String, required: false }
   }, defaultCalendarPopoutProps()),
   emits: ["update:visible", "update:model-value", "change"],
   setup(__props, { expose: __expose, emit: __emit }) {

package/components/card/README.md

@@ -0,0 +1,82 @@
+---
+nav: 组件
+title: Card
+subtitle: 卡片
+group: 数据展示
+---
+
+## 介绍
+
+以矩形的形式呈现相关信息或内容，包含标题、内容和相关元素。
+
+## 引入
+
+```ts
+import Card from 'sard-uniapp/components/card/card.vue'
+```
+
+## 代码演示
+
+### 基础使用
+
+展示带标题和内容的卡片。
+
+@code('${DEMO_PATH}/card/demo/Basic.vue')
+
+### 基础使用
+
+设置 `extra` 属性可以在标题右边放置额外内容。
+
+@code('${DEMO_PATH}/card/demo/Extra.vue')
+
+### 只有主体
+
+如果不设置标题和额外内容，则不会渲染头部。
+
+@code('${DEMO_PATH}/card/demo/OnlyBody.vue')
+
+### 底部
+
+可以设置 `footer` 属性在主体下面放置内容。
+
+@code('${DEMO_PATH}/card/demo/Footer.vue')
+
+### 可点击的
+
+设置 `hover` 属性会有点击状态。
+
+@code('${DEMO_PATH}/card/demo/Hover.vue')
+
+## API
+
+### CardProps
+
+| 属性                     | 描述             | 类型       | 默认值 |
+| ------------------------ | ---------------- | ---------- | ------ |
+| root-class               | 组件根元素类名   | string     | -      |
+| root-style               | 组件根元素样式   | StyleValue | -      |
+| title                    | 头部左边内容     | string     | -      |
+| extra                    | 头部右边内容     | string     | -      |
+| footer                   | 底部内容         | string     | -      |
+| hover <sup>1.12.3+</sup> | 是否开启点击反馈 | boolean    | false  |
+
+### CardSlots
+
+| 插槽    | 描述           | 属性 |
+| ------- | -------------- | ---- |
+| default | 自定义默认内容 | -    |
+| title   | 自定义标题内容 | -    |
+| extra   | 自定义额外内容 | -    |
+| footer  | 自定义底部内容 | -    |
+
+### CardEmits
+
+| 事件                     | 描述           | 类型                 |
+| ------------------------ | -------------- | -------------------- |
+| click <sup>1.12.2+</sup> | 点击卡片时触发 | (event: any) => void |
+
+## 主题定制
+
+### CSS 变量
+
+@code('./variables.scss#variables')

package/components/card/card.vue

@@ -26,6 +26,15 @@ import {
   createBem,
   isVisibleEmpty
 } from "../../utils";
+/**
+ * @property {string} rootClass 组件根元素类名，默认值：-。
+ * @property {StyleValue} rootStyle 组件根元素样式，默认值：-。
+ * @property {string} title 头部左边内容，默认值：-。
+ * @property {string} extra 头部右边内容，默认值：-。
+ * @property {string} footer 底部内容，默认值：-。
+ * @property {boolean} hover 是否开启点击反馈，默认值：false。
+ * @event {(event: any) => void} click 点击卡片时触发
+ */
 export default  _defineComponent({
   ...{
     options: {

package/components/cascader/README.md

@@ -0,0 +1,117 @@
+---
+nav: 组件
+title: Cascader
+subtitle: 级联选择
+group: 表单组件
+---
+
+## 介绍
+
+用于在多层级数据中进行选择，常用于省市区、组织架构选择。
+
+## 引入
+
+```ts
+import { Cascader } from 'sard'
+```
+
+## 代码演示
+
+### 基础使用
+
+通过 `v-model` 绑定当前值，通过 `options` 配置选项数据。
+
+@code('${DEMO_PATH}/cascader/demo/Basic.vue')
+
+### 选择即改变
+
+设置 `change-on-select` 属性，允许只选中父级选项。
+
+@code('${DEMO_PATH}/cascader/demo/ChangeOnSelect.vue')
+
+### 异步加载
+
+通过监听 `@select` 事件，获取当前选中的选项，将异步获取的数据作为 `children` 属性值， 再把组件的 `options` 更新一下，使组件重新渲染。如果选项的 `children` 是需要用户点击时再通过接口获取的， 此选项的 `children` 需初始化为空数组。
+
+@code('${DEMO_PATH}/cascader/demo/Async.vue')
+
+### 自定义面板上方内容
+
+使用 `top` 插槽可以在面板顶部展示当前面板的一些信息。
+
+@code('${DEMO_PATH}/cascader/demo/OptionTop.vue')
+
+### 禁选选项
+
+禁用的选项不可点击。
+
+@code('${DEMO_PATH}/cascader/demo/Disabled.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            |
+
+### CascaderSlots
+
+| 插槽 | 描述               | 属性                 |
+| ---- | ------------------ | -------------------- |
+| top  | 自定义面板上方内容 | { tabIndex: number } |
+
+### 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                   |
+
+### CascaderOption
+
+```ts
+interface CascaderOption {
+  label?: string
+  value?: string | number
+  disabled?: boolean
+  children?: CascaderOption[]
+  [key: PropertyKey]: any
+}
+```
+
+### CascaderFieldKeys
+
+```ts
+interface CascaderFieldKeys {
+  label?: string
+  value?: string
+  disabled?: string
+  children?: string
+}
+```
+
+### defaultFieldKeys
+
+```ts
+const defaultFieldKeys: CascaderFieldKeys = {
+  label: 'label',
+  value: 'value',
+  disabled: 'disabled',
+  children: 'children',
+}
+```
+
+## 主题定制
+
+### CSS 变量
+
+@code('./variables.scss#variables')

package/components/cascader/cascader.vue

@@ -92,6 +92,19 @@ import {
   getSelectedOptionsByValue,
   defaultCascaderProps
 } from "./common";
+/**
+ * @property {string} rootClass 组件根元素类名，默认值：-。
+ * @property {StyleValue} rootStyle 组件根元素样式，默认值：-。
+ * @property {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 全部选项选择完成后触发
+ * @event {(option: CascaderOption, tabIndex: number) => void} select 选中某一项时触发
+ */
 export default  _defineComponent({
   components: {
     SarTabs,

package/components/cascader-input/README.md

@@ -0,0 +1,51 @@
+---
+nav: 组件
+title: CascaderInput
+subtitle: 级联输入框
+group: 表单组件
+---
+
+## 介绍
+
+组合了级联弹出框、输入框组件，实现了便捷快速的级联选择功能。
+
+## 引入
+
+```ts
+import CascaderInput from 'sard-uniapp/components/cascader-input/cascader-input.vue'
+```
+
+## 代码演示
+
+### 基础使用
+
+使用 `v-model` 绑定当前值，通过 `title` 和 `placeholder` 属性设置弹出框标题和输入框占位文本。
+
+在点击输入框后会显示级联弹出框。
+
+@code('${DEMO_PATH}/cascader-input/demo/Basic.vue')
+
+## API
+
+### CascaderInputProps
+
+继承 [`CascaderPopoutProps`](./cascader-popout#CascaderPopoutProps) 并有以下额外属性：
+
+| 属性                              | 描述                   | 类型       | 默认值          |
+| --------------------------------- | ---------------------- | ---------- | --------------- |
+| root-class                        | 弹出式输入框根元素类名 | string     | -               |
+| root-style                        | 弹出式输入框根元素样式 | StyleValue | -               |
+| disabled                          | 禁用状态               | boolean    | false           |
+| readonly                          | 只读状态               | boolean    | false           |
+| loading                           | 加载状态               | boolean    | false           |
+| clearable                         | 是否显示清空按钮       | boolean    | false           |
+| placeholder                       | 输入框占位符内容       | string     | -               |
+| value-on-clear <sup>1.19.2+</sup> | 设置点击清除按钮后的值 | () => any  | () => undefined |
+
+### CascaderInputSlots
+
+继承 [`CascaderPopoutSlots`](./cascader-popout#CascaderPopoutSlots)
+
+### CascaderInputEmits
+
+继承 [`CascaderPopoutEmits`](./cascader-popout#CascaderPopoutEmits)

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

@@ -48,6 +48,31 @@ import { usePopoutInput } from "../../use";
 import {
   defaultCascaderInputProps
 } from "./common";
+/**
+ * @property {string} rootClass 弹出式输入框根元素类名，默认值：-。
+ * @property {StyleValue} rootStyle 弹出式输入框根元素样式，默认值：-。
+ * @property {string | number} modelValue 选中项的值，默认值：-。
+ * @property {CascaderOption[]} options 可选项数据源，默认值：[]。
+ * @property {CascaderFieldKeys} fieldKeys 自定义 `options` 中的字段，默认值：defaultFieldKeys。
+ * @property {string} hintText 未选中时的提示文案，默认值：'请选择'。
+ * @property {(option: CascaderOption) => string} labelRender 自定义可选项渲染，默认值：-。
+ * @property {boolean} changeOnSelect 点击每级选项都会触发变化，默认值：false。
+ * @property {string} popoutClass 弹窗框根元素类名，默认值：-。
+ * @property {StyleValue} popoutStyle 弹窗框根元素样式，默认值：-。
+ * @property {boolean} visible 是否显示弹出框，默认值：-。
+ * @property {string} title 弹出框标题，默认值：-。
+ * @property {boolean} showConfirm 是否显示确定按钮，隐藏按钮可用于快捷选择，默认值：true。
+ * @property {boolean} validateEvent 是否触发表单验证，默认值：true。
+ * @property {boolean} disabled 禁用状态，默认值：false。
+ * @property {boolean} readonly 只读状态，默认值：false。
+ * @property {boolean} loading 加载状态，默认值：false。
+ * @property {boolean} clearable 是否显示清空按钮，默认值：false。
+ * @property {string} placeholder 输入框占位符内容，默认值：-。
+ * @property {() => any} valueOnClear 设置点击清除按钮后的值，默认值：() => undefined。
+ * @event {(visible: boolean) => void} update 弹出框显隐时触发
+ * @event {(value: string | number, selectedOptions: CascaderOption[]) => void} change 级联输入组件值改变时触发
+ * @event {(option: CascaderOption, tabIndex: number) => void} select 选择级联选择某一项时触发
+ */
 export default  _defineComponent({
   components: {
     SarPopoutInput,

package/components/cascader-popout/README.md

@@ -0,0 +1,53 @@
+---
+nav: 组件
+title: CascaderPopout
+subtitle: 级联弹出框
+group: 表单组件
+version: 1.16+
+---
+
+## 介绍
+
+组合了级联选择、弹出框组件，实现了便捷快速的级联选择功能。
+
+## 引入
+
+```ts
+import CascaderPopout from 'sard-uniapp/components/cascader-popout/cascader-popout.vue'
+```
+
+## 代码演示
+
+### 基础使用
+
+使用 `v-model` 双向绑定当前值，使用 `v-model:visible` 控制弹出框显隐。
+
+@code('${DEMO_PATH}/cascader-popout/demo/Basic.vue')
+
+## API
+
+### CascaderPopoutProps
+
+继承 [`CascaderProps`](./cascader#CascaderProps) 并有以下额外属性：
+
+| 属性              | 描述                                     | 类型       | 默认值 |
+| ----------------- | ---------------------------------------- | ---------- | ------ |
+| popout-class      | 弹窗框根元素类名                         | string     | -      |
+| popout-style      | 弹窗框根元素样式                         | StyleValue | -      |
+| visible (v-model) | 是否显示弹出框                           | boolean    | -      |
+| title             | 弹出框标题                               | string     | -      |
+| show-confirm      | 是否显示确定按钮，隐藏按钮可用于快捷选择 | boolean    | true   |
+| validate-event    | 是否触发表单验证                         | boolean    | true   |
+
+### CascaderPopoutSlots
+
+继承 [`CascaderSlots`](./cascader#CascaderSlots)
+
+### CascaderPopoutEmits
+
+| 事件               | 描述                     | 类型                                                                 |
+| ------------------ | ------------------------ | -------------------------------------------------------------------- |
+| update:model-value | 级联输入组件值改变时触发 | (value: string \| number, selectedOptions: CascaderOption[]) => void |
+| change             | 级联输入组件值改变时触发 | (value: string \| number, selectedOptions: CascaderOption[]) => void |
+| select             | 选择级联选择某一项时触发 | (option: CascaderOption, tabIndex: number) => void                   |
+| update:visible     | 弹出框显隐时触发         | (visible: boolean) => void                                           |

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

@@ -36,6 +36,25 @@ import {
 } from "./common";
 import { isEmptyBinding } from "../../utils";
 import { useFormPopout } from "../../use";
+/**
+ * @property {string} rootClass 组件根元素类名，默认值：-。
+ * @property {StyleValue} rootStyle 组件根元素样式，默认值：-。
+ * @property {string | number} modelValue 选中项的值，默认值：-。
+ * @property {CascaderOption[]} options 可选项数据源，默认值：[]。
+ * @property {CascaderFieldKeys} fieldKeys 自定义 `options` 中的字段，默认值：defaultFieldKeys。
+ * @property {string} hintText 未选中时的提示文案，默认值：'请选择'。
+ * @property {(option: CascaderOption) => string} labelRender 自定义可选项渲染，默认值：-。
+ * @property {boolean} changeOnSelect 点击每级选项都会触发变化，默认值：false。
+ * @property {string} popoutClass 弹窗框根元素类名，默认值：-。
+ * @property {StyleValue} popoutStyle 弹窗框根元素样式，默认值：-。
+ * @property {boolean} visible 是否显示弹出框，默认值：-。
+ * @property {string} title 弹出框标题，默认值：-。
+ * @property {boolean} showConfirm 是否显示确定按钮，隐藏按钮可用于快捷选择，默认值：true。
+ * @property {boolean} validateEvent 是否触发表单验证，默认值：true。
+ * @event {(visible: boolean) => void} update 弹出框显隐时触发
+ * @event {(value: string | number, selectedOptions: CascaderOption[]) => void} change 级联输入组件值改变时触发
+ * @event {(option: CascaderOption, tabIndex: number) => void} select 选择级联选择某一项时触发
+ */
 export default  _defineComponent({
   components: {
     SarPopout,