Flutter 中的组件,按状态划分:
StatelessWidget(无状态组件)
StatefulWidget(状态组件)
状态组件是包含可变状态的组件,状态的特点:
(1)当组件构建完成后,可同步读取
(2)可以在组件的生命周期中改变
按状态作用域划分
组件内私有状态(StatefulWidget)
跨组件状态共享(InheritedWidget, Provider)
全局状态(Redux, fish-redux, Mobx......)
状态组件的组成
StatefulWidget(组件本身不可变 @immutable)
State(将变化的状态放到 State 中维护)
import 'package:flutter/material.dart';
class Home extends StatelessWidget {
const Home({Key? key}) : super(key: key);
@override
Widget build(BuildContext context) {
return Scaffold(
appBar: AppBar(
title: const Text('StatefulWidget'),
),
body: const MyState(),
);
}
}
class MyState extends StatefulWidget {
const MyState({Key? key}) : super(key: key);
@override
State createState() => _MyStateState();
}
class _MyStateState extends State {
int _num = 0;
// 执行加的方法
void _increment() {
setState(() {
_num++;
});
}
// 减的方法
void _decrement() {
setState(() {
if (_num == 0) return;
_num--;
});
}
@override
Widget build(BuildContext context) {
return Center(
child: Column(
children: [
// 减
ElevatedButton(
onPressed: _decrement,
child: const Icon(Icons.minimize),
),
// 数字
Padding(
padding: const EdgeInsets.all(20),
child: Text('$_num'),
),
// 加
ElevatedButton(
onPressed: _increment,
child: const Icon(Icons.add),
)
],
),
);
}
}
生命周期
// ignore_for_file: avoid_print
import 'package:flutter/material.dart';
class Home extends StatelessWidget {
const Home({Key? key}) : super(key: key);
@override
Widget build(BuildContext context) {
return Scaffold(
appBar: AppBar(
title: const Text('LifeCycle'),
),
body: const MyState(),
);
}
}
class MyState extends StatefulWidget {
const MyState({Key? key}) : super(key: key);
@override
State createState() => _MyStateState();
}
class _MyStateState extends State {
int _num = 0;
@override
void initState() {
// TODO: implement initState
super.initState();
print('initState, 执行initState方法,_num: $_num');
// 通常根据后台接口返回的数据对状态进行初始化
_num = 1;
}
@override
void didChangeDependencies() {
// TODO: implement didChangeDependencies
super.didChangeDependencies();
print('didChangeDependencies, 当前状态对象的依赖改变了, _num: $_num');
}
@override
void didUpdateWidget(covariant MyState oldWidget) {
// TODO: implement didUpdateWidget
super.didUpdateWidget(oldWidget);
print('didUpdateWidget, 组件配置更新了,_num: $_num');
}
@override
void deactivate() {
// TODO: implement deactivate
super.deactivate();
print('deactivate, 组件对象在元素树中暂时移除了,_num: $_num');
}
@override
void dispose() {
// TODO: implement dispose
super.dispose();
print('dispose, 组件对象在元素树中永远移除了,_num: $_num');
}
// 执行加的方法
void _increment() {
setState(() {
print('setState, 组件对象的内部状态变更了,_num: $_num');
_num++;
});
}
// 减的方法
void _decrement() {
setState(() {
print('setState, 组件对象的内部状态变更了,_num: $_num');
if (_num == 0) return;
_num--;
});
}
@override
Widget build(BuildContext context) {
print('build, 组件渲染时,_num: $_num');
return Center(
child: Column(
children: [
// 减
ElevatedButton(
onPressed: _decrement,
child: const Icon(Icons.minimize),
),
// 数字
Padding(
padding: const EdgeInsets.all(20),
child: Text('$_num'),
),
// 加
ElevatedButton(
onPressed: _increment,
child: const Icon(Icons.add),
)
],
),
);
}
}
What:
提供沿树向下,共享数据的功能
即子组件可以获取父组件(InheritedWidget 的子类)的数据
Why:
依赖构造函数传递数据的方式不能满足业务需求。如图,组件D和组件G共享的数据是通过组件A取数据以后逐级向下透传的,也就是说数据需要逐级传递,比较麻烦,而且不是所有组件都需要相关数据
所以,需要一个新的,更好的跨组件数据传输方案。图中,所有的组件都可以获取顶层父组件 InheritedWidget 的数据,可以直接获取,不需要依赖其它组件传递
How:
BuildContext.dependOnInheritedWidgetOfExactType
构造函数
InheritedWidget({Key? key, required Widget child})
InhertiedWidget抽象类包含一个常量构造器,继承该抽象类的子类可以提供一个常量构造器,在使用这些子类时可以用 const 表达式来调用
child:Widget,表示在组件树中挂载在该子类下的组件
key:Key?,表示要传递的数据
import 'package:flutter/material.dart';
class Home extends StatelessWidget {
const Home({Key? key}) : super(key: key);
@override
Widget build(BuildContext context) {
return Scaffold(
appBar: AppBar(
title: const Text('InheritedWidget'),
),
body: const CalculatorState(),
);
}
}
// 组件一:挂载在 InheritedWidget 下,它提供了一个可共享的数据 num
class CalculatorState extends StatefulWidget {
const CalculatorState({Key? key}) : super(key: key);
@override
State createState() => _CalculatorStateState();
}
class _CalculatorStateState extends State {
int _num = 0;
// 执行加的方法
void _increment() {
setState(() {
_num++;
});
}
// 减的方法
void _decrement() {
setState(() {
if (_num == 0) return;
_num--;
});
}
@override
Widget build(BuildContext context) {
// 要调用 of 方法,of 方法中的参数 context 必须是 InheritedWidget 的后代
// 也就是说,组件必须挂在 InheritedWidget 下面
return ShareDataWidget(
// 提供 ShareDataWidget 必须的两个属性 num 和 child
num: _num,
child: Center(
child: Column(
children: [
// 减
ElevatedButton(
onPressed: _decrement,
child: const Icon(Icons.minimize),
),
// 数字
const Padding(
padding: EdgeInsets.all(20),
// 跨组件访问数据
child: MyCounter(),
),
// 加
ElevatedButton(
onPressed: _increment,
child: const Icon(Icons.add),
)
],
),
),
);
}
}
// 组件二:调用 of() 方法,获取 InheritedWidget 共享的数据 num
class MyCounter extends StatefulWidget {
const MyCounter({Key? key}) : super(key: key);
@override
State createState() => _MyCounterState();
}
class _MyCounterState extends State {
@override
Widget build(BuildContext context) {
// 使用 InheritedWidget 中的共享数据
if (ShareDataWidget.of(context)?.num == null) {
return const Text('0');
}
return Text(ShareDataWidget.of(context)!.num.toString());
}
}
// 数据共享组件
class ShareDataWidget extends InheritedWidget {
const ShareDataWidget({
Key? key,
required this.num,
required this.child,
}) : super(key: key, child: child);
final int num;
final Widget child;
// 静态方法 of 用于调用 BuildContext.dependOnInheritedWidgetOfExactType
// 这样做的目的是为了让类可以定义自己的回调逻辑,即便该类没有出现在 context 上下文中
static ShareDataWidget? of(BuildContext context) {
return context.dependOnInheritedWidgetOfExactType();
}
@override
bool updateShouldNotify(ShareDataWidget oldWidget) {
return true;
}
}
Provider
Provider 是对 InheritedWidget 的封装,使其使用更容易使用且易于复用
文档:https://pub.flutter-io.cn/packages/provider
安装:flutter pub add provider
引用:import 'package:provider/provider.dart';
优点:
(1)简化资源的分配与处置
(2)懒加载
(3)创建新类时减少大量的模板代码
(4)支持 DevTools
实现原理
ChangeNotifier:class,可以封装应用程序的状态,用于向监听器发送通知,如果被定义为 ChangeNotifier,就可以订阅它的状态变化。对于简单的程序,一个 ChangeNotifier 就可以满足需求;对于复杂的应用,由于会有多个模型,所以可能会有多个 ChangeNotifier
ChangeNotifierProvider:widget,用于监听 ChangeNotifier 的实例并将其暴露给子孙节点,并且当 ChangeNotifier.notifyListeners 被调用时,会重新构建。虽然数据是单独存放在 ChangeNotifier 中,但是面对组件时,直接提供数据的是 Provider
如果你想提供更多状态,可以使用 MultiProvider:
void main() {
runApp(
MultiProvider(
providers: [
ChangeNotifierProvider(create: (context) => CartModel()),
Provider(create: (context) => SomeOtherClass()),
],
child: const MyApp(),
),
);
}
区别于 InheritedWidget 把状态存放在根节点上,Provider 会把状态和根节点做分割处理,状态会被提取出来保存在 ChangeNotifier 组件中,使用数据时,需要把数据注册到根节点 ChangeNotifierProdiver 上,后续的逻辑基本相同。
图中的 Producer (生产者)组件修改了数据以后,ChangeNotifierProvier (观察者)就会做两件事情,一是通知 ChangeNotifier(被观察者)更新 data,二是通知所有的 Listener(听众,即消费者)更新UI界面。也就是说,Provider 会把整个应用分成三个部分:
(1)数据部分
(2)监控数据的部分
(3)UI界面
整个过程也可以类比 MVVM 的状态管理模式
使用步骤:
(1)创建数据模型
(2)创建 Provider
(3)在子组件中使用数据模型
示例:
import 'package:flutter/material.dart';
import 'package:provider/provider.dart';
// Step 1
// 1、创建数据模型
class LikesModel extends ChangeNotifier {
// 模拟一个私有变量(实际需要把这个类放在一个单独的文件中)
int _counter = 0;
// 模拟一个私有的getter
int get counter => _counter;
void incrementCounter() {
// 累加
_counter++;
// 通知 UI 更新(监听了这个模型的组件重新构建)
notifyListeners();
}
}
// Step 2
class Home extends StatelessWidget {
const Home({Key? key}) : super(key: key);
@override
Widget build(BuildContext context) {
// 2、创建 Provider (注册数据模型)
return ChangeNotifierProvider(
create: (BuildContext context) => LikesModel(),
child: Scaffold(
appBar: AppBar(
title: const Text('Provider'),
),
body: const MyHomePage(),
),
);
}
}
// Step 3
class MyHomePage extends StatelessWidget {
const MyHomePage({Key? key}) : super(key: key);
@override
Widget build(BuildContext context) {
return Container(
padding: const EdgeInsets.all(10),
child: Column(
children: [
// 3、在子组件中使用数据模型
Text(
'点赞了:${context.watch().counter} 次',
style: const TextStyle(
color: Colors.red,
fontSize: 26,
),
),
TextButton(
onPressed: () => context.read().incrementCounter(),
child: const Icon(Icons.thumb_up),
),
],
),
);
}
}
读取值
可以使用 BuildContext 上的扩展属性(由 provider 注入)
(1)context.watch
(2)context.read
(3)context.select
需要注意的是,context.read
Text(
// 此处如果使用 context.read 来读取 counter,将监听不到状态更改,视图不会更新
'点赞了:${context.watch().counter} 次',
style: const TextStyle(
color: Colors.red,
fontSize: 26,
),
),
这些方法会从传入的 BuildContext 关联的 widget 开始,向上查找 widget 树,并返回查找到的层级最近的 T 类型的 provider(未找到时将抛出错误)。例如,把 Step3 中的 MyHomePage 直接作为 Step2 中的 body 组件,就会报如下错误
import 'package:flutter/material.dart';
import 'package:provider/provider.dart';
// Step 1
// 1、创建数据模型
class LikesModel extends ChangeNotifier {
// 模拟一个私有变量(实际需要把这个类放在一个单独的文件中)
int _counter = 0;
// 模拟一个私有的getter
int get counter => _counter;
void incrementCounter() {
// 累加
_counter++;
// 通知 UI 更新(监听了这个模型的组件重新构建)
notifyListeners();
}
}
// Step 2
class Home extends StatelessWidget {
const Home({Key? key}) : super(key: key);
@override
Widget build(BuildContext context) {
// 2、创建 Provider (注册数据模型)
return ChangeNotifierProvider(
create: (BuildContext context) => LikesModel(),
child: Scaffold(
appBar: AppBar(
title: const Text('Provider'),
),
// todo: 注意看这里,会产生异常
body: Container(
padding: const EdgeInsets.all(10),
child: Column(
children: [
// 3、在子组件中使用数据模型
Text(
'点赞了:${context.watch().counter} 次',
style: const TextStyle(
color: Colors.red,
fontSize: 26,
),
),
TextButton(
onPressed: () => context.read().incrementCounter(),
child: const Icon(Icons.thumb_up),
),
],
),
),
),
);
}
}
ProviderNotFoundException (Error: Could not find the correct Provider
above this Home Widget
大概意思是说,Home组件的 BuildContext 不包含 Provider
解决方法:
(1)将上下文传递给与构建方法分离。参考示例中的 Step2、Step3 的写法,拆成两个组件
(2)将上下文包装在 Builder 中
import 'package:flutter/material.dart';
import 'package:provider/provider.dart';
// Step 1
// 1、创建数据模型
class LikesModel extends ChangeNotifier {
// 模拟一个私有变量(实际需要把这个类放在一个单独的文件中)
int _counter = 0;
// 模拟一个私有的getter
int get counter => _counter;
void incrementCounter() {
// 累加
_counter++;
// 通知 UI 更新(监听了这个模型的组件重新构建)
notifyListeners();
}
}
// Step 2
class Home extends StatelessWidget {
const Home({Key? key}) : super(key: key);
@override
Widget build(BuildContext context) {
// 2、创建 Provider (注册数据模型)
return ChangeNotifierProvider(
create: (BuildContext context) => LikesModel(),
child: Scaffold(
appBar: AppBar(
title: const Text('Provider'),
),
// todo: 修改点:将上下文包装在 Builder 中
body: Builder(builder: (BuildContext context) {
return Container(
padding: const EdgeInsets.all(10),
child: Column(
children: [
// 3、在子组件中使用数据模型
Text(
'点赞了:${context.watch().counter} 次',
style: const TextStyle(
color: Colors.red,
fontSize: 26,
),
),
TextButton(
onPressed: () =>
context.read().incrementCounter(),
child: const Icon(Icons.thumb_up),
),
],
),
);
}),
),
);
}
}
DataTable
DataTable 是 Flutter 中的表格
columns:声明表头列表
DataColumn:表头单元格
rows:声明数据列表
DataRow:一行数据
DataCell:数据单元格
import 'package:flutter/material.dart';
class Home extends StatelessWidget {
const Home({Key? key}) : super(key: key);
@override
Widget build(BuildContext context) {
return Scaffold(
appBar: AppBar(
title: const Text('DataTable'),
),
body: ListView(
children: const [UserTable()],
),
);
}
}
class UserTable extends StatefulWidget {
const UserTable({Key? key}) : super(key: key);
@override
State createState() => _UserTableState();
}
class _UserTableState extends State {
@override
Widget build(BuildContext context) {
return Container(
padding: const EdgeInsets.symmetric(horizontal: 1),
child: SingleChildScrollView(
child: DataTable(
// 表头
columns: const [
// 表头单元格
DataColumn(label: Text('姓名')),
DataColumn(label: Text('年龄')),
DataColumn(label: Text('性别')),
DataColumn(label: Text('简介')),
],
// 表格主体
rows: const [
// 行
DataRow(cells: [
// 列
DataCell(Text('张三')),
DataCell(Text('18')),
DataCell(Text('男')),
DataCell(Text('一首张三的歌')),
]),
DataRow(cells: [
DataCell(Text('二丫')),
DataCell(Text('22')),
DataCell(Text('女')),
DataCell(Text('没有简介')),
]),
],
),
),
);
}
}
import 'package:flutter/material.dart'; class Home extends StatelessWidget { const Home({Key? key}) : super(key: key); @override Widget build(BuildContext context) { return Scaffold( appBar: AppBar( title: const Text('DataTable'), ), body: const UserTable(), ); } } class User { String name; int age; String gender; String intro; bool selected; User(this.name, this.age, this.gender, this.intro, {this.selected = false}); } class UserTable extends StatefulWidget { const UserTable({Key? key}) : super(key: key); @override StatecreateState() => _UserTableState(); } class _UserTableState extends State { List data = [ User('美国队长', 200, '男', '最会甩锅的男人'), User('钢铁侠', 72, '男', 'i love you more than 4000'), User('蜘蛛侠', 18, '男', '彼得帕克和玛莉简拍照时被五彩毒蜘蛛咬了', selected: true), User('黑寡妇', 36, '女', '把你的洗澡水给杜兰特喝一点吧'), ]; bool _sortAscending = true; List _getUserRows() { List dataRows = []; for (int i = 0; i < data.length; i++) { dataRows.add( DataRow( selected: data[i].selected, onSelectChanged: (selected) { // ignore: avoid_print setState(() { data[i].selected = selected!; }); }, cells: [ DataCell(Text(data[i].name)), DataCell(Text('${data[i].age}')), DataCell(Text(data[i].gender)), DataCell(Text(data[i].intro)), ], ), ); } return dataRows; } @override Widget build(BuildContext context) { return Container( padding: const EdgeInsets.symmetric(horizontal: 1), child: SingleChildScrollView( scrollDirection: Axis.horizontal, // 表格 child: DataTable( // 需要排序的列 sortColumnIndex: 1, // 排序方式,false:降序,true:升序 sortAscending: _sortAscending, // 行高 dataRowHeight: 100, // 每一行的首位两列的表格边缘和父容器间的外边距 horizontalMargin: 10, // 单元格的水平外边距 columnSpacing: 100, // 表头 columns: [ const DataColumn(label: Text('姓名')), DataColumn( label: const Text('年龄'), // 该列是否表示数值,如是,则该列内容右对齐 numeric: true, // 排序:ascending false:降序,true:升序 onSort: (int columnIndex, bool ascending) { setState(() { _sortAscending = ascending; if (ascending) { // compareTo:负数表示a小于b,正数表示a大于b data.sort((a, b) => a.age.compareTo(b.age)); } else { data.sort((a, b) => b.age.compareTo(a.age)); } }); }, ), const DataColumn(label: Text('性别')), const DataColumn(label: Text('介绍')), ], // 表格主体 rows: _getUserRows(), ), ), ); } }