Flutter ListView横竖屏切换时adjustPositionForNewDimensions未触发问题

问题根源 #

横竖屏切换时，ScrollPosition会先重置维度状态（将haveDimensions设为false），之后才会重新获取新的尺寸参数，导致correctForNewDimensions的检查被跳过，进而未触发adjustPositionForNewDimensions方法。

可行解决方案 #

方案1：通过LayoutBuilder手动监听尺寸变化

用LayoutBuilder包裹ListView，实时获取容器尺寸，当尺寸变化时手动计算选中项的目标偏移量并调整：

LayoutBuilder(
  builder: (context, constraints) {
    WidgetsBinding.instance.addPostFrameCallback((_) {
      final scrollController = yourScrollController;
      final selectedIndex = yourSelectedIndex;
      final itemHeight = yourItemHeight; // 若高度不固定，可通过RenderObject获取
      final newViewportHeight = constraints.maxHeight;
      final targetOffset = (selectedIndex * itemHeight) - (newViewportHeight - itemHeight) / 2;
      // 限制偏移范围，避免越界
      scrollController.jumpTo(targetOffset.clamp(0.0, scrollController.position.maxScrollExtent));
    });
    return ListView(
      controller: yourScrollController,
      physics: yourCustomScrollPhysics,
      // 其他配置项
    );
  },
)

方案2：监听SizeChangedLayoutNotification

给ListView添加NotificationListener，捕获尺寸变化通知后触发位置修正：

NotificationListener<SizeChangedLayoutNotification>(
  onNotification: (notification) {
    WidgetsBinding.instance.addPostFrameCallback((_) {
      final scrollController = yourScrollController;
      final selectedIndex = yourSelectedIndex;
      final itemHeight = yourItemHeight;
      final viewportHeight = scrollController.position.viewportDimension;
      final targetOffset = (selectedIndex * itemHeight) - (viewportHeight - itemHeight) / 2;
      scrollController.jumpTo(targetOffset.clamp(0.0, scrollController.position.maxScrollExtent));
    });
    return true;
  },
  child: ListView(
    physics: yourCustomScrollPhysics,
    controller: yourScrollController,
    // 其他配置项
  ),
)

方案3：自定义ScrollPosition（底层修复）

如果想从滚动系统层面解决，可以自定义ScrollPosition，重写didUpdateMetrics方法强制触发位置修正：

class CenteredScrollPosition extends ScrollPositionWithSingleContext {
  CenteredScrollPosition({
    required super.physics,
    required super.context,
    super.initialPixels,
    super.keepScrollOffset,
    super.oldPosition,
    super.debugLabel,
    required this.selectedIndex,
    required this.itemHeight,
  });

  final int selectedIndex;
  final double itemHeight;

  @override
  void didUpdateMetrics() {
    super.didUpdateMetrics();
    // 尺寸变化且已获取新维度时，修正位置
    if (hasDimensions && previousMetrics?.viewportDimension != viewportDimension) {
      final targetOffset = (selectedIndex * itemHeight) - (viewportDimension - itemHeight) / 2;
      jumpTo(targetOffset.clamp(0.0, maxScrollExtent));
    }
  }
}

// 使用时给ScrollController绑定自定义Position
final scrollController = ScrollController(
  position: CenteredScrollPosition(
    physics: yourCustomScrollPhysics,
    context: Scrollable.of(context),
    selectedIndex: yourSelectedIndex,
    itemHeight: yourItemHeight,
  ),
);

注意事项 #

• 若列表项高度不固定，需提前缓存每个项的高度，或通过ListView的RenderObject实时获取对应项的尺寸。
• 所有偏移计算都要通过clamp限制范围，避免滚动到无效区域。

内容的提问来源于stack exchange，提问作者Dirk-Jan