Flutter自定义矩形进度条实现详解

在Flutter应用开发中,进度条是一个常见的UI组件,用于展示任务的完成进度。本文将详细介绍如何实现一个支持动画效果的自定义矩形进度条。

功能特点

  • 支持圆角矩形外观
  • 平滑的动画过渡效果
  • 可自定义渐变色
  • 可配置边框宽度和颜色
  • 支持进度更新动画

实现原理

该进度条的实现主要基于Flutter的CustomPaintCustomPainter,通过绘制路径来实现圆角矩形的进度效果。

1. 基础组件结构

首先,我们创建一个StatefulWidget来管理进度条的状态:

dart:lib/rectangle_progress_bar.dart 复制代码
class RectangleProgressBar extends StatefulWidget {
  final double progress;
  final Size size;
  final double borderRadius;
  final Duration duration;

  const RectangleProgressBar({
    super.key,
    required this.progress,
    this.size = const Size(200, 200),
    this.borderRadius = 20,
    this.duration = const Duration(milliseconds: 1000),
  });
  
  // ...
}

2. 动画控制

State类中,我们使用AnimationController来控制进度条的动画效果:

dart:lib/rectangle_progress_bar.dart 复制代码
class _RectangleProgressBarState extends State<RectangleProgressBar>
    with SingleTickerProviderStateMixin {
  // ... 初始化代码 ...

  @override
  void didUpdateWidget(RectangleProgressBar oldWidget) {
    if (oldWidget.progress != widget.progress) {
      _previousProgress = _animation.value;
      _animation = Tween<double>(
        begin: _previousProgress,
        end: widget.progress,
      ).animate(CurvedAnimation(
        parent: _controller,
        curve: Curves.easeInOutCubic,
      ));
      _controller.reset();
      _controller.forward();
    }
  }
}

3. 自定义绘制器

核心的绘制逻辑在RectangleProgressPainter类中实现:

dart:lib/rectangle_progress_bar.dart 复制代码
class RectangleProgressPainter extends CustomPainter {
  // ... 属性定义 ...

  @override
  void paint(Canvas canvas, Size size) {
    final rect = Rect.fromLTWH(0, 0, size.width, size.height);
    final path = _createRoundedRectanglePath(size);
    _drawBackground(canvas, path);
    _drawProgress(canvas, path, rect);
  }
}

4. 路径创建

进度条的路径创建是一个重要部分,需要精确控制每个圆角的绘制:

dart:lib/rectangle_progress_bar.dart 复制代码
Path _createRoundedRectanglePath(Size size) {
  final path = Path();
  // 从顶部中点开始绘制
  path.moveTo(size.width / 2, 0);
  // 绘制右上角
  path.lineTo(size.width - borderRadius, 0);
  path.arcToPoint(
    Offset(size.width, borderRadius),
    radius: Radius.circular(borderRadius),
  );
  // ... 继续绘制其他边和圆角 ...
  return path;
}

5. 进度绘制

进度条的绘制使用了路径度量和渐变色:

dart:lib/rectangle_progress_bar.dart 复制代码
void _drawProgress(Canvas canvas, Path path, Rect rect) {
  final pathMetric = path.computeMetrics().first;
  final progressLength = pathMetric.length * value;
  final progressPath = Path()
    ..addPath(
      pathMetric.extractPath(0, progressLength),
      Offset.zero,
    );
    
  final progressPaint = Paint()
    ..style = PaintingStyle.stroke
    ..strokeWidth = strokeWidth
    ..strokeCap = StrokeCap.round
    ..strokeJoin = StrokeJoin.miter
    ..isAntiAlias = true
    ..shader = LinearGradient(
      begin: Alignment.centerRight,
      end: Alignment.centerLeft,
      colors: valueColors,
    ).createShader(rect);

  canvas.drawPath(progressPath, progressPaint);
}

使用方法

使用这个自定义进度条非常简单:

dart 复制代码
RectangleProgressBar(
  progress: 0.7, // 70%的进度
  size: Size(300, 300),
  borderRadius: 25,
  duration: Duration(milliseconds: 1500),
)

性能优化

为了确保性能,我们实现了shouldRepaint方法来控制重绘逻辑:

dart:lib/rectangle_progress_bar.dart 复制代码
@override
bool shouldRepaint(RectangleProgressPainter oldDelegate) {
  return oldDelegate.value != value ||
      !listEquals(valueColors, oldDelegate.valueColors) ||
      bgStrokeColor != oldDelegate.bgStrokeColor ||
      strokeWidth != oldDelegate.strokeWidth ||
      progressStrokeWidth != oldDelegate.progressStrokeWidth ||
      borderRadius != oldDelegate.borderRadius;
}

总结

这个自定义矩形进度条实现了以下特点:

  1. 使用CustomPainter实现自定义绘制
  2. 支持平滑的动画效果
  3. 可自定义外观(颜色、大小、圆角等)
  4. 使用路径度量实现精确的进度显示
  5. 支持渐变色效果

通过这个实现,我们不仅创建了一个美观的UI组件,还学习了Flutter中自定义绘制和动画的相关知识。这个组件可以在各种场景下使用,比如文件上传、下载进度显示等。

相关推荐
比格丽巴格丽抱2 小时前
flutter项目苹果编译运行打包上线
flutter·ios
长亭外的少年2 小时前
Kotlin 编译失败问题及解决方案:从守护进程到 Gradle 配置
android·开发语言·kotlin
SoaringHeart2 小时前
Flutter进阶:基于 MLKit 的 OCR 文字识别
前端·flutter
网络安全-老纪3 小时前
iOS应用网络安全之HTTPS
web安全·ios·https
建群新人小猿5 小时前
会员等级经验问题
android·开发语言·前端·javascript·php
1024小神6 小时前
tauri2.0版本开发苹果ios和安卓android应用,环境搭建和最后编译为apk
android·ios·tauri
兰琛6 小时前
20241121 android中树结构列表(使用recyclerView实现)
android·gitee
AiFlutter6 小时前
Flutter通过 Coap发送组播
flutter
Y多了个想法6 小时前
RK3568 android11 适配敦泰触摸屏 FocalTech-ft5526
android·rk3568·触摸屏·tp·敦泰·focaltech·ft5526
lzhdim7 小时前
iPhone 17 Air看点汇总:薄至6mm 刷新苹果轻薄纪录
ios·iphone