eo-select
<eo-select>
Alias:
<form.general-select>
表单下拉选择构件。
Examples
Label
Value
Options
Disabled
Multiple
Tags
Placeholder
Suffix
GroupBy
Fields
UseBackend
Input Style
Event
With Form
Properties
Name | Description | Type | Default | Required |
---|---|---|---|---|
name | 字段名称 | string | ||
placeholder | 占位说明 | string | ||
label | 字段文本 | string | ||
options | 选项列表 | GeneralComplexOption[] | ✅ | |
value | 值 | any | ||
required | 是否必填 | boolean | ||
message | 校验文本信息 | Record<string, string> | ||
disabled | 是否禁用 | boolean | ||
mode | 类型 | "tags" | "multiple" | ||
tokenSeparators | 自动分词的分隔符,仅在 mode="tags" 时生效 | string[] | ||
maxTagCount | 最多显示多少个 tag, 剩余的 tag 将被隐藏 | number | ||
groupBy | 分组字段 | string | ||
suffix | { useBrick: UseSingleBrickConf } | |||
clearable | 是否支持清除 | boolean | true | |
fields | 列表指定字段作为 label 和 value | { label?: string; value?: string } | ||
useBackend | 后端搜索 | UseBackendConf | ||
debounceSearchDelay | 设置时,同时对 useBackend 和 search 事件进行防抖。 未设置时,useBackend 有默认的 300ms 防抖。 | number | ||
inputStyle | 输入框样式 | React.CSSProperties |
Events
Name | Description | Event Detail |
---|---|---|
change | 下拉选择事件 | { value: string | string[]; options: GeneralComplexOption[] } |
search | 下拉框search事件 | { value: string } |
select.focus | 下拉框focus事件 注:之前事件类型为 "focus",这和原生事件冲突,可能导致多次触发,现改为 "select.focus" | void |
options.change | 选项列表变化事件 | { options: { label: string; value: any; [key: string]: any }; name: string } |
Type references
GeneralComplexOption
<T = string | number | boolean>
Name | Type | Required | Description |
---|---|---|---|
label | string | ✅ | |
value | T | ✅ | |
[key: string] | any |
UseBackendConf
Name | Type | Required | Description |
---|---|---|---|
provider | string | ✅ | |
args | any[] | ((...args: any[]) => any[]) | ✅ | |
transform | (data: any) => void |