跳转到正文

组件

切换组

一组可执行单选或多选的切换控件。

用法

基础

HTML
<bs:bsui-toggle-group defaultValue="center">
  <bs:bsui-toggle-group-item value="left" label="Left" />
  <bs:bsui-toggle-group-item value="center" label="Center" />
  <bs:bsui-toggle-group-item value="right" label="Right" />
</bs:bsui-toggle-group>

多选

可以同时按下任意数量的项目。

HTML
<bs:bsui-toggle-group multiple="true" defaultValue="bold">
  <bs:bsui-toggle-group-item value="bold" label="Bold" />
  <bs:bsui-toggle-group-item value="italic" label="Italic" />
  <bs:bsui-toggle-group-item value="underline" label="Underline" />
</bs:bsui-toggle-group>

垂直

同一组选项纵向排列,适用于侧边栏而非工具栏。

HTML
<bs:bsui-toggle-group orientation="vertical" defaultValue="list">
  <bs:bsui-toggle-group-item value="list" label="List" />
  <bs:bsui-toggle-group-item value="board" label="Board" />
  <bs:bsui-toggle-group-item value="calendar" label="Calendar" />
</bs:bsui-toggle-group>

不可用选项

可以禁用单个选项,同时保留其他选项供选择。

HTML
<bs:bsui-toggle-group defaultValue="monthly">
  <bs:bsui-toggle-group-item value="monthly" label="Monthly" />
  <bs:bsui-toggle-group-item value="yearly" label="Yearly" />
  <bs:bsui-toggle-group-item value="lifetime" label="Lifetime" disabled="true" />
</bs:bsui-toggle-group>

结构

切换组由以下区块组成。每个区块都是独立的区块,只会在其父级内部渲染。

  • bsui/toggle-group
  • bsui/toggle-group-item

属性

属性类型默认
defaultValue text —
multiple toggle false
orientation horizontal vertical horizontal

bsui/toggle-group-item

属性类型默认
value text —
label richtext —
disabled toggle false