Flutter之基础Widget

发表于 2019-04-19 更新于 2023-01-20 分类于 Flutter 阅读次数：本文字数： 21k 阅读时长 ≈ 20 分钟

Flutter

Flutter和Dart系列文章
项目GitHub地址
Flutter作为一种全新的响应式，跨平台，高性能, 完全免费、开源的移动开发框架
Widget是Flutter开发中的主要组成部分, 是Flutter的基础, Flutter的核心设计思想便是: 一切皆Widget
Flutter中的widget的概念更广泛，它不仅可以表示UI元素，也可以表示一些功能性的组件如：用于手势检测的 GestureDetector widget、用于应用主题数据传递的Theme等等

Flutter框架

Widget实际上就是Element的配置数据, Widget的功能是描述一个UI元素的一个配置数据, 而真正的UI渲染是由Element构成
由于Element是通过Widget生成，所以它们之间有对应关系，所以在大多数场景，我们可以宽泛地认为Widget就是指UI控件或UI渲染
一个Widget对象可以对应多个Element对象。这很好理解，根据同一份配置（Widget），可以创建多个实例（Element）

`Widget`类的声明

@immutable
abstract class Widget extends DiagnosticableTree {
  /// Initializes [key] for subclasses.
  const Widget({ this.key });

  /// See also the discussions at [Key] and [GlobalKey].
  final Key key;

  /// multiple times.
  @protected
  Element createElement();

  /// A short, textual description of this widget.
  @override
  String toStringShort() {
    return key == null ? '$runtimeType' : '$runtimeType-$key';
  }

  @override
  void debugFillProperties(DiagnosticPropertiesBuilder properties) {
    super.debugFillProperties(properties);
    properties.defaultDiagnosticsTreeStyle = DiagnosticsTreeStyle.dense;
  }

  static bool canUpdate(Widget oldWidget, Widget newWidget) {
    return oldWidget.runtimeType == newWidget.runtimeType
        && oldWidget.key == newWidget.key;
  }
}

Widget类继承自DiagnosticableTree，主要作用是提供调试信息。
Key: 这个key属性类似于React/Vue中的key，主要的作用是决定是否在下一次build时复用旧的widget，决定的条件在canUpdate()方法中
createElement()：正如前文所述一个Widget可以对应多个Element；Flutter Framework在构建UI时，会先调用此方法生成对应节点的Element对象。此方法是Flutter Framework隐式调用的，在我们开发过程中基本不会调用到。
debugFillProperties 复写父类的方法，主要是设置DiagnosticableTree的一些特性。
canUpdate是一个静态方法，它主要用于在Widget树重新build时复用旧的widget
- 具体来说就是：是否用新的Widget对象去更新旧UI上所对应的Element对象的配置；
- 通过其源码我们可以看到，只要newWidget与oldWidget的runtimeType和key同时相等时就会用newWidget去更新Element对象的配置，否则就会创建新的Element

StatelessWidget和StatefulWidget的区别

StatelessWidget是状态不可变的widget, 初始状态设置以后就不可再变化, 如果需要变化需要重新创建; StatefulWidget可以保存自己的状态
在Flutter中通过引入State来保存状态, 当State的状态改变时，能重新构建本节点以及孩子的Widget树来进行UI变化
如果需要主动改变State的状态，需要通过setState()方法进行触发，单纯改变数据是不会引发UI改变的
下面介绍部分的Widget组件

Text

UI上面文字的展示基本上都要靠Text组件来完成

// 两种构造函数
// 显示普通的文本
 const Text(this.data, {
    Key key,
    this.style,
    this.textAlign,
    this.textDirection,
    this.locale,
    this.softWrap,
    this.overflow,
    this.textScaleFactor,
    this.maxLines,
    this.semanticsLabel,
  }) : assert(data != null),
       textSpan = null,
       super(key: key);

  /// 段落式文本,可以给文本中的每个textSpan设置其样式
  const Text.rich(this.textSpan, {
    Key key,
    this.style,
    this.textAlign,
    this.textDirection,
    this.locale,
    this.softWrap,
    this.overflow,
    this.textScaleFactor,
    this.maxLines,
    this.semanticsLabel,
  }): assert(textSpan != null),
      data = null,
      super(key: key);

