Deprecated API removed after v2.10

In accordance with Flutter's Deprecation Policy, deprecated APIs that reached end of life after the 2.10 stable release have been removed.

All affected APIs have been compiled into this primary source to aid in migration. A quick reference sheet is available as well.

This section lists the deprecations by affected class.

Supported by Flutter Fix: yes

maxLengthEnforced was deprecated in v1.25.

Use maxLengthEnforcement instead. Where maxLengthEnforced was true, replace with MaxLengthEnforcement.enforce. Where maxLengthEnforced was false, replace with MaxLengthEnforcement.none. This change allows more behaviors to be specified beyond the original binary choice, adding MaxLengthEnforcement.truncateAfterCompositionEnds as an additional option.

The following classes all have the same change of API:

• TextField
• TextFormField
• CupertinoTextField

Migration guide

In-depth migration guide available

Code before migration:

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;

Code after migration:

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;

References

API documentation:

• TextField
• TextFormField
• CupertinoTextField

Relevant issues:

• Issue 67898

Relevant PRs:

• Deprecated in #68086
• Removed in #98539

Supported by Flutter Fix: yes

The default constructor for VelocityTrackerwas deprecated in v1.22.

The VelocityTracker.withKind() should be used instead. This allows for a PointerDeviceKind to be specified for the tracker. The previous default for VelocityTracker.kind was PointerDeviceKind.touch.

Migration guide

Code before migration:

final VelocityTracker tracker = VelocityTracker();

Code after migration:

final VelocityTracker tracker = VelocityTracker.withKind(PointerDeviceKind.touch);

References

API documentation:

• VelocityTracker
• PointerDeviceKind

Relevant PRs:

• Deprecated in #66043
• Removed in #98541

Supported by Flutter Fix: no

The DayPicker and MonthPicker widgets were first deprecated in v1.15, and then extended in v1.26.

They have been replaced by one comprehensive widget, CalendarDatePicker.

These widgets were displayed using the showDatePicker method. This method was migrated to present the new CalendarDatePicker before this release, and so their final removal should not necessitate further action.

References

Design document:

• Material Date Picker Redesign

API documentation:

• CalendarDatePicker
• showDatePicker

Relevant issues:

• Issue 50133

Relevant PRs:

• Deprecated in #50546
• Removed in #98543

Supported by Flutter Fix: no

The FlatButton, RaisedButton, and OutlineButton widgets were first deprecated in v1.20, and then extended in v1.26.

They are replaced by new buttons, TextButton, ElevatedButton, and OutlinedButton. These new widgets also use new associated themes, rather than the generic ButtonTheme.

Migration guide

In-depth migration guide available for detailed styling

Code before migration:

FlatButton(
  onPressed: onPressed,
  child: Text('Button'),
  // ...
);

RaisedButton(
  onPressed: onPressed,
  child: Text('Button'),
  // ...
);

OutlineButton(
  onPressed: onPressed,
  child: Text('Button'),
  // ...
);

Code after migration:

TextButton(
  onPressed: onPressed,
  child: Text('Button'),
  // ...
);

ElevatedButton(
  onPressed: onPressed,
  child: Text('Button'),
  // ...
);

OutlinedButton(
  onPressed: onPressed,
  child: Text('Button'),
  // ...
);

References

Design document:

• New Material buttons and themes

API documentation:

• ButtonStyle
• ButtonStyleButton
• ElevatedButton
• ElevatedButtonTheme
• ElevatedButtonThemeData
• OutlinedButton
• OutlinedButtonTheme
• OutlinedButtonThemeData
• TextButton
• TextButtonTheme
• TextButtonThemeData

Relevant PRs:

• New API added in #59702
• Deprecated in #73352
• Removed in #98546

Supported by Flutter Fix: no

The following Scaffold SnackBar methods were deprecated in v1.23.

• showSnackBar
• removeCurrentSnackBar
• hideCurrentSnackBar

The same named methods of the ScaffoldMessenger should be used instead. A default ScaffoldMessenger is already created in every MaterialApp.

Migration guide

In-depth migration guide available

Code before migration:

Scaffold.of(context).showSnackBar(mySnackBar);
Scaffold.of(context).removeCurrentSnackBar(mySnackBar);
Scaffold.of(context).hideCurrentSnackBar(mySnackBar);

Code after migration:

ScaffoldMessenger.of(context).showSnackBar(mySnackBar);
ScaffoldMessenger.of(context).removeCurrentSnackBar(mySnackBar);
ScaffoldMessenger.of(context).hideCurrentSnackBar(mySnackBar);

References

Design document:

• ScaffoldMessenger Design

Video content:

• SnackBar Delivery
• Widget of the Week

API documentation:

