Flutter ListView 分页加载更多效果
对于REST API接口,大部分情况下都得处理分页问题。
分页可以让我们把大量数据分割成一个个小段,分次加载。这样可以有效避免因为一次load全部数据而导致客户端变慢的问题。
本文介绍Flutter ListView组件的分页实现,数据来源于HTTP请求。当用户下拉时,APP自动加载更多数据。
1 创建 Stateful Widgets
首先,要为 ListView 绑定为 Stateful 组件,以便能加载新数据。
ListView的状态(state)信息可以在组件创建时异步加载,也能在组件的生命周期里面用setState
修改。
import 'package:flutter/material.dart';
import 'package:dio/dio.dart';
void main() => runApp(MyApp());
class MyApp extends StatelessWidget {
@override
Widget build(BuildContext context) {
return MaterialApp(
title: 'Flutter Demo',
theme: ThemeData(
primarySwatch: Colors.blue,
),
home: MyHomePage(),
);
}
}
class MyHomePage extends StatefulWidget {
@override
_MyHomePageState createState() => _MyHomePageState();
}
class _MyHomePageState extends State<MyHomePage> {
String nextPage = https://swapi.co/api/people;
ScrollController _scrollController = new ScrollController();
bool isLoading = false;
List names = new List();
….
@override
Widget build(BuildContext context) {
return Scaffold(
appBar: AppBar(
title: const Text(Pagination),
),
body: Container(
child: _buildList(),
),
resizeToAvoidBottomPadding: false,
);
}
}
这里,当我们下拉但是还未收到数据时,resizeToAvoidBottomPadding
可以保留出一个空位,loading效果就能显示在这个空位中。
2 使用dio拉取HTTP接口数据
为模拟实际场景,我们这里从API接口拉取数据,以让我们更好地理解Flutter的分页机制。
这里我们用公开的SWAPI接口,这个接口支持分页返回人名。
2.1 添加依赖
dependencies:
# ....
dio: 2.0.22 # check for latest version.
dio是Dart的Http客户端,支持拦截器、全局配置、表单数据、请求撤销、文件下载和超时等。
2.2 请求数据方法
因为 SWAPI接口返回数据包含下一页URL,所以数据请求方法我们这样写:
ffinal dio = new Dio();
void _getMoreData() async {
if (!isLoading) {
setState(() {
isLoading = true;
});
final response = await dio.get(nextPage);
nextPage = response.data['next'];
setState(() {
isLoading = false;
names.addAll(response.data['results']);
});
}
}
在 _getMoreData
方法中,我们通过网络请求来获取列表的更多数据。
3 加载更多数据
接着我们来看看 scrollController
组件。scrollController
是一个滑动监听组件,这里我们用来控制何时加载数据。
当我们滑动界面时,如果没有达到尾页,并且数据不是正在加载中状态,scrollController
就会检查当前视图所在的位置来决定是否加载更多数据。
@override
void initState() {
this._getMoreData();
super.initState();
_scrollController.addListener(() {
if (_scrollController.position.pixels ==
_scrollController.position.maxScrollExtent) {
_getMoreData();
}
});
}
@override
void dispose() {
_scrollController.dispose();
super.dispose();
}
ListView
支持 scrollController
事件绑定,当用户在ListView
中滑动时,会出发 scrollController
事件。
现在,当我们滑动到单个 ListView
底部时,_getMoreData()
会获取新数据,并保存到组件的state中。
4 显示ListView加载状态
在ListView builder中,我们使用一个技巧来让最后一行显示加载条(ProgressBar)。
Widget _buildProgressIndicator() {
return new Padding(
padding: const EdgeInsets.all(8.0),
child: new Center(
child: new Opacity(
opacity: isLoading ? 1.0 : 0.0,
child: new CircularProgressIndicator(),
),
),
);
}
Widget _buildList() {
return ListView.builder(
//+1 for progressbar
itemCount: names.length + 1,
itemBuilder: (BuildContext context, int index) {
if (index == names.length) {
return _buildProgressIndicator();
} else {
return new ListTile(
title: Text((names[index]['name'])),
onTap: () {
print(names[index]);
},
);
}
},
controller: _scrollController,
);
}
5 完整代码
import 'package:flutter/material.dart';
import 'package:dio/dio.dart';
void main() => runApp(MyApp());
class MyApp extends StatelessWidget {
@override
Widget build(BuildContext context) {
return MaterialApp(
title: 'Flutter Demo',
theme: ThemeData(
primarySwatch: Colors.<em>blue</em>,
),
home: MyHomePage(),
);
}
}
class MyHomePage extends StatefulWidget {
@override
_MyHomePageState createState() => _MyHomePageState();
}
class _MyHomePageState extends State<MyHomePage> {
String nextPage = https://swapi.co/api/people;
ScrollController _scrollController = new ScrollController();
bool isLoading = false;
List names = new List();
final dio = new Dio();
void _getMoreData() async {
if (!isLoading) {
setState(() {
isLoading = true;
});
final response = await dio.get(nextPage);
nextPage = response.data['next'];
setState(() {
isLoading = false;
names.addAll(response.data['results']);
});
}
}
@override
void initState() {
this._getMoreData();
super.initState();
_scrollController.addListener(() {
if (_scrollController.position.pixels ==
_scrollController.position.maxScrollExtent) {
_getMoreData();
}
});
}
@override
void dispose() {
_scrollController.dispose();
super.dispose();
}
Widget _buildProgressIndicator() {
return new Padding(
padding: const EdgeInsets.all(8.0),
child: new Center(
child: new Opacity(
opacity: isLoading ? 1.0 : 00,
child: new CircularProgressIndicator(),
),
),
);
}
Widget _buildList() {
return ListView.builder(
//+1 for progressbar
itemCount: names.length + 1,
itemBuilder: (BuildContext context, int index) {
if (index == names.length) {
return _buildProgressIndicator();
} else {
return new ListTile(
title: Text((names[index]['name'])),
onTap: () {
print(names[index]);
},
);
}
},
controller: _scrollController,
);
}
@override
Widget build(BuildContext context) {
return Scaffold(
appBar: AppBar(
title: const Text(Pagination),
),
body: Container(
child: _buildList(),
),
resizeToAvoidBottomPadding: false,
);
}
}
英文原文:Flutter ListView REST API Pagination
这个itemcount+1的操作挺妙的,我都是往list插入数据,结果会对后续的操作有影响,谢谢楼主的分享