官方源码部分关键代码如下:
class Actions extends StatefulWidget {
/// Creates an [Actions] widget.
///
/// The [child], [actions], and [dispatcher] arguments must not be null.
const Actions({
Key? key,
this.dispatcher,
required this.actions,
required this.child,
}) : assert(actions != null),
assert(child != null),
super(key: key);
}
class _ActionsState extends State<Actions> {
@override
Widget build(BuildContext context) {
return _ActionsMarker(
actions: widget.actions,
dispatcher: widget.dispatcher,
rebuildKey: rebuildKey,
child: widget.child,
);
}
}
class _ActionsMarker extends InheritedWidget{}
通过上述代码,我们可以看出来Actions的一个实现逻辑还是借助InheritedWidget来处理。也就是共享数据的方式。
在使用Actions.invoke(context, intent)传递数据/用户操作 时,如果最近的树节点中找不到Actions对象,就是抛出异常。
示例如下:
import 'package:flutter/material.dart';
void main() => runApp(const MyApp());
class MyApp extends StatelessWidget {
const MyApp({Key? key}) : super(key: key);
static const String _title = 'Flutter Code Sample';
@override
Widget build(BuildContext context) {
return MaterialApp(
title: _title,
home: Scaffold(
appBar: AppBar(title: const Text(_title)),
body: const Center(
child: MyStatefulWidget(),
),
),
);
}
}
// A simple model class that notifies listeners when it changes.
class Model {
ValueNotifier<bool> isDirty = ValueNotifier<bool>(false);
ValueNotifier<int> data = ValueNotifier<int>(0);
int save() {
if (isDirty.value) {
debugPrint('Saved Data: ${data.value}');
isDirty.value = false;
}
return data.value;
}
void setValue(int newValue) {
isDirty.value = data.value != newValue;
data.value = newValue;
}
}
class ModifyIntent extends Intent {
const ModifyIntent(this.value);
final int value;
}
// An Action that modifies the model by setting it to the value that it gets
// from the Intent passed to it when invoked.
class ModifyAction extends Action<ModifyIntent> {
ModifyAction(this.model);
final Model model;
@override
void invoke(covariant ModifyIntent intent) {
model.setValue(intent.value);
}
}
// An intent for saving data.
class SaveIntent extends Intent {
const SaveIntent();
}
// An Action that saves the data in the model it is created with.
class SaveAction extends Action<SaveIntent> {
SaveAction(this.model);
final Model model;
@override
int invoke(covariant SaveIntent intent) => model.save();
}
class SaveButton extends StatefulWidget {
const SaveButton(this.valueNotifier, {Key? key}) : super(key: key);
final ValueNotifier<bool> valueNotifier;
@override
State<SaveButton> createState() => _SaveButtonState();
}
class _SaveButtonState extends State<SaveButton> {
int savedValue = 0;
@override
Widget build(BuildContext context) {
return AnimatedBuilder(
animation: widget.valueNotifier,
builder: (BuildContext context, Widget? child) {
return TextButton.icon(
icon: const Icon(Icons.save),
label: Text('$savedValue'),
style: ButtonStyle(
foregroundColor: MaterialStateProperty.all<Color>(
widget.valueNotifier.value ? Colors.red : Colors.green,
),
),
onPressed: () {
setState(() {
savedValue = Actions.invoke(context, const SaveIntent())! as int;
});
},
);
},
);
}
}
class MyStatefulWidget extends StatefulWidget {
const MyStatefulWidget({Key? key}) : super(key: key);
@override
State<MyStatefulWidget> createState() => _MyStatefulWidgetState();
}
class _MyStatefulWidgetState extends State<MyStatefulWidget> {
Model model = Model();
int count = 0;
@override
Widget build(BuildContext context) {
return Actions(
actions: <Type, Action<Intent>>{
ModifyIntent: ModifyAction(model),
SaveIntent: SaveAction(model),
},
child: Builder(
builder: (BuildContext context) {
return Row(
mainAxisAlignment: MainAxisAlignment.spaceAround,
children: <Widget>[
const Spacer(),
Column(
mainAxisAlignment: MainAxisAlignment.center,
children: <Widget>[
IconButton(
icon: const Icon(Icons.exposure_plus_1),
onPressed: () {
Actions.invoke(context, ModifyIntent(++count));
},
),
AnimatedBuilder(
animation: model.data,
builder: (BuildContext context, Widget? child) {
return Padding(
padding: const EdgeInsets.all(8.0),
child: Text('${model.data.value}',
style: Theme.of(context).textTheme.headline4),
);
}),
IconButton(
icon: const Icon(Icons.exposure_minus_1),
onPressed: () {
Actions.invoke(context, ModifyIntent(--count));
},
),
],
),
SaveButton(model.isDirty),
const Spacer(),
],
);
},
),
);
}
}
效果如下:
个人感受,使用比较复杂。暂时只是扩展一下个人知识面,并未用于项目中