直接跳到内容

ToggleButton 按钮

表示两种相互对立的状态间的切换,多用于触发「开/关」。

基础用法

绑定 v-model 到一个 Boolean 类型的变量。 点击后变量值取反,当变量为 TrueFalse 时背景色不同。

禁用状态

你可以使用 disabled 属性来定义按钮是否被禁用。
使用 disabled 属性来控制按钮是否为禁用状态。该属性接受一个 bool 类型的值。

提示信息

通过 tooltip 属性在鼠标 hover 时展示提示信息。

图标按钮

使用图标为按钮添加更多的含义。你也可以单独使用图标不添加文字来节省显示区域占用。
使用 icon 属性来为按钮添加图标。请参阅 fontawesome 页面获取可用图标。

调整尺寸

除了默认的大小,按钮组件还提供了自定义尺寸能力,以便适配不同的场景。
使用 style 属性额外配置尺寸:

  • widthheight 指定大小,可使用px%auto等形式。

自定义颜色

您可以自定义按钮的颜色。
使用 style 属性额外配置颜色:

  • color 设置文字颜色,可使用#ffffffblue等和 css 兼容的形式。

API

属性

属性名说明类型默认值
v-model/value开关状态绑定值bool false
label按钮文字str 
icon按钮图标str 
type类型enum 
tooltip提示信息str 
disabled按钮是否为禁用状态bool 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

方法

属性名说明类型

src/examples/ipywui/component/toggle-button

ToggleButton 按钮已经加载完毕