直接跳到内容

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

ToggleButtons 切换按钮已经加载完毕