Depreciar OverlayPortal.targetsRootOverlay y aplicar LookupBoundary en Overlay.of

La propiedad OverlayPortal.targetsRootOverlay fue depreciada y reemplazada por overlayLocation.

Overlay.of y Overlay.maybeOf ahora respetan LookupBoundary.

Se añadió un parámetro overlayLocation al constructor por defecto de OverlayPortal para controlar dónde se renderiza el hijo del overlay. Como resultado, el constructor OverlayPortal.targetsRootOverlay ya no es útil.

Para evitar que un OverlayEntry se inserte a través de límites multi-vista por error, Overlay.of ahora respeta LookupBoundary.

El constructor OverlayPortal.targetsRootOverlay está depreciado.

Overlay.of y Overlay.maybeOf no buscarán más allá de LookupBoundary.

Si estás usando OverlayPortal.targetsRootOverlay, usa OverlayPortal con overlayLocation en su lugar.

Código antes de la migración:

Widget build(BuildContext context) {
  return OverlayPortal.targetsRootOverlay(
    controller: myController,
    overlayChildBuilder: _myBuilder,
    child: myChild,
  );
}

Código después de la migración:

Widget build(BuildContext context) {
  return OverlayPortal(
    overlayLocation: OverlayChildLocation.rootOverlay,
    controller: myController,
    overlayChildBuilder: _myBuilder,
    child: myChild,
  );
}

Si esperas que Overlay.of y Overlay.maybeOf busquen más allá de LookupBoundary, usa findAncestorStateOfType en su lugar.

Código antes de la migración:

Widget build(BuildContext context) {
  Overlay.of(context);
  // ...
}

Código después de la migración:

Widget build(BuildContext context) {
  context.findAncestorStateOfType<OverlayState>();
  // ...
}

Llegó en la versión: 3.38.0-0.1.pre
En la versión estable: 3.38

Documentación de la API:

• OverlayPortal
• Overlay.of
• Overlay.maybeOf
• LookupBoundary

Problema relevante:

• Issue 168785

PR relevante:

• PR 174239