棄用 OverlayPortal.targetsRootOverlay 並在 Overlay.of 中強制套用 LookupBoundary

OverlayPortal.targetsRootOverlay 屬性已被棄用， 並以 overlayLocation 取代。

Overlay.of 與 Overlay.maybeOf 現在會遵守 LookupBoundary。

overlayLocation 參數已新增至 OverlayPortal 的預設建構子，用於 控制 overlay 子元素的渲染位置。 因此，OverlayPortal.targetsRootOverlay 建構子 已不再有使用價值。

為了防止 OverlayEntry 在不知情的情況下跨越多視圖邊界插入， Overlay.of 現在會遵守 LookupBoundary。

OverlayPortal.targetsRootOverlay 建構子已被棄用。

Overlay.of 與 Overlay.maybeOf 將不再查找超過 LookupBoundary 的範圍。

若您正在使用 OverlayPortal.targetsRootOverlay， 請改用帶有 overlayLocation 的 OverlayPortal。

遷移前的程式碼：

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

遷移後的程式碼：

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

若您希望 Overlay.of 與 Overlay.maybeOf 能查找超過 LookupBoundary 的範圍， 請改用 findAncestorStateOfType。

遷移前的程式碼：

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

遷移後的程式碼：

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

已合併至版本：3.38.0-0.1.pre
穩定版發布：3.38

API 文件：

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

相關 Issue：

• Issue 168785

相關 PR：

• PR 174239