From c6e43f4938014429086426b7b1af6e8c870b27aa Mon Sep 17 00:00:00 2001 From: anlyyao Date: Tue, 2 Jun 2026 15:16:54 +0800 Subject: [PATCH] feat(Cascader): add the filterable, filterPlaceholder, and filter properties --- db/TDesign.db | Bin 1142784 -> 1142784 bytes .../components/cascader/README.en-US.md | 4 + .../packages/components/cascader/README.md | 4 + .../packages/components/cascader/props.ts | 14 ++ .../packages/components/cascader/type.ts | 31 ++++- .../cascader/README.en-US.md | 3 + .../uniapp-components/cascader/README.md | 3 + .../uniapp-components/cascader/props.ts | 11 ++ .../uniapp-components/cascader/type.ts | 20 +++ .../src/cascader/cascader.en-US.md | 3 + .../src/cascader/cascader.md | 3 + .../src/cascader/defaultProps.ts | 1 + .../tdesign-mobile-react/src/cascader/type.ts | 20 +++ .../src/cascader/cascader.en-US.md | 3 + .../src/cascader/cascader.md | 3 + .../tdesign-mobile-vue/src/cascader/props.ts | 11 ++ .../tdesign-mobile-vue/src/cascader/type.ts | 20 +++ packages/scripts/api.json | 129 ++++++++++++++++++ 18 files changed, 282 insertions(+), 1 deletion(-) diff --git a/db/TDesign.db b/db/TDesign.db index 74909f8b5e0402a03458837fff471337d0eeaf24..119d5a446d3db3608318fa389350c96d012199f7 100644 GIT binary patch delta 840 zcmZp8;M(xOb%Hcw{zMsP#{9;F)&$1Z1g6#m=GFw3)&$np1h&=$_SOWB)&$Ph1g_Qu z?$!jJ)&$2(>;K0PjtHvwCD>QwdlYrUw4Nd~# zoa}rVw*xr%uT4+r=U*^=osU3=J17E=_ zLSme36%73DyvKRgb3foPn?MG6Wp+E+bYH|xpH&KLXJpY2}qw0-Zh zsT&?QG`-kA<>~Bs3MECQsR}O^u6Vv=*VCSzFI#)x@9B9qXVr^!`=0Mz_iXyMCwuol zpR(d@=V?|iX+{nLFdPj;+**4glEPNzanVp3|3!n5u@ z&-#`=ozVBRan{o%%b#xOf7&+l$&TJ+J6brcE`OESr)w2n6o^M(7 zY+>7U$5>WTFI1nK7+RU21qN8CQDTvv6v#qFMseOoMhqLPzA)UF?l6%>JrEe9PxmxD wov = (keyword: string, option: CascaderOption, path: CascaderOption[]) => boolean`。[see more ts definition](https://github.com/Tencent/tdesign-miniprogram/blob/develop/packages/components/common/common.ts)。[see more ts definition](https://github.com/Tencent/tdesign-miniprogram/blob/develop/packages/components/cascader/type.ts) | N +filter-placeholder | String | - | \- | N +filterable | Boolean | false | \- | N keys | Object | - | Typescript: `CascaderKeysType` `type CascaderKeysType = TreeKeysType`。[see more ts definition](https://github.com/Tencent/tdesign-miniprogram/blob/develop/packages/components/common/common.ts)。[see more ts definition](https://github.com/Tencent/tdesign-miniprogram/blob/develop/packages/components/cascader/type.ts) | N options | Array | [] | Typescript: `Array` | N placeholder | String | - | \- | N @@ -25,6 +28,7 @@ visible | Boolean | false | \- | N name | params | description -- | -- | -- change | `(value: string \| number, selectedOptions: string[])` | `1.0.1` +change | `(detail: { value: string \| number, selectedOptions: string[] })` | `1.0.1` close | `(trigger: CascaderTriggerSource)` | `1.0.1`。[see more ts definition](https://github.com/Tencent/tdesign-miniprogram/blob/develop/packages/components/cascader/type.ts)。
`type CascaderTriggerSource = 'overlay' \| 'close-btn' \| 'finish'`
pick | `(value: string \| number, label: string, index: number, level: number)` | `1.0.1` diff --git a/packages/products/tdesign-miniprogram/packages/components/cascader/README.md b/packages/products/tdesign-miniprogram/packages/components/cascader/README.md index f5d460644..510becd92 100644 --- a/packages/products/tdesign-miniprogram/packages/components/cascader/README.md +++ b/packages/products/tdesign-miniprogram/packages/components/cascader/README.md @@ -10,6 +10,9 @@ style | Object | - | 样式 | N custom-style | Object | - | 样式，一般用于开启虚拟化组件节点场景 | N check-strictly | Boolean | false | 父子节点选中状态不再关联，可各自选中或取消 | N close-btn | Boolean | true | 关闭按钮 | N +filter | Function | - | 自定义过滤函数。返回 true 表示匹配，未设置时使用内置匹配规则：对路径中所有 label 拼接后做大小写不敏感的 includes 匹配。TS 类型：`CascaderFilterFunction ` `type CascaderFilterFunction = (keyword: string, option: CascaderOption, path: CascaderOption[]) => boolean`。[通用类型定义](https://github.com/Tencent/tdesign-miniprogram/blob/develop/packages/components/common/common.ts)。[详细类型定义](https://github.com/Tencent/tdesign-miniprogram/blob/develop/packages/components/cascader/type.ts) | N +filter-placeholder | String | - | 搜索框占位符描述文本 | N +filterable | Boolean | false | 是否可搜索，开启后顶部会展示一个搜索框 | N keys | Object | - | 用来定义 value / label / children / disabled 在 `options` 中对应的字段别名。TS 类型：`CascaderKeysType` `type CascaderKeysType = TreeKeysType`。[通用类型定义](https://github.com/Tencent/tdesign-miniprogram/blob/develop/packages/components/common/common.ts)。[详细类型定义](https://github.com/Tencent/tdesign-miniprogram/blob/develop/packages/components/cascader/type.ts) | N options | Array | [] | 可选项数据源。TS 类型：`Array` | N placeholder | String | - | 未选中时的提示文案。组件内置默认值为：'选择选项' | N @@ -25,6 +28,7 @@ visible | Boolean | false | 是否展示 | N 名称 | 参数 | 描述 -- | -- | -- change | `(value: string \| number, selectedOptions: string[])` | `1.0.1`。值发生变更时触发 +change | `(detail: { value: string \| number, selectedOptions: string[] })` | `1.0.1`。值发生变更时触发 close | `(trigger: CascaderTriggerSource)` | `1.0.1`。关闭时触发。[详细类型定义](https://github.com/Tencent/tdesign-miniprogram/blob/develop/packages/components/cascader/type.ts)。
`type CascaderTriggerSource = 'overlay' \| 'close-btn' \| 'finish'`
pick | `(value: string \| number, label: string, index: number, level: number)` | `1.0.1`。选择后触发 diff --git a/packages/products/tdesign-miniprogram/packages/components/cascader/props.ts b/packages/products/tdesign-miniprogram/packages/components/cascader/props.ts index c4f805994..01066b3fb 100644 --- a/packages/products/tdesign-miniprogram/packages/components/cascader/props.ts +++ b/packages/products/tdesign-miniprogram/packages/components/cascader/props.ts @@ -16,6 +16,20 @@ const props: TdCascaderProps = { type: Boolean, value: true, }, + /** 自定义过滤函数。返回 true 表示匹配，未设置时使用内置匹配规则：对路径中所有 label 拼接后做大小写不敏感的 includes 匹配 */ + filter: { + type: null, + }, + /** 搜索框占位符描述文本 */ + filterPlaceholder: { + type: String, + value: '', + }, + /** 是否可搜索，开启后顶部会展示一个搜索框 */ + filterable: { + type: Boolean, + value: false, + }, /** 用来定义 value / label / children / disabled 在 `options` 中对应的字段别名 */ keys: { type: Object, diff --git a/packages/products/tdesign-miniprogram/packages/components/cascader/type.ts b/packages/products/tdesign-miniprogram/packages/components/cascader/type.ts index 2fa8e0c62..f3dea9c22 100644 --- a/packages/products/tdesign-miniprogram/packages/components/cascader/type.ts +++ b/packages/products/tdesign-miniprogram/packages/components/cascader/type.ts @@ -4,7 +4,7 @@ * 该文件为脚本自动生成文件，请勿随意修改。如需修改请联系 PMC * */ -import { TreeOptionData, TreeKeysType } from '../common/common'; +import type { TreeOptionData, TreeKeysType } from '../common/common'; export interface TdCascaderProps { /** @@ -23,6 +23,29 @@ export interface TdCascaderProps = ( + keyword: string, + option: CascaderOption, + path: CascaderOption[], +) => boolean; + export type CascaderKeysType = TreeKeysType; diff --git a/packages/products/tdesign-miniprogram/packages/uniapp-components/cascader/README.en-US.md b/packages/products/tdesign-miniprogram/packages/uniapp-components/cascader/README.en-US.md index ea32bac7a..38ff49c3a 100644 --- a/packages/products/tdesign-miniprogram/packages/uniapp-components/cascader/README.en-US.md +++ b/packages/products/tdesign-miniprogram/packages/uniapp-components/cascader/README.en-US.md @@ -9,6 +9,9 @@ name | type | default | description | required custom-style | Object | - | CSS(Cascading Style Sheets) | N check-strictly | Boolean | false | \- | N close-btn | Boolean | true | \- | N +filter | Function | - | Typescript: `CascaderFilterFunction ` `type CascaderFilterFunction = (keyword: string, option: CascaderOption, path: CascaderOption[]) => boolean`。[see more ts definition](https://github.com/tencent/tdesign-miniprogram/blob/develop/packages/uniapp-components/common/common.ts)。[see more ts definition](https://github.com/tencent/tdesign-miniprogram/blob/develop/packages/uniapp-components/cascader/type.ts) | N +filter-placeholder | String | - | \- | N +filterable | Boolean | false | \- | N keys | Object | - | Typescript: `CascaderKeysType` `type CascaderKeysType = TreeKeysType`。[see more ts definition](https://github.com/tencent/tdesign-miniprogram/blob/develop/packages/uniapp-components/common/common.ts)。[see more ts definition](https://github.com/tencent/tdesign-miniprogram/blob/develop/packages/uniapp-components/cascader/type.ts) | N options | Array | [] | Typescript: `Array` | N placeholder | String | - | \- | N diff --git a/packages/products/tdesign-miniprogram/packages/uniapp-components/cascader/README.md b/packages/products/tdesign-miniprogram/packages/uniapp-components/cascader/README.md index 600b73904..5834e0465 100644 --- a/packages/products/tdesign-miniprogram/packages/uniapp-components/cascader/README.md +++ b/packages/products/tdesign-miniprogram/packages/uniapp-components/cascader/README.md @@ -9,6 +9,9 @@ custom-style | Object | - | 自定义样式 | N check-strictly | Boolean | false | 父子节点选中状态不再关联，可各自选中或取消 | N close-btn | Boolean | true | 关闭按钮 | N +filter | Function | - | 自定义过滤函数。返回 true 表示匹配，未设置时使用内置匹配规则：对路径中所有 label 拼接后做大小写不敏感的 includes 匹配。TS 类型：`CascaderFilterFunction ` `type CascaderFilterFunction = (keyword: string, option: CascaderOption, path: CascaderOption[]) => boolean`。[通用类型定义](https://github.com/tencent/tdesign-miniprogram/blob/develop/packages/uniapp-components/common/common.ts)。[详细类型定义](https://github.com/tencent/tdesign-miniprogram/blob/develop/packages/uniapp-components/cascader/type.ts) | N +filter-placeholder | String | - | 搜索框占位符描述文本 | N +filterable | Boolean | false | 是否可搜索，开启后顶部会展示一个搜索框 | N keys | Object | - | 用来定义 value / label / children / disabled 在 `options` 中对应的字段别名。TS 类型：`CascaderKeysType` `type CascaderKeysType = TreeKeysType`。[通用类型定义](https://github.com/tencent/tdesign-miniprogram/blob/develop/packages/uniapp-components/common/common.ts)。[详细类型定义](https://github.com/tencent/tdesign-miniprogram/blob/develop/packages/uniapp-components/cascader/type.ts) | N options | Array | [] | 可选项数据源。TS 类型：`Array` | N placeholder | String | - | 未选中时的提示文案。组件内置默认值为：'选择选项' | N diff --git a/packages/products/tdesign-miniprogram/packages/uniapp-components/cascader/props.ts b/packages/products/tdesign-miniprogram/packages/uniapp-components/cascader/props.ts index 0345c4b9f..17d698bd1 100644 --- a/packages/products/tdesign-miniprogram/packages/uniapp-components/cascader/props.ts +++ b/packages/products/tdesign-miniprogram/packages/uniapp-components/cascader/props.ts @@ -13,6 +13,17 @@ export default { type: Boolean, default: true as TdCascaderProps['closeBtn'], }, + /** 自定义过滤函数。返回 true 表示匹配，未设置时使用内置匹配规则：对路径中所有 label 拼接后做大小写不敏感的 includes 匹配 */ + filter: { + type: Function, + }, + /** 搜索框占位符描述文本 */ + filterPlaceholder: { + type: String, + default: '', + }, + /** 是否可搜索，开启后顶部会展示一个搜索框 */ + filterable: Boolean, /** 用来定义 value / label / children / disabled 在 `options` 中对应的字段别名 */ keys: { type: Object, diff --git a/packages/products/tdesign-miniprogram/packages/uniapp-components/cascader/type.ts b/packages/products/tdesign-miniprogram/packages/uniapp-components/cascader/type.ts index 94e25648a..6cfdbc08a 100644 --- a/packages/products/tdesign-miniprogram/packages/uniapp-components/cascader/type.ts +++ b/packages/products/tdesign-miniprogram/packages/uniapp-components/cascader/type.ts @@ -18,6 +18,20 @@ export interface TdCascaderProps void; } +export type CascaderFilterFunction = ( + keyword: string, + option: CascaderOption, + path: CascaderOption[], +) => boolean; + export type CascaderKeysType = TreeKeysType; export type CascaderTriggerSource = 'overlay' | 'close-btn' | 'finish'; diff --git a/packages/products/tdesign-mobile-react/src/cascader/cascader.en-US.md b/packages/products/tdesign-mobile-react/src/cascader/cascader.en-US.md index e0067db47..7e1ede607 100644 --- a/packages/products/tdesign-mobile-react/src/cascader/cascader.en-US.md +++ b/packages/products/tdesign-mobile-react/src/cascader/cascader.en-US.md @@ -10,6 +10,9 @@ className | String | - | className of component | N style | Object | - | CSS(Cascading Style Sheets)，Typescript: `React.CSSProperties` | N checkStrictly | Boolean | false | \- | N closeBtn | TNode | true | Typescript: `boolean \| TNode`。[see more ts definition](https://github.com/Tencent/tdesign-mobile-react/blob/develop/src/common.ts) | N +filter | Function | - | Typescript: `CascaderFilterFunction ` `type CascaderFilterFunction = (keyword: string, option: CascaderOption, path: CascaderOption[]) => boolean`。[see more ts definition](https://github.com/Tencent/tdesign-mobile-react/blob/develop/src/common.ts)。[see more ts definition](https://github.com/Tencent/tdesign-mobile-react/tree/develop/src/cascader/type.ts) | N +filterPlaceholder | String | - | \- | N +filterable | Boolean | false | \- | N header | TElement | - | `0.21.2`。Typescript: `TNode`。[see more ts definition](https://github.com/Tencent/tdesign-mobile-react/blob/develop/src/common.ts) | N keys | Object | - | Typescript: `CascaderKeysType` `type CascaderKeysType = TreeKeysType`。[see more ts definition](https://github.com/Tencent/tdesign-mobile-react/blob/develop/src/common.ts)。[see more ts definition](https://github.com/Tencent/tdesign-mobile-react/tree/develop/src/cascader/type.ts) | N lazy | Boolean | false | \- | N diff --git a/packages/products/tdesign-mobile-react/src/cascader/cascader.md b/packages/products/tdesign-mobile-react/src/cascader/cascader.md index 40572adcc..442000ddb 100644 --- a/packages/products/tdesign-mobile-react/src/cascader/cascader.md +++ b/packages/products/tdesign-mobile-react/src/cascader/cascader.md @@ -10,6 +10,9 @@ className | String | - | 类名 | N style | Object | - | 样式，TS 类型：`React.CSSProperties` | N checkStrictly | Boolean | false | 父子节点选中状态不再关联，可各自选中或取消 | N closeBtn | TNode | true | 关闭按钮。TS 类型：`boolean \| TNode`。[通用类型定义](https://github.com/Tencent/tdesign-mobile-react/blob/develop/src/common.ts) | N +filter | Function | - | 自定义过滤函数。返回 true 表示匹配，未设置时使用内置匹配规则：对路径中所有 label 拼接后做大小写不敏感的 includes 匹配。TS 类型：`CascaderFilterFunction ` `type CascaderFilterFunction = (keyword: string, option: CascaderOption, path: CascaderOption[]) => boolean`。[通用类型定义](https://github.com/Tencent/tdesign-mobile-react/blob/develop/src/common.ts)。[详细类型定义](https://github.com/Tencent/tdesign-mobile-react/tree/develop/src/cascader/type.ts) | N +filterPlaceholder | String | - | 搜索框占位符描述文本 | N +filterable | Boolean | false | 是否可搜索，开启后顶部会展示一个搜索框 | N header | TElement | - | `0.21.2`。头部。TS 类型：`TNode`。[通用类型定义](https://github.com/Tencent/tdesign-mobile-react/blob/develop/src/common.ts) | N keys | Object | - | 用来定义 value / label / children / disabled 在 `options` 中对应的字段别名。TS 类型：`CascaderKeysType` `type CascaderKeysType = TreeKeysType`。[通用类型定义](https://github.com/Tencent/tdesign-mobile-react/blob/develop/src/common.ts)。[详细类型定义](https://github.com/Tencent/tdesign-mobile-react/tree/develop/src/cascader/type.ts) | N lazy | Boolean | false | 是否异步加载 | N diff --git a/packages/products/tdesign-mobile-react/src/cascader/defaultProps.ts b/packages/products/tdesign-mobile-react/src/cascader/defaultProps.ts index 590658565..0b82af6f7 100644 --- a/packages/products/tdesign-mobile-react/src/cascader/defaultProps.ts +++ b/packages/products/tdesign-mobile-react/src/cascader/defaultProps.ts @@ -7,6 +7,7 @@ import { TdCascaderProps } from './type'; export const cascaderDefaultProps: TdCascaderProps = { checkStrictly: false, closeBtn: true, + filterable: false, lazy: false, loadCompleted: false, options: [], diff --git a/packages/products/tdesign-mobile-react/src/cascader/type.ts b/packages/products/tdesign-mobile-react/src/cascader/type.ts index 0f47f5a51..ed34a7036 100644 --- a/packages/products/tdesign-mobile-react/src/cascader/type.ts +++ b/packages/products/tdesign-mobile-react/src/cascader/type.ts @@ -18,6 +18,20 @@ export interface TdCascaderProps void; } +export type CascaderFilterFunction = ( + keyword: string, + option: CascaderOption, + path: CascaderOption[], +) => boolean; + export type CascaderKeysType = TreeKeysType; export type CascaderTriggerSource = 'overlay' | 'close-btn' | 'finish'; diff --git a/packages/products/tdesign-mobile-vue/src/cascader/cascader.en-US.md b/packages/products/tdesign-mobile-vue/src/cascader/cascader.en-US.md index 5a11ac685..fa1c95cf2 100644 --- a/packages/products/tdesign-mobile-vue/src/cascader/cascader.en-US.md +++ b/packages/products/tdesign-mobile-vue/src/cascader/cascader.en-US.md @@ -8,6 +8,9 @@ name | type | default | description | required -- | -- | -- | -- | -- checkStrictly | Boolean | false | \- | N closeBtn | Boolean / Slot / Function | true | Typescript: `boolean \| TNode`。[see more ts definition](https://github.com/Tencent/tdesign-mobile-vue/blob/develop/src/common.ts) | N +filter | Function | - | Typescript: `CascaderFilterFunction ` `type CascaderFilterFunction = (keyword: string, option: CascaderOption, path: CascaderOption[]) => boolean`。[see more ts definition](https://github.com/Tencent/tdesign-mobile-vue/blob/develop/src/common.ts)。[see more ts definition](https://github.com/Tencent/tdesign-mobile-vue/tree/develop/src/cascader/type.ts) | N +filterPlaceholder | String | - | \- | N +filterable | Boolean | false | \- | N header | Slot / Function | - | `1.11.0`。Typescript: `TNode`。[see more ts definition](https://github.com/Tencent/tdesign-mobile-vue/blob/develop/src/common.ts) | N keys | Object | - | Typescript: `CascaderKeysType` `type CascaderKeysType = TreeKeysType`。[see more ts definition](https://github.com/Tencent/tdesign-mobile-vue/blob/develop/src/common.ts)。[see more ts definition](https://github.com/Tencent/tdesign-mobile-vue/tree/develop/src/cascader/type.ts) | N load | Function | - | `1.12.0`。loading subtree data (only effective when the node's children value is true)。Typescript: `(node: CascaderOption) => Promise>` | N diff --git a/packages/products/tdesign-mobile-vue/src/cascader/cascader.md b/packages/products/tdesign-mobile-vue/src/cascader/cascader.md index c75692ed9..8d98f161e 100644 --- a/packages/products/tdesign-mobile-vue/src/cascader/cascader.md +++ b/packages/products/tdesign-mobile-vue/src/cascader/cascader.md @@ -8,6 +8,9 @@ -- | -- | -- | -- | -- checkStrictly | Boolean | false | 父子节点选中状态不再关联，可各自选中或取消 | N closeBtn | Boolean / Slot / Function | true | 关闭按钮。TS 类型：`boolean \| TNode`。[通用类型定义](https://github.com/Tencent/tdesign-mobile-vue/blob/develop/src/common.ts) | N +filter | Function | - | 自定义过滤函数。返回 true 表示匹配，未设置时使用内置匹配规则：对路径中所有 label 拼接后做大小写不敏感的 includes 匹配。TS 类型：`CascaderFilterFunction ` `type CascaderFilterFunction = (keyword: string, option: CascaderOption, path: CascaderOption[]) => boolean`。[通用类型定义](https://github.com/Tencent/tdesign-mobile-vue/blob/develop/src/common.ts)。[详细类型定义](https://github.com/Tencent/tdesign-mobile-vue/tree/develop/src/cascader/type.ts) | N +filterPlaceholder | String | - | 搜索框占位符描述文本 | N +filterable | Boolean | false | 是否可搜索，开启后顶部会展示一个搜索框 | N header | Slot / Function | - | `1.11.0`。头部。TS 类型：`TNode`。[通用类型定义](https://github.com/Tencent/tdesign-mobile-vue/blob/develop/src/common.ts) | N keys | Object | - | 用来定义 value / label / children / disabled 在 `options` 中对应的字段别名。TS 类型：`CascaderKeysType` `type CascaderKeysType = TreeKeysType`。[通用类型定义](https://github.com/Tencent/tdesign-mobile-vue/blob/develop/src/common.ts)。[详细类型定义](https://github.com/Tencent/tdesign-mobile-vue/tree/develop/src/cascader/type.ts) | N load | Function | - | `1.12.0`。加载子树数据的方法（仅当节点 children 为 true 时生效）。TS 类型：`(node: CascaderOption) => Promise>` | N diff --git a/packages/products/tdesign-mobile-vue/src/cascader/props.ts b/packages/products/tdesign-mobile-vue/src/cascader/props.ts index 8847e753f..913eb3875 100644 --- a/packages/products/tdesign-mobile-vue/src/cascader/props.ts +++ b/packages/products/tdesign-mobile-vue/src/cascader/props.ts @@ -15,6 +15,17 @@ export default { type: [Boolean, Function] as PropType, default: true as TdCascaderProps['closeBtn'], }, + /** 自定义过滤函数。返回 true 表示匹配，未设置时使用内置匹配规则：对路径中所有 label 拼接后做大小写不敏感的 includes 匹配 */ + filter: { + type: Function as PropType, + }, + /** 搜索框占位符描述文本 */ + filterPlaceholder: { + type: String, + default: '', + }, + /** 是否可搜索，开启后顶部会展示一个搜索框 */ + filterable: Boolean, /** 头部 */ header: { type: Function as PropType, diff --git a/packages/products/tdesign-mobile-vue/src/cascader/type.ts b/packages/products/tdesign-mobile-vue/src/cascader/type.ts index c474b0d94..bb9f8aadf 100644 --- a/packages/products/tdesign-mobile-vue/src/cascader/type.ts +++ b/packages/products/tdesign-mobile-vue/src/cascader/type.ts @@ -18,6 +18,20 @@ export interface TdCascaderProps void; } +export type CascaderFilterFunction = ( + keyword: string, + option: CascaderOption, + path: CascaderOption[], +) => boolean; + export type CascaderKeysType = TreeKeysType; export type CascaderTriggerSource = 'overlay' | 'close-btn' | 'finish'; diff --git a/packages/scripts/api.json b/packages/scripts/api.json index d5ee34980..0e6b080b3 100644 --- a/packages/scripts/api.json +++ b/packages/scripts/api.json @@ -22326,6 +22326,92 @@ "Function" ] }, + { + "id": 1780383135, + "platform_framework": [ + "8", + "16", + "64", + "128" + ], + "component": "Cascader", + "field_category": 1, + "field_name": "filter", + "field_type": [ + "32" + ], + "field_default_value": "", + "field_enum": "", + "field_desc_zh": " 自定义过滤函数。返回 true 表示匹配，未设置时使用内置匹配规则：对路径中所有 label 拼接后做大小写不敏感的 includes 匹配", + "field_desc_en": null, + "field_required": 0, + "event_input": "", + "create_time": "2026-06-02 06:52:15", + "update_time": "2026-06-02 06:52:15", + "event_output": null, + "custom_field_type": "CascaderFilterFunction 【type CascaderFilterFunction = (keyword: string, option: CascaderOption, path: CascaderOption[]) => boolean】", + "syntactic_sugar": null, + "readonly": 1, + "html_attribute": 0, + "trigger_elements": "", + "deprecated": 0, + "version": "", + "test_description": null, + "support_default_value": 0, + "field_category_text": "Props", + "platform_framework_text": [ + "Vue(Mobile)", + "React(Mobile)", + "Miniprogram", + "UniApp" + ], + "field_type_text": [ + "Function" + ] + }, + { + "id": 1780382505, + "platform_framework": [ + "8", + "16", + "64", + "128" + ], + "component": "Cascader", + "field_category": 1, + "field_name": "filterPlaceholder", + "field_type": [ + "1" + ], + "field_default_value": "", + "field_enum": "", + "field_desc_zh": "搜索框占位符描述文本", + "field_desc_en": null, + "field_required": 0, + "event_input": "", + "create_time": "2026-06-02 06:41:45", + "update_time": "2026-06-02 06:41:45", + "event_output": null, + "custom_field_type": null, + "syntactic_sugar": null, + "readonly": 1, + "html_attribute": 0, + "trigger_elements": "", + "deprecated": 0, + "version": "", + "test_description": null, + "support_default_value": 0, + "field_category_text": "Props", + "platform_framework_text": [ + "Vue(Mobile)", + "React(Mobile)", + "Miniprogram", + "UniApp" + ], + "field_type_text": [ + "String" + ] + }, { "id": 393, "platform_framework": [ @@ -22365,6 +22451,49 @@ "Boolean" ] }, + { + "id": 1780382452, + "platform_framework": [ + "8", + "16", + "64", + "128" + ], + "component": "Cascader", + "field_category": 1, + "field_name": "filterable", + "field_type": [ + "4" + ], + "field_default_value": "false", + "field_enum": "", + "field_desc_zh": "是否可搜索，开启后顶部会展示一个搜索框 ", + "field_desc_en": null, + "field_required": 0, + "event_input": "", + "create_time": "2026-06-02 06:40:52", + "update_time": "2026-06-02 06:40:52", + "event_output": null, + "custom_field_type": null, + "syntactic_sugar": null, + "readonly": 1, + "html_attribute": 0, + "trigger_elements": "", + "deprecated": 0, + "version": "", + "test_description": null, + "support_default_value": 0, + "field_category_text": "Props", + "platform_framework_text": [ + "Vue(Mobile)", + "React(Mobile)", + "Miniprogram", + "UniApp" + ], + "field_type_text": [ + "Boolean" + ] + }, { "id": 1745737040, "platform_framework": [