企业官网建设流程全解析

Android-ActionItemBadge主题定制：7种内置样式+自定义颜色方案

【免费下载链接】Android-ActionItemBadgeThis library offers a simple method to add a small badge icon to your ActionBar-MenuItem项目地址: https://gitcode.com/gh_mirrors/an/Android-ActionItemBadge

Android-ActionItemBadge是一个专为Android应用开发的实用库，它提供了一种简单的方法来为ActionBar的MenuItem添加小型徽章图标，帮助开发者轻松实现通知计数、状态标记等常见UI需求。

🎨 内置主题样式概览

Android-ActionItemBadge库提供了7种预设的主题样式，每种样式都包含常规和大型两种尺寸，满足不同场景的显示需求。这些样式在ActionItemBadge.java中定义，通过枚举类型BadgeStyles统一管理。

1. 灰色系样式

• GREY：浅灰色背景，深灰色按压效果，黑色文本
• DARK_GREY：深灰色背景，近黑色按压效果，白色文本

图1：灰色系样式在应用中的实际效果展示

2. 彩色系样式

• RED：亮红色背景，深红色按压效果，白色文本
• BLUE：天蓝色背景，深蓝色按压效果，白色文本
• GREEN：浅绿色背景，深绿色按压效果，白色文本
• PURPLE：淡紫色背景，深紫色按压效果，白色文本
• YELLOW：亮黄色背景，深黄色按压效果，白色文本

图2：彩色系样式在应用中的实际效果展示，右上角紫色徽章为自定义样式

🚀 快速应用内置样式

使用内置样式非常简单，只需在更新徽章时指定所需的样式即可。以下是两种常用的使用方式：

直接更新现有MenuItem

ActionItemBadge.update(this, menu.findItem(R.id.item_samplebadge), FontAwesome.Icon.faw_android, ActionItemBadge.BadgeStyles.GREY, badgeCount);

通过Adder创建新的徽章MenuItem

new ActionItemBadgeAdder().act(this) .menu(menu) .title(R.string.sample_2) .itemDetails(0, SAMPLE2_ID, 1) .showAsAction(MenuItem.SHOW_AS_ACTION_ALWAYS) .add(ActionItemBadge.BadgeStyles.GREY_LARGE, 1);

🔧 自定义颜色方案详解

除了使用内置样式，Android-ActionItemBadge还支持完全自定义的颜色方案，让你的徽章与应用主题完美融合。

自定义样式的基本构造

创建自定义BadgeStyle需要以下几个核心参数：

• 样式类型（常规/大型）
• 布局资源
• 正常状态背景色
• 按压状态背景色
• 文本颜色

自定义示例：粉色徽章

// 创建常规尺寸自定义样式 BadgeStyle customStyle = new BadgeStyle( BadgeStyle.Style.DEFAULT, R.layout.menu_action_item_badge, Color.parseColor("#FE0665"), // 正常状态背景色 Color.parseColor("#CC0548"), // 按压状态背景色 Color.parseColor("#EEEEEE") // 文本颜色 ); // 创建大型尺寸自定义样式 BadgeStyle customBigStyle = new BadgeStyle( BadgeStyle.Style.LARGE, R.layout.menu_action_item_badge_large, Color.parseColor("#FE0665"), Color.parseColor("#CC0548"), Color.parseColor("#EEEEEE") );

高级样式定制

BadgeStyle类还提供了多种方法来进一步定制徽章的外观：

// 设置圆角弧度 badgeStyle.setCorner(12); // 设置描边宽度和颜色 badgeStyle.setStroke(2); badgeStyle.setStrokeColor(Color.WHITE);

💡 主题定制最佳实践

保持风格统一

• 在应用中使用不超过3种主要徽章颜色
• 为不同类型的通知（如消息、提醒、系统通知）分配固定颜色

考虑可访问性

• 确保文本颜色与背景色有足够对比度
• 徽章大小适中，确保数字清晰可见

适配不同Android版本

• 在res/values和res/values-v21等目录下提供不同版本的颜色资源
• 使用Color.parseColor()或资源引用确保颜色在各版本上一致显示

📦 如何获取该库

要在你的项目中使用Android-ActionItemBadge，首先需要克隆仓库：

git clone https://gitcode.com/gh_mirrors/an/Android-ActionItemBadge

然后按照项目文档中的说明将库集成到你的Android项目中。库的核心代码位于library/src/main/java/com/mikepenz/actionitembadge/library/目录下，你可以根据需要查看或修改源代码。

通过灵活运用内置样式和自定义颜色方案，Android-ActionItemBadge可以帮助你轻松实现既美观又实用的徽章通知功能，提升应用的用户体验。无论是简单的数字提示还是复杂的状态标记，这个库都能满足你的需求。

【免费下载链接】Android-ActionItemBadgeThis library offers a simple method to add a small badge icon to your ActionBar-MenuItem项目地址: https://gitcode.com/gh_mirrors/an/Android-ActionItemBadge