参数介绍

data

文本的内容

1	Text('titanjun')

style

文本的样式

  const TextStyle({
    this.inherit = true,
    this.color,
    this.fontSize,
    this.fontWeight,
    this.fontStyle,
    this.letterSpacing,
    this.wordSpacing,
    this.textBaseline,
    this.height,
    this.locale,
    this.foreground,
    this.background,
    this.shadows,
    this.decoration,
    this.decorationColor,
    this.decorationStyle,
    this.debugLabel,
    String fontFamily,
    String package,
  }) : fontFamily = package == null ? fontFamily : 'packages/$package/$fontFamily',
       assert(inherit != null),
       assert(color == null || foreground == null, _kColorForegroundWarning);
       
// 相关属性介绍
1. inherit: 为false时不显示

2. color: 字体颜色

3. fontSize: 字体大小, 默认是14.0

4. fontWeight: 字体的粗体, FontWeight.w500
  
5. fontStyle: 字体的样式
    normal正常 italic 斜体

6. letterSpacing: 字符间距

7. wordSpacing: 单词间距

8. textBaseline
    alphabetic：用于对齐字母字符底部的水平线
    ideographic：用于对齐表意字符的水平线
    
9. height: 用在Text控件上的时候，会乘以fontSize做为行高,

10. locale: 国际化

11. foreground: 用paint来渲染text，也可以用他来改变字体颜色等

12. background: 背景颜色

13. decoration: 
    下划线 underline、 删除线 lineThrough、上划线 overline，默认是无 none
    
14. decorationStyle: decoration线的样式
    solid: 直线, double: 两条线, dotted: 短虚线, dashed: 长虚线, wavy: 波浪线

15. decorationColor: decoration线的颜色

16. debugLabel: 文本样式的描述, 该属性只在调试中维护

17. fontFamily和package（自定义字体的时候用的到，后面再详解）

使用样式示例

style: TextStyle(
    inherit: true,
    color: Colors.red,
    fontSize: 50,
    fontWeight: FontWeight.bold,
    fontStyle: FontStyle.italic,
    letterSpacing: 2,
    wordSpacing: 5,
    textBaseline: TextBaseline.alphabetic,
    height: 2,
    locale: Locale('CH'),
    decoration: TextDecoration.lineThrough,
    decorationColor: Colors.blue,
    decorationStyle: TextDecorationStyle.wavy,
),

textAlign

文本显示方向

left: 居左显示
center: 居中显示
right: 居右显示
justify: 文本的拉伸行，其末尾用软换行符填充宽度
start: 对齐容器前缘的文本。
    对于从左到右的文本([TextDirection.ltr])，这是左边缘。
    对于从右到左的文本([TextDirection.rtl])，这是右边缘。
end: 对齐容器尾部边缘的文本。
    对于从左到右的文本([TextDirection.ltr])，这是右边缘。
    对于从右到左的文本([TextDirection.rtl])，这是左边缘。

textDirection

和上述TextAlign.start和TextAlign.end一样

softWrap

文本是否能换行,bool类型

overflow

用来指定超出文本的表示方式，是截断文本啊还是用三个点显示等

1
2
3

ellipsis: ...形式显示
clip: 直接截断
fade: 效果和clip一样

maxLines

用来指定文本最多显示多少行

textScaleFactor

文本字体的缩放倍数，如：1.5则在默认字体上变成1.5倍大小字体，0.5则是0.5倍

Text构造函数

child: Text(
      // 需要显示的文字
      'titanjun.top' * 3,
      textAlign: TextAlign.left,
      textDirection: TextDirection.ltr,
      locale: Locale('CH'),
      maxLines: 1,
      overflow: TextOverflow.fade,
      style: TextStyle(
          inherit: true,
          color: Colors.red,
          fontSize: 50,
          fontWeight: FontWeight.bold,
          fontStyle: FontStyle.italic,
          letterSpacing: 2,
          wordSpacing: 5,
          textBaseline: TextBaseline.alphabetic,
          height: 2,
          locale: Locale('CH'),
          decoration: TextDecoration.lineThrough,
          decorationColor: Colors.blue,
          decorationStyle: TextDecorationStyle.wavy,
      ),
  ),

Text.rich构造函数

