Flutter动画列表插件animation_list的使用
Flutter动画列表插件animation_list的使用
Animation List
一个简单的动画列表视图小部件。当它被构建时,列表项会通过滑动和弹跳的方式展示。
⚙ Preview
⚡ Installation
在你的pubspec.yaml
文件中添加animation_list: ^3.1.0
依赖,并导入:
import 'package:animation_list/animation_list.dart';
ℹ️ How to use
只需添加一个带有必要参数的AnimationList
小部件。
示例代码
import 'package:animation_list/animation_list.dart';
import 'package:flutter/material.dart';
void main() {
runApp(MyApp());
}
class MyApp extends StatelessWidget {
@override
Widget build(BuildContext context) {
return MaterialApp(
debugShowCheckedModeBanner: false,
theme: ThemeData(
primarySwatch: Colors.blue,
visualDensity: VisualDensity.adaptivePlatformDensity,
),
home: MyHomePage(title: 'Animation List Demo'),
);
}
}
class MyHomePage extends StatefulWidget {
MyHomePage({Key? key, this.title}) : super(key: key);
final String? title;
@override
_MyHomePageState createState() => _MyHomePageState();
}
class _MyHomePageState extends State<MyHomePage> {
final List<Map<String, dynamic>> data = [
{'title': '1111', 'backgroundColor': Colors.grey},
{'title': '2222', 'backgroundColor': Colors.red},
{'title': '3333', 'backgroundColor': Colors.yellow},
{'title': '4444', 'backgroundColor': Colors.blue},
{'title': '5555', 'backgroundColor': Colors.green},
{'title': '6666', 'backgroundColor': Colors.orange},
{'title': '7777', 'backgroundColor': Colors.brown},
{'title': '8888', 'backgroundColor': Colors.purple},
];
Widget _buildTile(String? title, Color? backgroundColor) {
return Container(
height: 100,
margin: EdgeInsets.symmetric(horizontal: 10, vertical: 5),
decoration: BoxDecoration(
borderRadius: BorderRadius.all(Radius.circular(25)),
color: backgroundColor,
),
child: Center(child: Text(title ?? '', style: TextStyle(fontSize: 20))),
);
}
@override
Widget build(BuildContext context) {
return Scaffold(
appBar: AppBar(
title: Text(widget.title ?? ''),
),
body: Center(
child: AnimationList(
duration: 1500,
reBounceDepth: 30,
children: data.map((item) {
return _buildTile(item['title'], item['backgroundColor']);
}).toList(),
),
),
);
}
}
在这个示例中,我们创建了一个包含多个颜色块的动画列表。每个颜色块都有一个标题文本,并且在显示时会有滑动和弹跳的效果。
🔧 Properties
Attribute | Data type | Description | Default |
---|---|---|---|
key | Key | 控制一个widget如何替换另一个widget | - |
controller | ScrollController | 可用于控制滚动位置的对象 | - |
primary | bool | 是否为与父级PrimaryScrollController关联的主要滚动视图 | - |
physics | ScrollPhysics | 滚动视图应如何响应用户输入 | - |
shrinkWrap | bool | 滚动方向上的滚动视图范围是否应由查看的内容确定 | false |
padding | EdgeInsetsGeometry | 子组件的内边距 | - |
cacheExtent | double | 在可见区域前后缓存即将可见项目的区域 | - |
children | List<Widget> | 填充ListView所需的子组件 | - |
semanticChildCount | int | 将贡献语义信息的子组件数量 | - |
dragStartBehavior | DragStartBehavior | 决定拖动开始行为的方式 | DragStartBehavior.start |
keyboardDismissBehavior | ScrollViewKeyboardDismissBehavior | 定义此ScrollView将如何自动关闭键盘 | ScrollViewKeyboardDismissBehavior.manual |
restorationId | String | 保存和恢复可滚动组件滚动偏移量的恢复ID | - |
clipBehavior | Clip | 内容将根据此选项进行裁剪(或不裁剪) | Clip.hardEdge |
duration | int | 动画运行的毫秒数 | 1300 |
reBounceDepth | double | 弹跳深度值 | 10.0 |
opacityRange | Tween<double> | 透明度变化的Tween | Tween(begin: 0.0, end: 1.0) |
animationDirection | AnimationDirection | 动画方向(垂直 / 水平 / 两者) | AnimationDirection.vertical |
🤗 Contributing
欢迎贡献!如果你有改进这个项目的方法,请提交issue或提交pull request。
确保你的请求有意义,并且在提交pull request之前已经本地测试过应用。
🙋♂️ Support
如果你喜欢这个项目,给它一个⭐并分享给朋友们吧!
更多关于Flutter动画列表插件animation_list的使用的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html
更多关于Flutter动画列表插件animation_list的使用的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html
当然,以下是一个关于如何在Flutter中使用animation_list
插件的示例代码。animation_list
是一个假定的插件名称,因为实际上Flutter生态系统中没有一个广泛使用的直接名为animation_list
的插件。不过,我会基于创建一个带有动画效果的列表项的概念来提供一个示例。
在这个示例中,我们将创建一个简单的列表,每个列表项在滚动到视图中时会有一个淡入动画效果。为了模拟这种效果,我们将使用Flutter的动画和滚动监听功能。
首先,确保你的pubspec.yaml
文件中添加了必要的依赖项(虽然这里我们主要使用Flutter核心功能,但通常你会添加UI和动画相关的库,如flutter_hooks
用于状态管理,不过这里为了简单起见,我们只用Flutter核心库):
dependencies:
flutter:
sdk: flutter
接下来是主代码main.dart
:
import 'package:flutter/material.dart';
void main() {
runApp(MyApp());
}
class MyApp extends StatelessWidget {
@override
Widget build(BuildContext context) {
return MaterialApp(
title: 'Flutter Animation List Example',
theme: ThemeData(
primarySwatch: Colors.blue,
),
home: AnimatedListScreen(),
);
}
}
class AnimatedListScreen extends StatefulWidget {
@override
_AnimatedListScreenState createState() => _AnimatedListScreenState();
}
class _AnimatedListScreenState extends State<AnimatedListScreen> with SingleTickerProviderStateMixin {
final List<String> items = List.generate(20, (i) => "Item ${i + 1}");
final ScrollController _scrollController = ScrollController();
final Map<int, AnimationController> _controllers = {};
@override
void initState() {
super.initState();
_scrollController.addListener(_onScroll);
}
@override
void dispose() {
_scrollController.removeListener(_onScroll);
_controllers.values.forEach((controller) => controller.dispose());
super.dispose();
}
void _onScroll() {
final double maxScroll = _scrollController.position.maxScrollExtent;
final double currentScroll = _scrollController.position.pixels;
final double itemHeight = 50.0; // Assume each list item is 50 pixels high
final int firstVisibleIndex = (currentScroll / itemHeight).floor().toInt();
final int lastVisibleIndex = ((currentScroll + MediaQuery.of(context).size.height) / itemHeight).ceil().toInt();
for (int i = firstVisibleIndex; i < items.length && i <= lastVisibleIndex; i++) {
_animateItem(i);
}
}
void _animateItem(int index) {
if (!_controllers.containsKey(index)) {
final AnimationController controller = AnimationController(
duration: const Duration(milliseconds: 300),
vsync: this,
)..addListener(() {
setState(() {});
});
_controllers[index] = controller;
controller.forward();
}
}
@override
Widget build(BuildContext context) {
return Scaffold(
appBar: AppBar(
title: Text('Animated List'),
),
body: ListView.builder(
itemCount: items.length,
itemBuilder: (context, index) {
final AnimationController? controller = _controllers[index];
final Animation<double> opacity = controller?.drive(Tween(begin: 0.0, end: 1.0)) ?? Tween(begin: 1.0, end: 1.0).animate(AlwaysStoppedAnimation(1.0));
return AnimatedBuilder(
animation: opacity,
child: ListTile(
title: Text(items[index]),
),
builder: (context, child) {
return Opacity(
opacity: opacity.value,
child: child,
);
},
);
},
controller: _scrollController,
),
);
}
}
解释
-
依赖项:我们使用Flutter核心库来创建这个应用。
-
MyApp
类:这是应用的入口点,它配置了一个MaterialApp
并设置了主页为AnimatedListScreen
。 -
AnimatedListScreen
类:这是我们的主屏幕,它是一个有状态的组件,用于管理动画控制器和滚动监听器。 -
滚动监听:我们使用
ScrollController
来监听列表的滚动事件,并根据滚动的位置来计算哪些列表项应该开始动画。 -
动画控制器:我们为每个可见的列表项创建一个
AnimationController
,并使用Tween
和AnimatedBuilder
来创建淡入动画。 -
列表构建:我们使用
ListView.builder
来构建列表,并根据动画的进度调整每个列表项的透明度。
这个示例展示了如何在Flutter中创建一个带有滚动触发动画效果的列表。尽管我们假设了一个名为animation_list
的插件,但你可以根据这个示例来集成和使用任何类似的动画库或自己实现更复杂的动画效果。