跳到主要内容

Select 选择框

用于弹出一个下拉菜单给用户选择操作,用于代替原生的选择器,或者需要一个更优雅的多选器时。

何时使用

  • 弹出一个下拉菜单给用户选择操作,用于代替原生的选择器,或者需要一个更优雅的多选器时。
  • 当选项少时(少于 5 项),建议直接将选项平铺,使用 Radio 是更好的选择。

代码示例

基本使用

基本使用

多层级选择器

带图标选择器

API

SelectProps

参数说明类型默认值
arrow自定义下拉箭头ReactNode-
border是否显示边框booleantrue
options下拉选项Array<ItemProps>-
placeholder占位符string-
prefixIcon是否显示前缀图标booleanfalse
onChange选择项变化时的回调(value: string) => void()=>{}

SelectOptionProps

参数说明类型默认值
config配置项OptionConfig-
isSelectOpen是否展开boolean-
level层级number-
onToggle展开/收起时的回调React.Dispatch<React.SetStateAction<boolean>>-
onClick点击时的回调(e: React.MouseEvent, value: string, label: string) => void-
interface OptionConfig {
width: number;
left: number;
bottom: number;
height: number;
}

SubItemProps

参数说明类型默认值
label标签string-
options选项Array<ItemProps>-
prefixIcon前缀图标ReactNode-

ItemProps

参数说明类型默认值
arrow箭头图标ReactNode-
label标签string-
options选项Array<ItemProps>-
prefixIcon前缀图标ReactNode-
valuestring-
onClick点击时的回调(e: React.MouseEvent, value: string, label: string) => void-
onMouseEnter鼠标移入时的回调MouseEventHandler-
onMouseLeave鼠标移出时的回调MouseEventHandler-