直接跳到内容

RadioButtons 单选框

在一组备选项中进行单选

基础用法

单选框不应该有太多的可选项, 如果你有很多的可选项你应该使用 Select 选择框而不是单选框。
要使用 RadioButtons 组件,只需要设置v-model绑定变量, 选中意味着变量的值为对应选项的值。
选项 options 可以是标签的列表,也可以是 (标签、值) 形式的列表。

TIP

v-model 或初始值必须是 options 中的值。

禁用状态

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

自定义样式

您可以自定义输入框样式。
使用 style 属性额外配置样式:

  • description-width:label的宽度。

API

属性

属性名说明类型默认值
v-model/value绑定值any 
description标签文字str 
options选项列表list 
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/radio-buttons

RadioButtons 单选框已经加载完毕