Flutter高级动画进度指示器插件nw_advance_animated_progress_indicator的使用

本文将介绍如何在Flutter项目中使用nw_advance_animated_progress_indicator插件来创建高级动画进度指示器。该插件支持线性和圆形两种类型的进度指示器，并且可以通过简单的配置实现流畅的动画效果。

Flutter AnimatedProgressIndicator

这个基于Flutter的动画小部件包旨在以响应式风格展示动画进度指示器。它同时支持圆形和线性进度条。

插件链接

插件地址：
https://pub.dev/packages/nw_advance_animated_progress_indicator

安装插件

在pubspec.yaml文件中添加以下依赖：

dependencies:
  nw_advance_animated_progress_indicator: ^版本号

然后运行以下命令安装插件：

flutter packages get

进入示例目录并运行应用：

cd example
flutter clean
flutter run

热重载应用以重新播放动画：

Hot restart app with "R"

要运行完整的示例应用：

cd example
mv lib/main.dart tmp && mv lib/main.dart.bk lib/main.dart && mv tmp lib/main.dart.bk
flutter clean
flutter run

开始使用

为了使用此插件，请先导入：

import 'package:nw_advance_animated_progress_indicator/nw_advance_animated_progress_indicator.dart';

基本实现代码如下：

Container(
  alignment: Alignment.center,
  margin: const EdgeInsets.all(10),
  child: AnimatedLinearProgressIndicator(
    percentage: _percentage, // 当前进度值
    animationDuration: const Duration(seconds: 1), // 动画持续时间
    label: 'Dart', // 显示的标签
  ),
)

示例代码

以下是一个完整的示例代码，展示了如何在Flutter应用中使用nw_advance_animated_progress_indicator插件。

文件：example/lib/main.dart

import 'package:flutter/material.dart';
import 'package:nw_advance_animated_progress_indicator/nw_advance_animated_progress_indicator.dart';

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

class MyApp extends StatelessWidget {
  const MyApp({Key? key}) : super(key: key);

  // 应用根组件
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Animated Progress Indicator',
      darkTheme: ThemeData.dark().copyWith(),
      themeMode: ThemeMode.dark,
      home: const MyHomePage(title: 'Animated Progress Indicator'),
    );
  }
}

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

  final String title;

  @override
  State<MyHomePage> createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  double _percentage = 0.0;

  // 增加进度
  void _incrementPercentage() {
    setState(() {
      _percentage = _percentage + 0.1;
    });
  }

  // 减少进度
  void _decrementPercentage() {
    setState(() {
      _percentage = _percentage - 0.1;
    });
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text(widget.title),
      ),
      body: Column(
        children: [
          // 圆形进度条
          Container(
            alignment: Alignment.center,
            margin: const EdgeInsets.all(10),
            child: AnimatedCircularProgressIndicator(
              percentage: _percentage, // 当前进度值
              animationDuration: const Duration(seconds: 1), // 动画持续时间
            ),
          ),
          const SizedBox(height: 20), // 空白间距
          // 线性进度条
          Container(
            alignment: Alignment.center,
            margin: const EdgeInsets.all(10),
            child: AnimatedLinearProgressIndicator(
              percentage: _percentage, // 当前进度值
              animationDuration: const Duration(seconds: 1), // 动画持续时间
              label: 'Dart', // 显示的标签
            ),
          ),
        ],
      ),
      floatingActionButton: Column(
        mainAxisSize: MainAxisSize.min,
        children: [
          FloatingActionButton(
            onPressed: _incrementPercentage,
            tooltip: 'Increment',
            child: const Icon(Icons.add),
          ),
          const SizedBox(height: 20),
          FloatingActionButton(
            onPressed: _decrementPercentage,
            tooltip: 'Decrement',
            child: const Icon(Icons.remove),
          ),
        ],
      ),
    );
  }
}

对象定义

以下是AnimatedLinearProgressIndicator和AnimatedCircularProgressIndicator的构造函数定义：

// 线性进度条
AnimatedLinearProgressIndicator({
  Key? key,
  required this.percentage,
  required this.label,
  this.percentageTextStyle,
  this.labelStyle,
  this.animationDuration,
  this.indicatorColor,
  this.indicatorBackgroundColor,
}) : super(key: key);

// 圆形进度条
const AnimatedCircularProgressIndicator({
  Key? key,
  required this.percentage,
  this.animationDuration,
  this.percentageTextStyle,
  this.indicatorColor,
  this.indicatorBackgroundColor,
}) : super(key: key);