跳到主要内容

eo-select

<eo-select>
Alias: <form.general-select>

表单下拉选择构件。

Playground

Examples

Label

Playground

Value

Playground

Options

Playground

Disabled

Playground

Multiple

Playground

Tags

Playground

Placeholder

Playground

Suffix

Playground

GroupBy

Playground

Fields

Playground

UseBackend

Playground

Input Style

Playground

Event

Playground

With Form

Playground

Properties

NameDescriptionTypeDefaultRequired
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

NameDescriptionEvent 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>
NameTypeRequiredDescription
labelstring
valueT
[key: string]any

UseBackendConf

NameTypeRequiredDescription
providerstring
argsany[] | ((...args: any[]) => any[])
transform(data: any) => void