Flutter中如何从多个页面访问同一个控制器？

当页面完全独立无法通过参数传递ScrollController时，可以用以下几种方式解决，同时保证控制器能被正确dispose：

方案1：基于通知机制的间接控制 #

不需要全局持有控制器，通过自定义Notification让原Widget自行处理滚动操作，完全规避跨页面传递控制器的问题：

1. 定义自定义Notification类

class ScrollCommandNotification extends Notification {
  final void Function(ScrollController) command;

  ScrollCommandNotification(this.command);
}

2. 在原Widget中监听该通知
   将滚动组件包裹在NotificationListener中，收到通知后调用自身控制器执行操作：

@override
Widget build(BuildContext context) {
  return NotificationListener<ScrollCommandNotification>(
    onNotification: (notification) {
      notification.command(controller);
      return true;
    },
    child: ListView(
      controller: controller,
      // 列表内容...
    ),
  );
}

3. 在其他页面发送通知触发滚动

// 例如触发滚动到顶部
ScrollCommandNotification((controller) {
  controller.animateTo(
    0,
    duration: const Duration(milliseconds: 300),
    curve: Curves.ease,
  );
}).dispatch(context);

这种方式下控制器始终属于原Widget，生命周期和原Widget绑定，无需额外处理dispose。

方案2：带生命周期绑定的全局状态管理 #

用ChangeNotifier封装控制器，将管理器的生命周期和原Widget绑定，确保控制器随原Widget销毁而释放：

1. 创建控制器管理类

class ScrollControllerManager extends ChangeNotifier {
  late ScrollController scrollController;

  void initController() {
    scrollController = ScrollController();
  }

  @override
  void dispose() {
    scrollController.dispose();
    super.dispose();
  }
}

2. 在原Widget中初始化并绑定生命周期

late ScrollControllerManager _manager;

@override
void initState() {
  super.initState();
  _manager = ScrollControllerManager();
  _manager.initController();
}

@override
void dispose() {
  _manager.dispose();
  super.dispose();
}

@override
Widget build(BuildContext context) {
  return ChangeNotifierProvider.value(
    value: _manager,
    child: ListView(
      controller: _manager.scrollController,
      // 列表内容...
    ),
  );
}

3. 在其他页面获取控制器

final manager = Provider.of<ScrollControllerManager>(context, listen: false);
manager.scrollController.animateTo(0, duration: const Duration(milliseconds: 300), curve: Curves.ease);

方案3：单例容器+Widget生命周期绑定 #

用单例类维护控制器的映射，在原Widget销毁时移除并释放控制器：

1. 创建单例控制器容器

class ScrollControllerContainer {
  static final ScrollControllerContainer _instance = ScrollControllerContainer._();
  factory ScrollControllerContainer() => _instance;
  ScrollControllerContainer._();

  final Map<String, ScrollController> _controllers = {};

  void register(String key, ScrollController controller) {
    _controllers[key] = controller;
  }

  ScrollController? get(String key) => _controllers[key];

  void unregister(String key) {
    _controllers[key]?.dispose();
    _controllers.remove(key);
  }
}

2. 在原Widget中注册和注销控制器

static const String _scrollKey = 'main_page_scroll';
late ScrollController _controller;

@override
void initState() {
  super.initState();
  _controller = ScrollController();
  ScrollControllerContainer().register(_scrollKey, _controller);
}

@override
void dispose() {
  ScrollControllerContainer().unregister(_scrollKey);
  super.dispose();
}

3. 在其他页面获取控制器

final controller = ScrollControllerContainer().get('main_page_scroll');
controller?.animateTo(0, duration: const Duration(milliseconds: 300), curve: Curves.ease);

内容的提问来源于stack exchange，提问作者Aymen Denoub