这个构造函数和iOS中用到的富文本类似

child: Text.rich(
    TextSpan(
      text: '博客地址: ',
      children: [
        TextSpan(
          text: 'https://',
          style: TextStyle(color: Colors.red)
        ),
        TextSpan(
          text: 'titanjun.top',
          style: TextStyle(color: Colors.blue),
        ),
        TextSpan(
          text: '欢迎访问',
          style: TextStyle(color: Colors.orange)
        ),
      ]
    ),
),

Text.rich

其中TextSpan的构造函数如下

const TextSpan({
    this.style,
    this.text,
    // 接受List<TextSpan>类型的数组
    this.children,
    // 文本的手势操作, 后面说这个
    this.recognizer,
});

Image

一个用于展示图片的组件。支持 JPEG、PNG、GIF、Animated GIF、WebP、Animated WebP、BMP 和 WBMP 等格式
Image共有五种构造函数

Image()

const Image({
  Key key,
  // 一个图片对象ImageProvider, 可设置NetworkImage(), FileImage(), MemoryImage()三种对象
  @required this.image,
  // 图片的描述, String
  this.semanticLabel,
  this.excludeFromSemantics = false,
  // 图片的宽度, double
  this.width,
  // 图片的高度, double
  this.height,
  // 图像的颜色, 用于和图片混合的颜色, 结合colorBlendMode使用
  this.color,
  // 颜色和图片混合的状态, BlendMode
  this.colorBlendMode,
  // 图像在布局中分配的空间, BoxFit
  this.fit,
  // 图像边界内对齐图像, Alignment
  this.alignment = Alignment.center,
  // 未充分填充容器时,是否重复显示图片
  this.repeat = ImageRepeat.noRepeat,
  // 九片图像的中心切点, Rect
  this.centerSlice,
  // 是否在图像的方向上绘制图像 TextDirection
  this.matchTextDirection = false,
  // 当图像提供者发生变化时，是继续显示旧图像（true）还是暂时不显示（false）
  this.gaplessPlayback = false,
  // 设置图片的过滤质量
  this.filterQuality = FilterQuality.low,
})

部分属性详解

width、height：

用于设置图片的宽、高，当不指定宽高时，图片会根据当前父容器的限制，尽可能的显示其原始大小
如果只设置width、height的其中一个，那么另一个属性默认会按比例缩放
但可以通过下面介绍的fit属性来指定适应规则

fit

图像在布局中分配的空间, BoxFit枚举值

fill: 填充满容器空间, 图片会被拉伸
contain: 以容器的大小等比例缩放图片
cover: 填充整个容器, 图片会被剪切
fitWidth: 以容器的宽度, 等比例缩放图片
fitHeight: 以容器的高度, 等比例的缩放图片
none: 以图片的实际大小显示
scaleDown: 居中显示, 图片不会拉伸, 以宽高中最小的尺寸为标准

alignment

图像边界内对齐图像, Alignment类, 不是枚举值

/// 定义方式为垂直方向-水平方向
static const Alignment topLeft = Alignment(-1.0, -1.0);
static const Alignment topCenter = Alignment(0.0, -1.0);
static const Alignment topRight = Alignment(1.0, -1.0);
static const Alignment centerLeft = Alignment(-1.0, 0.0);
static const Alignment center = Alignment(0.0, 0.0);
static const Alignment centerRight = Alignment(1.0, 0.0);
static const Alignment bottomLeft = Alignment(-1.0, 1.0);
static const Alignment bottomCenter = Alignment(0.0, 1.0);
static const Alignment bottomRight = Alignment(1.0, 1.0);

/// 使用方式
alignment: Alignment.topLeft,
// 或者
alignment: Alignment(0.0, 1.0)

Image(
  image: NetworkImage('https://titanjun.oss-cn-hangzhou.aliyuncs.com/flutter/flutter.jpeg?x-oss-process=style/titanjun'),
  fit: BoxFit.scaleDown,
  alignment: Alignment.topLeft,
),

color和 colorBlendMode

在图片绘制时可以对每一个像素进行颜色混合处理，color指定混合色，而colorBlendMode指定混合模式；

repeat

当图片本身大小小于显示空间时，指定图片的重复规则

FadeInImage

可以用于添加占位图

