跳转到内容

Segmented 分段控制器

何时使用

  • 用于展示多个选项并允许用户选择其中单个选项;
  • 当切换选中选项时,关联区域的内容会发生变化。

代码演示

基本

loading

垂直方向

loading

Block 分段选择器<

loading

胶囊形状

loading

不可用

loading

自定义渲染

loading

动态数据

loading

三种大小

loading

设置图标

loading

配合 name 使用

loading

API

Segmented

参数说明类型默认值版本
block将宽度调整为父元素宽度的选项booleanfalse
disabled是否禁用booleanfalse
onChange选项变化时的回调函数function(value: string | number)
options数据化配置选项内容string[] | number[] | SegmentedItemType[][]
orientation排列方向horizontal | verticalhorizontal
size控件尺寸large | middle | smallmiddle
vertical排列方向,与 orientation 同时存在,以 orientation 优先booleanfalse5.21.0
value(v-model)当前选中的值string | number
shape形状default | rounddefault5.24.0
nameSegmented 下所有 input[type="radio"]name 属性。若未设置,则将回退到随机生成的名称string5.23.0

SegmentedItemType

属性描述类型默认值版本
className自定义类名string-
disabled分段项的禁用状态booleanfalse
icon分段项的显示图标ReactNode-
label分段项的显示文本ReactNode-
tooltip分段项的工具提示string | TooltipProps-
value分段项的值string | number-

基于 MIT 许可发布