- category: Components
- family: General
- chinese: 分隔按钮
- type: 基本
SplitButton 同样由 Button 和 Menu 组成，其在触发区域上可以分为两部分，其中 Icon 部分作为弹层菜单的触发区域。 菜单只有在鼠标悬浮或点击右侧图标区域的时候才会展示。
| 参数 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| size | 按钮组的尺寸 可选值: 'small', 'medium', 'large' |
Enum | 'medium' |
| type | 按钮的类型 可选值: 'normal', 'primary', 'secondary' |
Enum | 'normal' |
| label | 主按钮的文案 | ReactNode | - |
| component | 设置标签类型 可选值: 'button', 'a' |
Enum | - |
| ghost | 是否为幽灵按钮 可选值: 'light', 'dark', false, true |
Enum | - |
| defaultSelectedKeys | 默认激活的菜单项（用法同 Menu 非受控） | Array | [] |
| selectedKeys | 激活的菜单项（用法同 Menu 受控） | Array | - |
| selectMode | 菜单的选择模式 可选值: 'single', 'multiple' |
Enum | - |
| onSelect | 选择菜单项时的回调，参考 Menu 签名: Function() => void |
Function | func.noop |
| onItemClick | 点击菜单项时的回调，参考 Menu 签名: Function() => void |
Function | func.noop |
| triggerProps | 触发按钮的属性（支持 Button 的所有属性透传） | Object | - |
| autoWidth | 弹层菜单的宽度是否与按钮组一致 | Boolean | true |
| visible | 弹层是否显示 | Boolean | - |
| defaultVisible | 弹层默认是否显示 | Boolean | - |
| onVisibleChange | 弹层显示状态变化时的回调函数 签名: Function(visible: Boolean, type: String) => void 参数: visible: {Boolean} 弹层显示状态 type: {String} 触发弹层显示或隐藏的来源 menuSelect 表示由menu触发； fromTrigger 表示由trigger的点击触发； docClick 表示由document的点击触发 |
Function | func.noop |
| popupTriggerType | 弹层的触发方式 可选值: 'click', 'hover' |
Enum | 'click' |
| popupAlign | 弹层对齐方式, 详情见Overlay align | String | - |
| popupStyle | 弹层自定义样式 | Object | - |
| popupClassName | 弹层自定义样式类 | String | - |
| popupProps | 透传给弹层的属性 | Object | - |
| followTrigger | 是否跟随滚动 | Boolean | - |
| menuProps | 透传给 Menu 的属性 | Object | {} |
| leftButtonProps | 透传给 左侧按钮 的属性 | Object | {} |