class FadeInImage extends StatelessWidget {
  const FadeInImage({
    Key key,
    // 占位图片, 默认本地图片
    @required this.placeholder,
    this.placeholderErrorBuilder,
    // 网络图片
    @required this.image,
    this.imageErrorBuilder,
    this.excludeFromSemantics = false,
    this.imageSemanticLabel,
    this.fadeOutDuration = const Duration(milliseconds: 300),
    this.fadeOutCurve = Curves.easeOut,
    this.fadeInDuration = const Duration(milliseconds: 700),
    this.fadeInCurve = Curves.easeIn,
    this.width,
    this.height,
    this.fit,
    this.alignment = Alignment.center,
    this.repeat = ImageRepeat.noRepeat,
    this.matchTextDirection = false,
  })
}

ImageProvider

用于显示图片的抽象类, 不能直接使用, 需要使用其子类

用于显示网络图片

// 用于显示网络图片
abstract class NetworkImage extends ImageProvider<NetworkImage> {
  /// 抽象类不能直接使用, 但是可以使用它的工厂构造函数
  const factory NetworkImage(String url, { double scale, Map<String, String> headers }) = network_image.NetworkImage;
}

// 用于加载图片文件
class FileImage extends ImageProvider<FileImage> {
  /// 常量构造方法
  const FileImage(this.file, { this.scale = 1.0 })
    : assert(file != null),
      assert(scale != null);
}

// 用于加载内存中的图片
class MemoryImage extends ImageProvider<MemoryImage> {
  /// 常量构造方法
  const MemoryImage(this.bytes, { this.scale = 1.0 })
    : assert(bytes != null),
      assert(scale != null);
} 

// 用于显示本地图片
class AssetImage extends AssetBundleImageProvider {
  /// 常量构造方法
  const AssetImage(
    this.assetName, {
    this.bundle,
    this.package,
  }) : assert(assetName != null);
}

Image.network

用于显示网络图片

Image.network(
  'https://titanjun.oss-cn-hangzhou.aliyuncs.com/flutter/catimage.jpg',
  width: 100,
  height: 100,
  fit: BoxFit.scaleDown,
  alignment: Alignment.center,
)

网络请求Image是最常见的操作, 这里重点说明两个点

缓存

ImageCache是ImageProvider默认使用的图片缓存。ImageCache使用的是LRU的算法
默认可以存储1000张图片。如果觉得缓存太大，可以通过设置ImageCache的maximumSize属性来控制缓存图片的数量。
也可以通过设置maximumSizeBytes来控制缓存的大小（默认缓存大小10MB）

CDN优化

如果想要使用cdn优化，可以通过url增加后缀的方式实现。默认实现中没有这个点，但是考虑到cdn优化的可观收益，建议大家利用好这个优化

Image.asset

Flutter应用程序可以包含代码和 assets（有时称为资源）
asset是打包到程序安装包中的，可在运行时访问
常见类型的asset包括静态数据（例如JSON文件），配置文件，图标和图片（JPEG，WebP，GIF，动画WebP / GIF，PNG，BMP和WBMP）
Flutter使用pubspec.yaml文件（位于项目根目录），来识别应用程序所需的asset

注意事项

图片所在的文件夹images和pubspec.yaml需要在同一目录下, 否则pubspec.yaml文件中, 设置资源路径的时候要对应修改
images图片文件夹中2.0x和3.0x图片要分别创建两个文件夹, 并把2倍和3倍图分别放在不同的文件夹中, 切文件的名字不要在带@2x和@3x字样

Image.asset(
  'images/home.png',
  width: 100,
  height: 100,
  fit: BoxFit.scaleDown,
  alignment: Alignment.center,
)

Image.file

Image.file(File file, {
    Key key,
    double scale = 1.0,
    this.semanticLabel,
    this.excludeFromSemantics = false,
    this.width,
    this.height,
    this.color,
    this.colorBlendMode,
    this.fit,
    this.alignment = Alignment.center,
    this.repeat = ImageRepeat.noRepeat,
    this.centerSlice,
    this.matchTextDirection = false,
    this.gaplessPlayback = false,
    this.filterQuality = FilterQuality.low,
  })

