# 預設多點觸控捲動

> ScrollBehaviors 現在會設定 Scrollables 如何回應 多點觸控手勢。





:::important
這些重大變更文件在其發布的版本時是準確的。隨著時間推移，這裡描述的
因應措施可能會變得不準確。一般而言，我們不會在每個版本發布時同步更新這些重大變更文件。

[重大變更索引檔案](/release/breaking-changes)列出了每個版本所建立的文件。
:::


## 摘要

`ScrollBehavior` 現在允許或不允許捲動速度受到螢幕上指標數量的影響。`ScrollBehavior.multitouchDragStrategy` 預設會防止多個指標同時與可捲動元件互動時影響捲動速度。

## 背景說明

在此變更之前，每個指標拖曳 `Scrollable` 元件 (Widget) 時，捲動速度都會增加。這種行為與在 Flutter 應用程式中與平台的預期互動不符。

現在，繼承的 `ScrollBehavior` 會根據 `ScrollBehavior.multitouchDragStrategy` 的設定，管理多個指標如何影響捲動元件 (Scrolling Widgets)。這個列舉型別 `MultitouchDragStrategy` 也可以設定為先前的行為。

## 變更說明

這項變更修正了用多根手指拖曳時，能夠意外提升捲動速度的問題。

如果您的應用程式依賴於先前的行為，您有多種方式可以控制與設定此功能。

- 擴充 `ScrollBehavior`、`MaterialScrollBehavior` 或 `CupertinoScrollBehavior`
  以修改預設行為，並覆寫
  `ScrollBehavior.multitouchDragStrategy`。

    - 使用您自訂的 `ScrollBehavior`，可以透過設定 `MaterialApp.scrollBehavior` 或 `CupertinoApp.scrollBehavior`，將其套用至整個應用程式。
    - 或者，如果只想套用於特定元件，請在該元件上方加入 `ScrollConfiguration`，並使用您自訂的 `ScrollBehavior`。

您的可捲動元件 (Scrollable Widgets) 會繼承並反映這個行為。

- 除了自行建立 `ScrollBehavior` 外，另一種變更預設行為的方式是複製現有的 `ScrollBehavior`，並設定不同的 `multitouchDragStrategy`。
    - 在您的元件樹中建立 `ScrollConfiguration`，並使用 `copyWith` 在目前的 context 中提供修改過的 `ScrollBehavior` 複本。

為了因應新的設定方式，
`DragGestureRecognizer` 也已更新，以支援在其他拖曳情境下的 `MultitouchDragStrategy`。

## 遷移指南

### 為您的應用程式設定自訂 `ScrollBehavior`

遷移前的程式碼：

```dart
MaterialApp(
  // ...
);
```

遷移後的程式碼：

```dart
class MyCustomScrollBehavior extends MaterialScrollBehavior {
  // Override behavior methods and getters like multitouchDragStrategy
  @override
  MultitouchDragStrategy getMultitouchDragStrategy(BuildContext context) => MultitouchDragStrategy.sumAllPointers;
}

// Set ScrollBehavior for an entire application.
MaterialApp(
  scrollBehavior: MyCustomScrollBehavior(),
  // ...
);
```

### 為特定元件設定自訂的 `ScrollBehavior`

遷移前的程式碼：

```dart
final ScrollController controller = ScrollController();
ListView.builder(
  controller: controller,
  itemBuilder: (BuildContext context, int index) {
    return Text('Item $index');
  },
);
```

遷移後的程式碼：

```dart
class MyCustomScrollBehavior extends MaterialScrollBehavior {
  // Override behavior methods and getters like multitouchDragStrategy
  @override
  MultitouchDragStrategy getMultitouchDragStrategy(BuildContext context) => MultitouchDragStrategy.sumAllPointers;
}

// ScrollBehavior can be set for a specific widget.
final ScrollController controller = ScrollController();
ScrollConfiguration(
  behavior: MyCustomScrollBehavior(),
  child: ListView.builder(
    controller: controller,
    itemBuilder: (BuildContext context, int index) {
      return Text('Item $index');
    },
  ),
);
```

### 複製並修改現有的 `ScrollBehavior`

遷移前的程式碼：

```dart
final ScrollController controller = ScrollController();
ListView.builder(
  controller: controller,
  itemBuilder: (BuildContext context, int index) {
    return Text('Item $index');
  },
);
```

遷移後的程式碼：

```dart
// ScrollBehavior can be copied and adjusted.
final ScrollController controller = ScrollController();
ScrollConfiguration(
  behavior: ScrollConfiguration.of(context).copyWith(
    multitouchDragStrategy: MultitouchDragStrategy.sumAllPointers,
  ),
  child: ListView.builder(
    controller: controller,
    itemBuilder: (BuildContext context, int index) {
      return Text('Item $index');
    },
  ),
);
```

## 時間軸

合併於版本：3.18.0-4.0.pre<br>
正式版本釋出：3.19.0

## 參考資料

API 文件：

* [`ScrollConfiguration`][]
* [`ScrollBehavior`][]
* [`MaterialScrollBehavior`][]
* [`CupertinoScrollBehavior`][]
* [`MultitouchDragStrategy`][]
* [`DragGestureRecognizer`][]

相關議題：

* [Issue #11884][]

相關 PR：

* [Introduce multi-touch drag strategies for DragGestureRecognizer][]


[`ScrollConfiguration`]: https://api.flutter.dev/flutter/widgets/ScrollConfiguration-class.html
[`ScrollBehavior`]: https://api.flutter.dev/flutter/widgets/ScrollBehavior-class.html
[`MaterialScrollBehavior`]: https://pub.dev/documentation/material_ui/latest/material_ui/MaterialScrollBehavior-class.html
[`CupertinoScrollBehavior`]: https://pub.dev/documentation/cupertino_ui/latest/cupertino_ui/CupertinoScrollBehavior-class.html
[`MultitouchDragStrategy`]: https://api.flutter.dev/flutter/gestures/MultitouchDragStrategy.html
[`DragGestureRecognizer`]: https://api.flutter.dev/flutter/gestures/DragGestureRecognizer-class.html
[Issue #11884]: https://github.com/flutter/flutter/issues/11884
[Introduce multi-touch drag strategies for DragGestureRecognizer]: https://github.com/flutter/flutter/pull/136708