• ScaffoldMessenger
• SnackBar

Relevant issues:

• Issue 57218
• Issue 62921

Relevant PRs:

• New API added in #64101
• Deprecated in #67947
• Removed in #98549

Supported by Flutter Fix: yes

The RectangularSliderTrackShape.disabledThumbGapWidth was first deprecated in v1.5, and then extended in v1.26.

This was no longer used by the framework, as the animation of the slider thumb no longer occurs when disabled.

Migration guide

Code before migration:

RectangularSliderTrackShape(disabledThumbGapWidth: 2.0);

Code after migration:

RectangularSliderTrackShape();

References

API documentation:

• RectangularSliderTrackShape

Relevant PRs:

• Animation changed in #30390
• Deprecated in #65246
• Removed in #98613

Supported by Flutter Fix: yes

The following ThemeData members were first deprecated in v1.23, and extended in v1.26.

• useTextSelectionTheme
• textSelectionColor
• cursorColor
• textSelectionHandleColor

These should be replaced by a more comprehensive TextSelectionThemeData, which is now specified in ThemeData itself.

The useTextSelectionTheme flag served as a temporary migration flag to distinguish the two APIs, it can be removed now.

Migration guide

In-depth migration guide available

Code before migration:

ThemeData(
  useTextSelectionTheme: false,
  textSelectionColor: Colors.blue,
  cursorColor: Colors.green,
  textSelectionHandleColor: Colors.red,
);

Code after migration:

ThemeData(
  textSelectionTheme: TextSelectionThemeData(
    selectionColor: Colors.blue,
    cursorColor: Colors.green,
    selectionHandleColor: Colors.red,
  ),
);

References

Design document:

• Text Selection Theme

API documentation:

• ThemeData
• TextSelectionThemeData

Relevant issues:

• Issue 17635
• Issue 56082
• Issue 61227

Relevant PRs:

• New API added in #62014
• Deprecated in #66485
• Removed in #98578

Supported by Flutter Fix: no

RenderEditable.onSelectionChanged and TextSelectionDelegate.textEditingValue were deprecated in v1.26.

Instead of calling one or both of these methods, call TextSelectionDelegate.userUpdateTextEditingValue. This fixed a bug where the TextInputFormatter would receive the wrong selection value.

Migration guide

Code before migration:

renderEditable.onSelectionChanged(selection, renderObject, cause);
textSelectionDelegate.textEditingValue = value;

Code after migration:

textSelectionDelegate.userUpdateTextEditingValue(value, cause);

References

API documentation:

• RenderEditable
• TextSelectionDelegate

Relevant issues:

• Resolved #75505

Relevant PRs:

• Deprecated in #75541
• Removed in #98582

Supported by Flutter Fix: yes

Stack.overflow, as well as the Overflow enum were deprecated in v1.22.

The replacement is Stack.clipBehavior, a change made as part of unifying clip behaviors and semantics across the framework. Where Overflow.visible was used, use Clip.none. Where Overflow.clip was used, use Clip.hardEdge.

Migration guide

In-depth migration guide available

Code before migration:

const Stack stack = Stack(overflow: Overflow.visible);
const Stack stack = Stack(overflow: Overflow.clip);

Code after migration:

const Stack stack = Stack(clipBehavior: Clip.none);
const Stack stack = Stack(clipBehavior: Clip.hardEdge);

References

API documentation:

• Stack
• Clip

Relevant issues:

• Resolved #66030

Relevant PRs:

• Deprecated in #66305
• Removed in #98583

Supported by Flutter Fix: no

The SemanticsEvent UpdateLiveRegionEvent, was first deprecated in v1.12, and then extended in v1.26.

This was never implemented by the framework, and any references should be removed.

References

API documentation:

• SemanticsEvent

Relevant PRs:

• Deprecated in #45940
• Removed in #98615

Supported by Flutter Fix: yes

The following RenderObjectElement methods were deprecated in v1.21.

• insertChildRenderObject
• moveChildRenderObject
• removeChildRenderObject

These methods are replaced, respectively, by:

• insertRenderObjectChild
• moveRenderObjectChild
• removeRenderObjectChild

These changes were made as a soft breaking deprecation in order to change the function signature.

Migration guide

Code before migration:

element.insertChildRenderObject(child, slot);
element.moveChildRenderObject(child, slot);
element.removeChildRenderObject(child);

Code after migration:

element.insertRenderObjectChild(child, slot);
element.moveRenderObjectChild(child, oldSlot, newSlot);
element.removeRenderObjectChild(child, slot);

References

API documentation:

• RenderObjectElement

Relevant issues:

• Issue 63269

Relevant PRs:

• Deprecated in #64254
• Removed in #98616

In stable release: 3.0.0