主要解析file参数，其他与Image()构造的参数一致！
file: 对文件系统上的文件的引用。
File 实例是一个对象，它包含可以在其上执行操作的路径

Image.memory

Image.memory(Uint8List bytes, {
    Key key,
    double scale = 1.0,
    this.semanticLabel,
    this.excludeFromSemantics = false,
    this.width,
    this.height,
    this.color,
    this.colorBlendMode,
    this.fit,
    this.alignment = Alignment.center,
    this.repeat = ImageRepeat.noRepeat,
    this.centerSlice,
    this.matchTextDirection = false,
    this.gaplessPlayback = false,
    this.filterQuality = FilterQuality.low,
  })

加载Uint8List资源图片
主要解析bytes参数，其他与Image()构造的参数一致！

Icon

Flutter中，Icon是类似于web开发中一样使用iconfont(字体图标)，它是将图标做成字体文件，然后通过指定不同的字符而显示不同的图片
在字体文件中，每一个字符都对应一个位码，而每一个位码对应一个显示字形，不同的字体就是指字形不同，即字符对应的字形是不同的
而在iconfont中，只是将位码对应的字形做成了图标，所以不同的字符最终就会渲染成不同的图标。
在Flutter中iconfont相较于图片的优势如下:
- 体积小：可以减小安装包大小。
- 矢量的：iconfont都是矢量图标，放大不会影响其清晰度。
- 可以应用文本样式：可以像文本一样改变字体图标的颜色、大小对齐等。
- 可以通过TextSpan和文本混用。

使用Material Design字体图标

Flutter默认包含了一套Material Design的字体图标，在pubspec.yaml文件中的配置如下

1 2	flutter: uses-material-design: true

如果设置成false, 则图片效果如下, 图片颜色为自己设置的颜色

Material Design所有图标可以在其官网查看：https://material.io/tools/icons/
Material Design所有图标对应的字符编码可在material-design-icons中搜索查找

在Text中使用

下面看一个在Text中使用iconfont的示例

String iconStr = "";
// accessible: &#xE914; or 0xE914 or E914
iconStr += "\uE914";
// error: &#xE000; or 0xE000 or E000
iconStr += " \uE000";
// fingerprint: &#xE90D; or 0xE90D or E90D
iconStr += " \uE90D";


Text(iconStr,
  style: TextStyle(
    fontFamily: "MaterialIcons",
    fontSize: 80.0,
    color: Colors.green
  ),
)

上述代码的运行效果如下

任何一个图片我们都可以使用Text文本进行展示, 但是这需要我们提供每一个图标的字符码点, 可在material-design-icons中搜索查找, 而且并不能固定指定图片的大小, 只能设置字体的大小, 这并对开发者不友好

Icon介绍

Flutter封装了一个Icon来专门显示字体图标，上面的例子也可以用如下方式实现

Row(
  mainAxisAlignment: MainAxisAlignment.center,
  children: <Widget>[
    Icon(Icons.accessible, color: Colors.green, size: 80),
    Icon(Icons.error, color: Colors.green, size: 80),
    Icon(Icons.fingerprint, color: Colors.green, size: 80),
  ],
)

Icons类中包含了所有Material Design图标的IconData静态变量定义, …..我大概算了一下, Icons中大概一共定义了984中图标

// icon的构造函数
const Icon(this.icon, {
    Key key,
    // double, 设置图片的大小, 同事设置宽高
    this.size,
    // Color, 设置图片的颜色
    this.color,
    // String, 图标的语义标签
    this.semanticLabel,
    // TextDirection, 从左/右开始排列
    this.textDirection,
})

圆形图片

在Flutter中实现圆角效果也是使用一些Widget来实现的

CircleAvatar

CircleAvatar可以实现圆角头像，也可以添加一个子Widget

class CircleAvatar extends StatelessWidget {
  /// Creates a circle that represents a user.
  const CircleAvatar({
    Key key,
    this.child, // 子Widget
    this.backgroundColor, // 背景颜色
    this.backgroundImage, // 背景图像
    this.foregroundColor, // 前景颜色
    this.radius, // 半径
    this.minRadius, // 最小半径
    this.maxRadius, // 最大半径
  })
}

简单使用实现一个圆形头像：

