Flutter | 1.9 全新组件 ToggleButtons

2726次阅读 | 发布于4年以前

前几天的 GDD 相信大家还记忆犹新，Flutter 官宣发布了 1.9 正式版。

随之而来的有一些全新的组件和对于 web 的支持等等。

那我们今天就来看一下这其中的一个组件 --「ToggleButtons」。

ToggleButtons

首先按照惯例，看看官方对于这个组件是怎么说的：

Creates a horizontal set of toggle buttons.

It displays its widgets provided in a [List] of [children] horizontally.

创建一组水平的切换按钮。

它水平的显示 children 列表中提供的小部件。

其实这段文本是在源码中翻出来的，现在在网上搜「ToggleButtons」还是搜不出来官方文档的。

构造函数

还是按照惯例看一下构造函数：

const ToggleButtons({
  Key key,
  @required this.children,
  @required this.isSelected,
  this.onPressed,
  this.color,
  this.selectedColor,
  this.disabledColor,
  this.fillColor,
  this.focusColor,
  this.highlightColor,
  this.hoverColor,
  this.splashColor,
  this.focusNodes,
  this.renderBorder = true,
  this.borderColor,
  this.selectedBorderColor,
  this.disabledBorderColor,
  this.borderRadius,
  this.borderWidth,
}) :
assert(children != null),
assert(isSelected != null),
assert(children.length == isSelected.length),
super(key: key);

解释一下每个参数：

1.children：不多介绍了，一个 Widget 的集合
2.isSelected：List，每个切换按钮相应的状态，true 为选中，该字段的长度必须和 children 的长度一致
3.onPressed：切换按钮的点击事件，如果为 null，则该控件的状态为 disable
4.color：Text / Icon 状态为已启用并且未选中时的颜色
5.selectedColor：不用多说，选中时的颜色
6.disabledColor：未启用时的颜色
7.fillColor：选中按钮的背景颜色
8.focusColor：当按钮中具有输入焦点时填充的颜色
9.highlightColor：点击时的颜色
10.hoverColor：当按钮上有指针悬停时用于填充按钮的颜色
11.splashColor：点击后的颜色
12.focusNodes：每一个按钮的焦点
13.renderBorder：是否在每个切换按钮周围呈现边框
14.borderColor：边框颜色
15.selectedBorderColor：选中的边框颜色
16.disabledBorderColor：不可用时边框颜色
17.borderRadius：边框半径
18.borderWidth：边框宽度

这参数太多了，但是其实也没什么难度。

第一个示例

在组件介绍的下面有很多的代码，我们一一来看。

先看第一个：

Here is an implementation that allows for multiple buttons to be simultaneously selected, while requiring none of the buttons to be selected.

这里有一个实现，它允许同时选择多个按钮，而不需要选择任何一个按钮。

看一下代码：

List<bool> isSelected = [true, false, false];

ToggleButtons(
  children: <Widget>[
    Icon(Icons.ac_unit),
    Icon(Icons.call),
    Icon(Icons.cake),
  ],
  onPressed: (int index) {
    setState(() {
      isSelected[index] = !isSelected[index];
    });
  },
  isSelected: isSelected,
),

运行效果如下：

其中最重要的代码就是：

1.添加了「onPress」方法
2.在「onPress」回调中刷新每一个切换按钮的值

第二个示例

再来看第二个示例：

Here is an implementation that requires mutually exclusive selection, but allows for none of the buttons to be selected.

这是一个互斥选择的实现，但允许一个都不选择。

代码如下：

ToggleButtons(
  children: <Widget>[
    Icon(Icons.ac_unit),
    Icon(Icons.call),
    Icon(Icons.cake),
  ],
  onPressed: (int index) {
    setState(() {
      for (int buttonIndex = 0; buttonIndex < isSelected.length; buttonIndex++) {
        if (buttonIndex == index) {
          isSelected[buttonIndex] = !isSelected[buttonIndex];
        } else {
          isSelected[buttonIndex] = false;
        }
      }
    });
  },
  isSelected: isSelected,
),

效果如下：

该示例展示了只能选择一个、并且可以不选 demo，主要逻辑如下：

循环所有的切换按钮的值，如果是当前 index，则置反，如果不是，则置为 false。

第三个示例

最后一个示例，