已棄用的 cacheExtent 與 cacheExtentStyle

Flutter 3.44 在與捲動相關的元件 (Widget) 中棄用了 cacheExtent 與 cacheExtentStyle， 包括 ListView、GridView、CustomScrollView 和 Viewport， 以及其對應的渲染物件，例如 RenderViewport。 新的 scrollCacheExtent 屬性將值與快取策略（像素或視口）封裝於一處。

過去，cacheExtent 是一個 double， 而 cacheExtentStyle 決定了該 double 的解讀方式 （可為像素或視口的比例）。 這種分開設定的方式使設定較難理解。

新的 scrollCacheExtent 屬性使用 ScrollCacheExtent 物件， 明確地將值與快取策略（像素或視口）封裝在一起， 從而提供型別安全性與更清晰的意圖。

若您的程式碼使用預設以像素為單位的 cacheExtent， 請改用帶有 ScrollCacheExtent.pixels 的 scrollCacheExtent。

之前：

ListView(
  cacheExtent: 500.0,
  children: // ...
)

之後：

ListView(
  scrollCacheExtent: const ScrollCacheExtent.pixels(500.0),
  children: // ...
)

若您的程式碼在 Viewport 中搭配 CacheExtentStyle.viewport 使用 cacheExtent， 請改用帶有 ScrollCacheExtent.viewport 的 scrollCacheExtent。

之前：

Viewport(
  cacheExtent: 0.5,
  cacheExtentStyle: CacheExtentStyle.viewport,
  slivers: // ...
)

之後：

Viewport(
  scrollCacheExtent: const ScrollCacheExtent.viewport(0.5),
  slivers: // ...
)

若您的程式碼直接在 RenderViewport 或類似的渲染物件上設定屬性， 請改用 scrollCacheExtent。

之前：

renderViewport.cacheExtent = 500.0;
renderViewport.cacheExtentStyle = CacheExtentStyle.pixel;

之後：

renderViewport.scrollCacheExtent = const ScrollCacheExtent.pixels(500.0);

登陸版本：3.41.0-0.0.pre
穩定版本：3.44

API 文件：

• ScrollCacheExtent
• ScrollView.scrollCacheExtent
• RenderViewportBase.scrollCacheExtent

相關 PR：

• Introduce ScrollCacheExtent