Flutter动画列表插件animation_list的使用

发布于 1周前 作者 caililin 来自 Flutter

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

如果你喜欢这个项目,给它一个⭐并分享给朋友们吧!

buymeacoffee-violet-badge


更多关于Flutter动画列表插件animation_list的使用的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html

1 回复

更多关于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,
      ),
    );
  }
}

解释

  1. 依赖项:我们使用Flutter核心库来创建这个应用。

  2. MyApp:这是应用的入口点,它配置了一个MaterialApp并设置了主页为AnimatedListScreen

  3. AnimatedListScreen:这是我们的主屏幕,它是一个有状态的组件,用于管理动画控制器和滚动监听器。

  4. 滚动监听:我们使用ScrollController来监听列表的滚动事件,并根据滚动的位置来计算哪些列表项应该开始动画。

  5. 动画控制器:我们为每个可见的列表项创建一个AnimationController,并使用TweenAnimatedBuilder来创建淡入动画。

  6. 列表构建:我们使用ListView.builder来构建列表,并根据动画的进度调整每个列表项的透明度。

这个示例展示了如何在Flutter中创建一个带有滚动触发动画效果的列表。尽管我们假设了一个名为animation_list的插件,但你可以根据这个示例来集成和使用任何类似的动画库或自己实现更复杂的动画效果。

回到顶部