搜索插件、代码仓与 APP 分类

badges 封面
插件详情v4.0.1

badges

一个用于创建徽章的包。徽章可用于任何小部件的附加标记,例如在购物车中显示项目数量。

AndroidiOSWebmacOSWindowsLinux
近 30 天下载
41.8万
喜欢数
3760
Pub 分数
160

安装插件

flutter pub add badges

插件介绍

基于插件公开信息、社区数据与项目使用情况整理的选型参考。

badges 包提供了一种简单的方法,可在 Flutter 应用中的任何小部件上添加装饰性徽章。这些徽章可以显示数字、标签或图标,常用于突出显示通知、购物车数量或状态指示器。该包设计简洁易用,支持多种自定义选项,如位置、形状、颜色和大小。该包与所有主要平台(包括 Android、iOS、Web、macOS、Windows 和 Linux)兼容,非常适合需要一致视觉反馈的跨平台应用。

适合场景

  • 在购物车中显示项目数量
  • 突出显示未读消息或通知
  • 指示产品可用性或状态
  • 向用户界面元素添加视觉标记
  • 显示进度或完成程度

主要特点

  • 与任何小部件的轻松集成
  • 可自定义徽章内容和样式
  • 支持多个位置(左上、右上等)
  • 跨平台兼容性
  • 轻量且高效
  • 可配置的颜色和形状

适合对象

  • 需要购物车计数器的电子商务应用
  • 用于通知的消息或社交媒体应用
  • 仪表板小部件带状态指示器
  • 需要视觉反馈的用户操作界面
  • 寻求轻量级徽章解决方案的开发者

使用建议

  • 可能需要仔细定位以避免与其他UI元素重叠
  • 有限的内置动画(可能需要外部动画包)
  • 不适用于复杂的交互式徽章
  • 最适合简单的数值或基于标签的指标
  • 性能影响可以忽略不计,但在大型列表中应进行测试

原始 README

以下为关联源码仓库的 README 原文快照,最新内容请访问源码仓库。

Pub Version popularity likes building style: flutter lints Package of the week

Installing:

In your pubspec.yaml

dependencies:
  badges: ^3.2.0

Attention! In Flutter 3.7 the Badge widget was introduced in the Material library, so to escape the ambiguous imports you need to import the package like this:

Option 1: namespace prefix

import 'package:badges/badges.dart' as badges;

and then use the "badges.Badge" widget instead of the "Badge" widget. The same for all the classes from this package.

Option 2: hide Flutter's Material Badge widget

import 'package:badges/badges.dart';
import 'package:flutter/material.dart' hide Badge;


Basic Usage:

    badges.Badge(
      badgeContent: Text('3'),
      child: Icon(Icons.settings),
    )

Advanced usage

    badges.Badge(
      position: badges.BadgePosition.topEnd(top: -10, end: -12),
      showBadge: true,
      ignorePointer: false,
      onTap: () {},
      badgeContent:
          Icon(Icons.check, color: Colors.white, size: 10),
      badgeAnimation: badges.BadgeAnimation.rotation(
        animationDuration: Duration(seconds: 1),
        colorChangeAnimationDuration: Duration(seconds: 1),
        loopAnimation: false,
        curve: Curves.fastOutSlowIn,
        colorChangeAnimationCurve: Curves.easeInCubic,
      ),
      badgeStyle: badges.BadgeStyle(
        shape: badges.BadgeShape.square,
        badgeColor: Colors.blue,
        padding: EdgeInsets.all(5),
        borderRadius: BorderRadius.circular(4),
        borderSide: BorderSide(color: Colors.white, width: 2),
        borderGradient: badges.BadgeGradient.linear(
            colors: [Colors.red, Colors.black]),
        badgeGradient: badges.BadgeGradient.linear(
            colors: [Colors.blue, Colors.yellow],
            begin: Alignment.topCenter,
            end: Alignment.bottomCenter,
        ),
        elevation: 0,
      ),
      child: Text('Badge'),
    ),


Animations:

From left to right:
1) Color change animation 2) BadgeAnimation.slide 3) BadgeAnimation.fade 4) BadgeAnimation.scale 5) BadgeAnimation.size 6) BadgeAnimation.rotation
Also, loop animation is available, this will loop the animation until you stop it.


Shapes:

From left to right:
1) BadgeShape.circle 2) BadgeShape.square 3) BadgeShape.twitter 4) BadgeShape.instagram


Migration from Badges 2:

Check out other Yako packages:

Badges

Settings UI

Status Alert

Full Screen Menu

Diagonal decoration

Yako Yheme Switch

and more to come!

所属分类

依赖

依赖清单 1 项

源码仓库

使用此插件的项目

所在榜单