MouseTracker 不再附加註解（annotations）

已移除 MouseTracker 的方法 attachAnnotation、 detachAnnotation 和 isAnnotationAttached。

滑鼠事件，例如滑鼠指標進入區域、離開區域或懸停於區域時， 是透過在 render 階段於感興趣區域上放置的 MouseTrackerAnnotation 來偵測的。 每次更新（新畫面或新事件）時， MouseTracker 會比較滑鼠指標在更新前後所懸停的註解， 然後依據結果分派回呼（callback）。

負責管理滑鼠指標狀態的 MouseTracker 類別， 過去需要透過 MouseRegion 在元件掛載（mounted）時附加註解， 並在卸載（unmounted）時移除註解。 這個機制被 MouseTracker 用來執行 mounted-exit 檢查（例如，若離開事件是因元件卸載所致， 則不得呼叫 MouseRegion.onExit）， 以避免對已卸載的元件呼叫 setState 而導致例外（詳細說明請參見 Issue #44631）。

現在這個機制已被替換為讓 MouseRegion 成為 stateful widget（有狀態元件）， 使其能在卸載時自行阻擋回呼，從而執行 mounted-exit 檢查。 因此，這些方法已被移除，MouseTracker 也不再追蹤螢幕上的所有註解。

MouseTracker 類別已移除三個與附加註解相關的方法：

class MouseTracker extends ChangeNotifier {
  // ...
  void attachAnnotation(MouseTrackerAnnotation annotation) {/* ... */}
​
  void detachAnnotation(MouseTrackerAnnotation annotation) {/* ... */}
​
  @visibleForTesting
  bool isAnnotationAttached(MouseTrackerAnnotation annotation) {/* ... */}
}

RenderMouseRegion 和 MouseTrackerAnnotation 不再執行 mounted-exit 檢查，而 MouseRegion 仍然會執行。

對於 MouseTracker.attachAnnotation 和 detachAnnotation 的呼叫，應該移除，且幾乎不會有影響：

• 使用 MouseRegion 不會受到任何影響。
• 如果你的程式碼有直接使用 RenderMouseRegion 或 MouseTrackerAnnotation，請注意，當離開事件是由原本會呼叫 MouseTracker.detachAnnotation 的事件所觸發時，現在會呼叫 onExit。 如果沒有涉及狀態，這通常不是問題；否則你可能需要自行加入 mounted-exit 檢查，特別是當 callback 被洩漏，導致外層元件 (Widgets) 可能會在其中呼叫 setState。例如：

遷移前的程式碼：

class MyMouseRegion extends SingleChildRenderObjectWidget {
  const MyMouseRegion({this.onHoverChange});
​
  final ValueChanged<bool> onHoverChange;
​
  @override
  RenderMouseRegion createRenderObject(BuildContext context) {
    return RenderMouseRegion(
      onEnter: (_) { onHoverChange(true); },
      onExit: (_) { onHoverChange(false); },
    );
  }
​
  @override
  void updateRenderObject(BuildContext context, RenderMouseRegion renderObject) {
    renderObject
      ..onEnter = (_) { onHoverChange(true); }
      ..onExit = (_) { onHoverChange(false); };
  }
}

遷移後的程式碼：

class MyMouseRegion extends SingleChildRenderObjectWidget {
  const MyMouseRegion({this.onHoverChange});
​
  final ValueChanged<bool> onHoverChange;
​
  @override
  RenderMouseRegion createRenderObject(BuildContext context) {
    return RenderMouseRegion(
      onEnter: (_) { onHoverChange(true); },
      onExit: (_) { onHoverChange(false); },
    );
  }
​
  @override
  void updateRenderObject(BuildContext context, RenderMouseRegion renderObject) {
    renderObject
      ..onEnter = (_) { onHoverChange(true); }
      ..onExit = (_) { onHoverChange(false); };
  }
​
  @override
  void didUnmountRenderObject(RenderMouseRegion renderObject) {
    renderObject
      ..onExit = onHoverChange == null ? null : (_) {};
  }
}

必須移除對 MouseTracker.isAnnotationAttached 的呼叫。 這項功能現已無法在技術上實現， 因為註解（annotations）已不再被追蹤。 如果你確實需要此功能，請提交 issue。

合併於版本：1.15.4
穩定版釋出：1.17

API 文件：

• MouseRegion
• MouseTracker
• MouseTrackerAnnotation
• RenderMouseRegion

相關 PR：

• MouseTracker no longer requires annotations attached， 實作了這項變更
• Improve MouseTracker lifecycle: Move checks to post-frame， 首次引入 mounted-exit 變更， 詳細說明請參見 The change to onExit。