didChangeMetrics method

  1. @override
void didChangeMetrics()
override

Called when the application's dimensions change. For example, when a phone is rotated.

This method exposes notifications from dart:ui.PlatformDispatcher.onMetricsChanged.

This StatefulWidget implements the parts of the State and WidgetsBindingObserver protocols necessary to react when the device is rotated (or otherwise changes dimensions).
link
class MetricsReactor extends StatefulWidget {
  const MetricsReactor({ super.key });

  @override
  State<MetricsReactor> createState() => _MetricsReactorState();
}

class _MetricsReactorState extends State<MetricsReactor> with WidgetsBindingObserver {
  late Size _lastSize;

  @override
  void initState() {
    super.initState();
    WidgetsBinding.instance.addObserver(this);
  }

  @override
  void didChangeDependencies() {
    super.didChangeDependencies();
    // [View.of] exposes the view from `WidgetsBinding.instance.platformDispatcher.views`
    // into which this widget is drawn.
    _lastSize = View.of(context).physicalSize;
  }

  @override
  void dispose() {
    WidgetsBinding.instance.removeObserver(this);
    super.dispose();
  }

  @override
  void didChangeMetrics() {
    setState(() { _lastSize = View.of(context).physicalSize; });
  }

  @override
  Widget build(BuildContext context) {
    return Text('Current size: $_lastSize');
  }
}

In general, this is unnecessary as the layout system takes care of automatically recomputing the application geometry when the application size changes.

See also:

Implementation

@override
void didChangeMetrics() {
  if (!mounted) {
    return;
  }
  final ui.FlutterView view = View.of(context);
  if (_lastBottomViewInset != view.viewInsets.bottom) {
    SchedulerBinding.instance.addPostFrameCallback((Duration _) {
      _selectionOverlay?.updateForScroll();
    }, debugLabel: 'EditableText.updateForScroll');
    if (_lastBottomViewInset < view.viewInsets.bottom) {
      // Because the metrics change signal from engine will come here every frame
      // (on both iOS and Android). So we don't need to show caret with animation.
      _scheduleShowCaretOnScreen(withAnimation: false);
    }
  }
  _lastBottomViewInset = view.viewInsets.bottom;
}