#header-mark#
ToggleButtons 切换按钮
在一组备选项中进行单选
基础用法
切换按钮不应该有太多的可选项, 如果你有很多的可选项你应该使用 Select
选择框而不是单选框。
要使用 ToggleButtons
组件,只需要设置v-model绑定变量, 选中意味着变量的值为对应选项的值。
选项 options
可以是标签的列表,也可以是 (标签、值)
形式的列表。
TIP
v-model
或初始值必须是 options 中的值。
使用图标为按钮添加更多的含义。 使用 icons
属性来为按钮添加图标。请参阅 fontawesome 页面获取可用图标。
禁用状态
你可以使用 disabled
属性来定义是否被禁用。
使用 disabled
属性来控制是否为禁用状态。该属性接受一个 bool
类型的值。
提示信息
通过 tooltips
属性在鼠标 hover 时展示提示信息。
自定义样式
您可以自定义切换按钮样式。
使用 style
属性额外配置样式:
button_width
:按钮的宽度,可使用px
、%
、auto
等形式。可使用px
、%
、auto
等形式。font_weight
:按钮字体的粗细。description-width
:label的宽度。
API
属性
属性名 | 说明 | 类型 | 默认值 |
---|---|---|---|
v-model/value | 绑定值 | any | — |
description | 标签文字 | str | — |
options | 选项列表 | list | — |
icons | 选项图标列表 | list | — |
tooltips | 选项提示信息列表 | str | — |
type | 按钮类型 | enum | — |
disabled | 是否为禁用状态 | boolean | false |
style | 自定义css样式 | str | - |
TIP
style 支持的其它css属性
Sizes相关
- height
- width
- max_height
- max_width
- min_height
- min_width
Display相关
- visibility
- display
- overflow
Box model相关
- border
- margin
- padding
Positioning相关
- top
- left
- bottom
- right
方法
属性名 | 说明 | 类型 |
---|---|---|
index | 当前选择的索引 | int |
label | 当前选择的标签 | --- |
value | 当前选择的值 | --- |
src/examples/ipywui/component/toggle-buttons