Flutter 滚动组件内容更新时自动定位到底端的方法

2,257 阅读2分钟

问题

在使用Flutter的ListView等滚动组件做历史记录或日志记录时,需要在更新内容后立即定位到内容底部(默认是在顶部的)。

寻找解决方案

  1. ListView有一个reverse属性,如果把内容倒置,倒是可以总显示新内容。

但问题是内容少的时候,是直接靠底部显示的,这样看起来比较怪。可以在数据量少的情况下指定shrinkWrap为true,使滚动容器收缩

  1. ListView的ScrollController本身提供了像素滚动的方法,可以计算视口高度和内容总高度,然后调用Controller的jumpTo或animateTo

这是一个临时解决方案,需要测量出当前视口的高度,然后写在代码里,内容的高度根据子元素数目计算,需要子元素内容没太大差异,等高的情况就好控制

在Windows下效果尚可,但到苹果设备上由于物理滚动的特性,会很跳脱

  1. 找到一个新Controller可以控制滚动到当前选中的组件FixedExtentScrollController 原来是场误会,这个控制器是专门给新组件ListWheelScrollView用的,这是一个齿轮滚动选择的组件,被选中项总是在中间

最终方案

最后通过print ScrollController.position这个属性,发现它在运行中其实是ScrollPositionWithSingleContext的实例,这个实例可以直接获取到滚动组件的视口高度,可滚动范围等参数。

image.png

演示代码

import 'package:flutter/material.dart';

void main() {
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  // This widget is the root of your application.
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: MyHomePage(title: 'Flutter Demo For ListView'),
    );
  }
}

class MyHomePage extends StatefulWidget {
  const MyHomePage({Key? key, required this.title}) : super(key: key);

  final String title;

  @override
  _MyHomePageState createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  int _counter = 0;
  final controller = ScrollController();

  void _incrementCounter() {
    setState(() {
      _counter++;
    });
    WidgetsBinding.instance.addPostFrameCallback((timeStamp) {
      controller.animateTo(
        controller.position.maxScrollExtent,
        duration: const Duration(milliseconds: 200),
        curve: Curves.easeOutQuart,
      );
    });
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text(widget.title),
      ),
      body: Center(
        child: Container(
          width: 150,
          height: 300,
          decoration: BoxDecoration(
              border: Border.all(color: Colors.black26, width: 0.5)),
          child: ListView.builder(
            controller: controller,
            padding: const EdgeInsets.all(10),
            itemCount: _counter,
            itemBuilder: (context, index) => Text('This is row $index'),
          ),
        ),
      ),
      floatingActionButton: FloatingActionButton(
        onPressed: _incrementCounter,
        tooltip: 'Increment',
        child: const Icon(Icons.add),
      ),
    );
  }
}

后记

这里要注意的一点是,在加入新元素中调用滚动,是不能立即滚动的(代码中采用了延迟16ms,一帧的时间),否则就会出现滚动不到底的情况。因为加入元素是一个数据操作,要更新到界面需要等待下一次build,如果这个新元素还有入场动画,那么调用滚动的延迟最好delay到动画结束,否则获取的maxScrollExtend是不准确的。