这里我们使用的是NetworkImage，因为backgroundImage要求我们传入一个ImageProvider；
这里我还在里面添加了一个文字，但是我在文字外层包裹了一个Container；
这里Container的作用是为了可以控制文字在其中的位置调整

class HomeContent extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return Center(
      child: CircleAvatar(
        radius: 100,
        backgroundImage: NetworkImage("https://tva1.sinaimg.cn/large/006y8mN6gy1g7aa03bmfpj3069069mx8.jpg"),
        child: Container(
          alignment: Alignment(0, .5),
          width: 200,
          height: 200,
          child: Text("圣诞节")
        ),
      ),
    );
  }
}

ClipOval

ClipOval也可以实现圆角头像，而且通常是在只有头像时使用

class ClipOval extends SingleChildRenderObjectWidget {
  /// 
  const ClipOval({
      Key key, 
      this.clipper, 
      this.clipBehavior = Clip.antiAlias, 
      Widget child
  }): assert(clipBehavior != null),
        super(key: key, child: child);
}


// 简单使用
class HomeContent extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return Center(
      child: ClipOval(
        child: Image.network(
          "https://tva1.sinaimg.cn/large/006y8mN6gy1g7aa03bmfpj3069069mx8.jpg",
          width: 200,
          height: 200,
        ),
      ),
    );
  }
}

BoxDecoration

通过Container和Container实现

class CirCleImage extends StatelessWidget {
  const CirCleImage({Key key}) : super(key: key);

  @override
  Widget build(BuildContext context) {
    return Container(
      child: Container(
        decoration: BoxDecoration(
          // 设置不同大小可实现不同的圆角, 设置图片大小的一半就是圆形图片
          borderRadius: BorderRadius.all(Radius.circular(50))
        ),
        clipBehavior: Clip.antiAlias,
        child: Image.network(
          'https://titanjun.oss-cn-hangzhou.aliyuncs.com/flutter/flutter_scroll.png',
          width: 100,
          height: 100,
          fit: BoxFit.fitHeight,
        ),
      ),
    );
  }
}

图片圆角

ClipRRect

ClipRRect用于实现圆角效果，可以设置圆角的大小。

class HomeContent extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return Center(
      child: ClipRRect(
        borderRadius: BorderRadius.circular(10),
        child: Image.network(
          'https://titanjun.oss-cn-hangzhou.aliyuncs.com/flutter/flutter_scroll.png',
          width: 200,
          height: 200,
        ),
      ),
    );
  }
}

按钮

Flutter提供了RaisedButton、FlatButton、OutlineButton和IconButton四种按钮, 除了IconButton之外都是继承自MaterialButton
所有Material库中的按钮都有如下相同点：
- 按下时都会有“水波动画”。
- 有一个onPressed属性来设置点击回调，当按钮按下时会执行该回调，如果不提供该回调则按钮会处于禁用状态，禁用状态不响应用户点击

MaterialButton

MaterialButton是除IconButton按钮之外的其他按钮的父类, 下面介绍一下各属性的使用

const MaterialButton({
    Key key,
    // 点击事件
    @required this.onPressed,
    // 高亮状态变化回调，参数：是否高亮，按下时高亮，抬起不高亮
    this.onHighlightChanged,
    // 字体的主体
    this.textTheme,
    // 按钮文字颜色
    this.textColor,
    // 禁用状态下按钮字体颜色
    this.disabledTextColor,
    // 按钮背景颜色
    this.color,
    // 禁用状态下背景颜色
    this.disabledColor,
    // 高亮状态(按下时的背景颜色)
    this.highlightColor,
    // 按钮的水波纹的颜色
    this.splashColor,
    // 字体亮度
    this.colorBrightness,
    // 按钮底部阴影效果的偏移量, double
    this.elevation,
    // 高亮状态下, 按钮底部阴影效果的偏移量, double
    this.highlightElevation,
    // 禁用状态下, 按钮底部阴影效果的偏移量, double
    this.disabledElevation,
    // 内边距
    this.padding,
    // 按钮的形状
    this.shape,
    this.clipBehavior = Clip.none,
    this.materialTapTargetSize,
    this.animationDuration,
    // 按钮的最小宽度
    this.minWidth,
    // 按钮的高度
    this.height,
    // 子widget
    this.child,
})

onPressed

