Flutter 左右列表联动:分类定位与滚动同步

从分类高度累计计算偏移,让左侧点击和右侧滚动保持同一选中状态。

适用版本

原项目发布于 2022 年,采用固定网格尺寸的无额外依赖方案。

本文目录
  1. 计算每个分类的位置
  2. 左侧点击定位
  3. 右侧滚动同步选中项
  4. 尺寸变化与控制器释放
  5. 参考与源码

原项目实现了类似商品分类页的左右列表:点击左侧分类,右侧滚动到对应位置;手动滚动右侧时,左侧跟随选中。核心数据是一组分类起始偏移量。

计算每个分类的位置

固定网格中,分类高度由标题、网格行数、单元格高度和间距组成。计算必须与真正的布局使用同一套数值。下面示例暂不包含行间距和内边距。

dart
List<double> sectionOffsets({
  required List<int> counts,
  required int columns,
  required double itemHeight,
  required double titleHeight,
}) {
  final offsets = <double>[];
  var current = 0.0;
  for (final count in counts) {
    offsets.add(current);
    final rows = (count / columns).ceil();
    current += titleHeight + rows * itemHeight;
  }
  return offsets;
}

原代码使用三列网格,并按左右区域 flex 比例计算右侧宽度。整理后使用累计值完成一次遍历,避免为每个分类从头重复累加。

左侧点击定位

dart
Future<void> selectSection(int index) async {
  if (!_rightController.hasClients || index >= _offsets.length) return;
  final position = _rightController.position;
  final target = _offsets[index]
      .clamp(position.minScrollExtent, position.maxScrollExtent)
      .toDouble();
  await _rightController.animateTo(
    target,
    duration: const Duration(milliseconds: 350),
    curve: Curves.easeInOut,
  );
}

ScrollController 在布局完成并关联列表后才有有效范围。空数据时不要访问偏移列表的 last;窗口宽度或网格列数变化时,偏移量也要重新计算。

右侧滚动同步选中项

dart
void onRightScroll() {
  if (!_rightController.hasClients || _offsets.isEmpty) return;
  final offset = _rightController.offset;
  var selected = 0;
  for (var i = 1; i < _offsets.length; i++) {
    if (_offsets[i] > offset + 0.5) break;
    selected = i;
  }
  if (selected != _selectedIndex) {
    setState(() => _selectedIndex = selected);
  }
}

只在分类变化时更新状态,避免每个滚动像素都重建左侧列表。如果最后一个分类很短,它的起点可能无法滚到顶部;可以为右侧末尾增加补齐空间,也可以在滚动到底时单独映射到末项。

尺寸变化与控制器释放

图片比例、文本换行和动态内容都会改变分类高度。固定高度计算适合尺寸可预测的内容;高度不可预测时,需要基于实际布局位置定位。页面退出时移除监听并释放自己创建的控制器。

dart
@override
void dispose() {
  _rightController.removeListener(onRightScroll);
  _rightController.dispose();
  super.dispose();
}

原项目:左右分类列表

参考与源码

作者:NeverOuO。原载 NeverOuO 个人小站,现收录于云屿来文章与教程。

返回全部文章

把好用的工具分享给朋友

分享

发送链接,让朋友直接打开这个页面。

访问统计

我们统计页面浏览、渠道来源、产品入口点击与分享次数,用于了解产品如何被发现。这项统计不使用用户标识、Cookie 或跨站追踪,也不读取上传文件或表单内容。