适用版本
原项目发布于 2022 年,采用固定网格尺寸的无额外依赖方案。
原项目实现了类似商品分类页的左右列表:点击左侧分类,右侧滚动到对应位置;手动滚动右侧时,左侧跟随选中。核心数据是一组分类起始偏移量。
计算每个分类的位置
固定网格中,分类高度由标题、网格行数、单元格高度和间距组成。计算必须与真正的布局使用同一套数值。下面示例暂不包含行间距和内边距。
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 比例计算右侧宽度。整理后使用累计值完成一次遍历,避免为每个分类从头重复累加。
左侧点击定位
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;窗口宽度或网格列数变化时,偏移量也要重新计算。
右侧滚动同步选中项
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);
}
}
只在分类变化时更新状态,避免每个滚动像素都重建左侧列表。如果最后一个分类很短,它的起点可能无法滚到顶部;可以为右侧末尾增加补齐空间,也可以在滚动到底时单独映射到末项。
尺寸变化与控制器释放
图片比例、文本换行和动态内容都会改变分类高度。固定高度计算适合尺寸可预测的内容;高度不可预测时,需要基于实际布局位置定位。页面退出时移除监听并释放自己创建的控制器。
@override
void dispose() {
_rightController.removeListener(onRightScroll);
_rightController.dispose();
super.dispose();
}