按钮触发时触发的函数，如果不设置此属性Button为不可用状态

1	onPressed: () => print('被点击了'),

textTheme

按钮字体的主题, 在onPressed不为空的时候才有效果

/// 三个取值
ButtonTextTheme.normal
ButtonTextTheme.accent
ButtonTextTheme.primary

colorBrightness

设置按钮的字体亮度, 取值分别是Brightness.light和Brightness.darks

padding

内边距，其接收值的类型是EdgeInsetsGeometry类型的，EdgeInsetsGeometry是一个抽象类, 只能使用其子类EdgeInsets来实现

1	padding: EdgeInsets.all(10)

shape

设置按钮的形状，其接收值是ShapeBorder类型，ShapeBorder也是一个抽象类
ShapeBorder的子类中比较常用的几个如下所示
- BeveledRectangleBorder 带斜角的长方形边框
- CircleBorder 圆形边框
- RoundedRectangleBorder 圆角矩形
- StadiumBorder 两端是半圆的边框

// 带斜角的长方形边框
const BeveledRectangleBorder({
    // 边框的样式 
    this.side = BorderSide.none,
    // 圆角大小
    this.borderRadius = BorderRadius.zero,
})

// 圆形边框
const CircleBorder({ 
    this.side = BorderSide.none 
})

// 圆角矩形
const RoundedRectangleBorder({
    this.side = BorderSide.none,
    this.borderRadius = BorderRadius.zero,
})

// 两端是半圆的边框
const StadiumBorder({ 
    this.side = BorderSide.none 
})

// 边框样式的设置
const BorderSide({
    // 边框颜色, 默认黑色 
    this.color = const Color(0xFF000000),
    // 边框宽度, 默认1.0
    this.width = 1.0,
    // 边框样式, solid: 实线边框(默认值), none: 不显示边框
    this.style = BorderStyle.solid,
})

下面就来看一下shape的配置和使用, 设置默认状态(即所有的边框样式和圆角都是默认值)的效果如下

children: <Widget>[
  // BeveledRectangleBorder
  RaisedButton(
    child: Text('BeveledRectangleBorder'),
    onPressed: () => print('RaisedButton'),
    shape: BeveledRectangleBorder(
      borderRadius: BorderRadius.all(Radius.circular(10)),
      side: BorderSide(
        color: Colors.red,
        width: 2,
        style: BorderStyle.solid
      )
    ),
  ),
  RaisedButton(
    child: Icon(Icons.supervisor_account, color: Colors.green, size: 40),
    onPressed: () => print('RaisedButton'),
    padding: EdgeInsets.all(10),
    shape: CircleBorder(
      side: BorderSide(
        color: Colors.red,
        width: 2,
        style: BorderStyle.solid
      )
    ),
  ),
  RaisedButton(
    child: Text('RoundedRectangleBorder'),
    onPressed: () => print('RaisedButton'),
    shape: RoundedRectangleBorder(
      borderRadius: BorderRadius.all(Radius.circular(10)),
      side: BorderSide(
        color: Colors.red,
        width: 2,
        style: BorderStyle.solid
      )
    ),
  ),
  RaisedButton(
    child: Text('StadiumBorder'),
    onPressed: () => print('RaisedButton'),
    shape: StadiumBorder(
      side: BorderSide(
        color: Colors.red,
        width: 2,
        style: BorderStyle.solid
      )
    ),
  ),
],

上述代码是分别设置圆角和边框后的代码, 效果如下

RaisedButton

RaisedButton即”漂浮”按钮，它默认带有阴影和灰色背景。按下后阴影会变大
RaisedButton继承自MaterialButton, 相关属性和父类一样

RaisedButton(
    child: Text('RaisedButton'),
    onPressed: () => print('RaisedButton'),
)

FlatButton

FlatButton即扁平按钮，默认背景透明并不带阴影。按下后，会有背景色
RaisedButton继承自MaterialButton, 相关属性和父类一样

FlatButton(
    child: Text('FlatButton'),
    onPressed: () => print('FlatButton'),
)

OutlineButton

OutlineButton默认有一个边框，不带阴影且背景透明。按下后，边框颜色会变亮、同时出现背景和阴影(较弱)
RaisedButton继承自MaterialButton, 相关属性和父类一样

