v2.10 后移除的已弃用 API
概述
#根据 Flutter 的弃用策略,在 2.10 稳定版发布后达到生命周期结束的已弃用 API 已被移除。
所有受影响的 API 都已编译到此主源中,以帮助迁移。同时提供了快速参考表。
变更
#本节按受影响的类列出了弃用项。
TextField & 相关类的 maxLengthEnforced
#Flutter Fix 支持:是
maxLengthEnforced 在 v1.25 中被弃用。
请改用 maxLengthEnforcement。将 maxLengthEnforced 为 true 的地方替换为 MaxLengthEnforcement.enforce。将 maxLengthEnforced 为 false 的地方替换为 MaxLengthEnforcement.none。此更改允许指定比原始二元选择更多的行为,并增加了 MaxLengthEnforcement.truncateAfterCompositionEnds 作为附加选项。
以下类均具有相同的 API 更改
TextFieldTextFormFieldCupertinoTextField
迁移指南
迁移前的代码
const TextField textField = TextField(maxLengthEnforced: true);
const TextField textField = TextField(maxLengthEnforced: false);
final lengthEnforced = textField.maxLengthEnforced;
const TextFormField textFormField = TextFormField(maxLengthEnforced: true);
const TextFormField textFormField = TextFormField(maxLengthEnforced: false);
final lengthEnforced = textFormField.maxLengthEnforced;
const CupertinoTextField cupertinoTextField = CupertinoTextField(maxLengthEnforced: true);
const CupertinoTextField cupertinoTextField = CupertinoTextField(maxLengthEnforced: false);
final lengthEnforced = cupertinoTextField.maxLengthEnforced;迁移后的代码
const TextField textField = TextField(maxLengthEnforcement: MaxLengthEnforcement.enforce);
const TextField textField = TextField(maxLengthEnforcement: MaxLengthEnforcement.none);
final lengthEnforced = textField.maxLengthEnforcement;
const TextFormField textFormField = TextFormField(maxLengthEnforcement: MaxLengthEnforcement.enforce);
const TextFormField textFormField = TextFormField(maxLengthEnforcement: MaxLengthEnforcement.none);
final lengthEnforced = textFormField.maxLengthEnforcement;
const CupertinoTextField cupertinoTextField = CupertinoTextField(maxLengthEnforcement: MaxLengthEnforcement.enforce);
const CupertinoTextField cupertinoTextField = CupertinoTextField(maxLengthEnforcement: MaxLengthEnforcement.none);
final lengthEnforced = cupertinoTextField.maxLengthEnforcement;参考资料
API 文档
相关问题
相关 PR
VelocityTracker 构造函数
#Flutter Fix 支持:是
VelocityTracker 的默认构造函数在 v1.22 中被弃用。
应改用 VelocityTracker.withKind()。这允许为跟踪器指定 PointerDeviceKind。之前 VelocityTracker.kind 的默认值是 PointerDeviceKind.touch。
迁移指南
迁移前的代码
final VelocityTracker tracker = VelocityTracker();迁移后的代码
final VelocityTracker tracker = VelocityTracker.withKind(PointerDeviceKind.touch);参考资料
API 文档
相关 PR
DayPicker & MonthPicker
#Flutter Fix 支持:否
DayPicker 和 MonthPicker 小部件首先在 v1.15 中被弃用,然后在 v1.26 中扩展。
它们已被一个全面的小部件 CalendarDatePicker 取代。
这些小部件曾使用 showDatePicker 方法显示。该方法已迁移为在此版本之前呈现新的 CalendarDatePicker,因此它们的最终移除应该不需要进一步的操作。
参考资料
设计文档
API 文档
相关问题
相关 PR
FlatButton, RaisedButton, & OutlineButton
#Flutter Fix 支持:否
FlatButton、RaisedButton 和 OutlineButton 小部件首先在 v1.20 中被弃用,然后在 v1.26 中扩展。
它们已被新的按钮 TextButton、ElevatedButton 和 OutlinedButton 取代。这些新小部件还使用新的关联主题,而不是通用的 ButtonTheme。
| 旧小部件 | 旧主题 | 新小部件 | 新主题 |
|---|---|---|---|
FlatButton | ButtonTheme | 文本按钮 | TextButtonTheme |
RaisedButton | ButtonTheme | 凸起按钮 | ElevatedButtonTheme |
OutlineButton | ButtonTheme | OutlinedButton | OutlinedButtonTheme |
迁移指南
迁移前的代码
FlatButton(
onPressed: onPressed,
child: Text('Button'),
// ...
);
RaisedButton(
onPressed: onPressed,
child: Text('Button'),
// ...
);
OutlineButton(
onPressed: onPressed,
child: Text('Button'),
// ...
);迁移后的代码
TextButton(
onPressed: onPressed,
child: Text('Button'),
// ...
);
ElevatedButton(
onPressed: onPressed,
child: Text('Button'),
// ...
);
OutlinedButton(
onPressed: onPressed,
child: Text('Button'),
// ...
);参考资料
设计文档
API 文档
ButtonStyleButtonStyleButton凸起按钮ElevatedButtonThemeElevatedButtonThemeDataOutlinedButtonOutlinedButtonThemeOutlinedButtonThemeData文本按钮TextButtonThemeTextButtonThemeData
相关 PR
Scaffold SnackBar 方法
#Flutter Fix 支持:否
以下 Scaffold SnackBar 方法在 v1.23 中被弃用。
showSnackBarremoveCurrentSnackBarhideCurrentSnackBar
应改用 ScaffoldMessenger 的同名方法。每个 MaterialApp 中都已创建了一个默认的 ScaffoldMessenger。
迁移指南
迁移前的代码
Scaffold.of(context).showSnackBar(mySnackBar);
Scaffold.of(context).removeCurrentSnackBar(mySnackBar);
Scaffold.of(context).hideCurrentSnackBar(mySnackBar);迁移后的代码
ScaffoldMessenger.of(context).showSnackBar(mySnackBar);
ScaffoldMessenger.of(context).removeCurrentSnackBar(mySnackBar);
ScaffoldMessenger.of(context).hideCurrentSnackBar(mySnackBar);参考资料
设计文档
视频内容
API 文档
相关问题
相关 PR
RectangularSliderTrackShape.disabledThumbGapWidth
#Flutter Fix 支持:是
RectangularSliderTrackShape.disabledThumbGapWidth 首先在 v1.5 中被弃用,然后在 v1.26 中扩展。
框架不再使用此属性,因为禁用时滑块拇指的动画不再发生。
迁移指南
迁移前的代码
RectangularSliderTrackShape(disabledThumbGapWidth: 2.0);迁移后的代码
RectangularSliderTrackShape();参考资料
API 文档
相关 PR
ThemeData 的文本选择到 TextSelectionThemeData
#Flutter Fix 支持:是
以下 ThemeData 成员首先在 v1.23 中被弃用,然后在 v1.26 中扩展。
useTextSelectionThemetextSelectionColorcursorColortextSelectionHandleColor
应将它们替换为更全面的 TextSelectionThemeData,后者现在本身就在 ThemeData 中指定。
useTextSelectionTheme 标志曾用作区分两个 API 的临时迁移标志,现在可以将其移除。
迁移指南
迁移前的代码
ThemeData(
useTextSelectionTheme: false,
textSelectionColor: Colors.blue,
cursorColor: Colors.green,
textSelectionHandleColor: Colors.red,
);迁移后的代码
ThemeData(
textSelectionTheme: TextSelectionThemeData(
selectionColor: Colors.blue,
cursorColor: Colors.green,
selectionHandleColor: Colors.red,
),
);参考资料
设计文档
API 文档
相关问题
相关 PR
RenderEditable.onSelectionChanged 到 TextSelectionDelegate.textEditingValue
#Flutter Fix 支持:否
RenderEditable.onSelectionChanged 和 TextSelectionDelegate.textEditingValue 在 v1.26 中被弃用。
不要调用其中一个或两个方法,而是调用 TextSelectionDelegate.userUpdateTextEditingValue。这修复了一个错误,即 TextInputFormatter 会收到错误的选区值。
迁移指南
迁移前的代码
renderEditable.onSelectionChanged(selection, renderObject, cause);
textSelectionDelegate.textEditingValue = value;迁移后的代码
textSelectionDelegate.userUpdateTextEditingValue(value, cause);参考资料
API 文档
相关问题
- 已解决#75505
相关 PR
Stack.overflow
#Flutter Fix 支持:是
Stack.overflow 以及 Overflow 枚举在 v1.22 中被弃用。
替换项是 Stack.clipBehavior,这是作为统一框架剪裁行为和语义的一部分进行的更改。将 Overflow.visible 的使用替换为 Clip.none。将 Overflow.clip 的使用替换为 Clip.hardEdge。
迁移指南
迁移前的代码
const Stack stack = Stack(overflow: Overflow.visible);
const Stack stack = Stack(overflow: Overflow.clip);迁移后的代码
const Stack stack = Stack(clipBehavior: Clip.none);
const Stack stack = Stack(clipBehavior: Clip.hardEdge);参考资料
API 文档
相关问题
- 已解决#66030
相关 PR
UpdateLiveRegionEvent
#Flutter Fix 支持:否
SemanticsEvent UpdateLiveRegionEvent 首先在 v1.12 中被弃用,然后在 v1.26 中扩展。
框架从未实现过此功能,应删除所有引用。
参考资料
API 文档
相关 PR
RenderObjectElement 方法
#Flutter Fix 支持:是
以下 RenderObjectElement 方法在 v1.21 中被弃用。
insertChildRenderObjectmoveChildRenderObjectremoveChildRenderObject
这些方法分别被以下方法取代:
insertRenderObjectChildmoveRenderObjectChildremoveRenderObjectChild
这些更改是作为软破坏性弃用来进行的,目的是更改函数签名。
迁移指南
迁移前的代码
element.insertChildRenderObject(child, slot);
element.moveChildRenderObject(child, slot);
element.removeChildRenderObject(child);迁移后的代码
element.insertRenderObjectChild(child, slot);
element.moveRenderObjectChild(child, oldSlot, newSlot);
element.removeRenderObjectChild(child, slot);参考资料
API 文档
相关问题
相关 PR
时间线
#稳定版本:3.0.0