OutlineButton(
    child: Text('OutlineButton'),
    onPressed: () => print('OutlineButton'),
)

IconButton

IconButton是一个可点击的Icon，不包括文字，默认没有背景，点击后会出现背景

// 继承自StatelessWidget
class IconButton extends StatelessWidget {
  const IconButton({
    Key key,
    // 按钮的大小
    this.iconSize = 24.0,
    // 内边距
    this.padding = const EdgeInsets.all(8.0),
    // 按钮中图片的对齐方式
    this.alignment = Alignment.center,
    // 图片按钮的图片Icon
    @required this.icon,
    // 背景色
    this.color,
    // 高亮状态下的背景色
    this.highlightColor,
    // 按钮按下时, 水波纹的颜色
    this.splashColor,
    // 禁用状态下, 按钮的背景色
    this.disabledColor,
    // 点击事件
    @required this.onPressed,
    // String, 描述按钮按下时的描述文本, 需要长按才能出现(黑框显示文本)
    this.tooltip
  })
}

使用示例

IconButton(
    icon: Icon(Icons.mail_outline, color:Colors.orange, size: 40),
    color: Colors.yellow,
    iconSize: 100,
    alignment: Alignment.topLeft,
    onPressed: () => print('IconButton'),
    tooltip: 'titanjun.top',
)

图文按钮

每一个继承自MaterialButton的按钮Widget都有一个工厂构造函数, 返回一个图片在左, 文字在右的按钮

factory RaisedButton.icon({
    // 这里包含MaterialButton的所有属性
    ....
    // 图片Widget
    @required Widget icon,
    // 文字Widget
    @required Widget label,
  })
  
factory FlatButton.icon({
    ....
    @required Widget icon,
    @required Widget label,
  })
  
factory OutlineButton.icon({
    ....
    @required Widget icon,
    @required Widget label,
  })
  
// 使用示例
RaisedButton.icon(
  label: Text('data'),
  icon: Icon(Icons.mail),
  onPressed: () => {},
),

单选开关和复选框

Material widgets库中提供了Material风格的单选开关Switch和复选框Checkbox，它们都是继承自StatelessWidget
它们本身不会保存当前选择状态，所以一般都是在父widget中管理选中状态
当用户点击Switch或Checkbox时，它们会触发onChanged回调，我们可以在此回调中处理选中状态改变逻辑

// Switch属性
const Switch({
    Key key,
    // Switch的状态值, true开启, false关闭
    @required this.value,
    // Switch改变状态所执行的操作
    @required this.onChanged,
    // 开启状态下选项条的颜色
    this.activeColor,
    // 开启状态下圆球的颜色
    this.activeTrackColor,
    // 关闭状态下选项条的颜色
    this.inactiveThumbColor,
    // 关闭状态下圆球的颜色
    this.inactiveTrackColor,
    // 设置开启状态下圆球的图片
    this.activeThumbImage,
    // 设置关闭状态下圆球的图片
    this.inactiveThumbImage,
    // 设置Switch的尺寸样式, padded: 建议大小48, shrinkWrap: 可能的最小尺寸
    this.materialTapTargetSize,
})

// Checkbox属性
const Checkbox({
    Key key,
    // Switch的状态值, true选中, false未选中
    @required this.value,
    // 如果为 true，那么复选框的值可以是 true，false 或 null
    // 如果为false(默认值), 那么只有true和false两种状态
    this.tristate = false,
    // 改变状态时执行的函数
    @required this.onChanged,
    // 选中时的颜色
    this.activeColor,
    // 设置Checkbox的尺寸样式, padded: 建议大小48, shrinkWrap: 可能的最小尺寸
    this.materialTapTargetSize,
})

使用代码

children: <Widget>[
  Switch(
    value: false,
    onChanged: (value) {},
    activeColor: Colors.red,
    activeTrackColor: Colors.yellow,
    inactiveThumbColor: Colors.blue,
    inactiveTrackColor: Colors.cyan,
    materialTapTargetSize: MaterialTapTargetSize.shrinkWrap
  ),
  Checkbox(
    value: true,
    onChanged: (value) { },
    activeColor: Colors.orange,
    tristate: true,
  )
],

Widget与Element

Widget类的声明