直接用 u-badge 或 t-badge 可实现徽标,但需配对父容器定位(position: relative)、offset 数组(单位 rpx,负值左上拉)、平台限制(iOS 截断 99+、安卓需 setTimeout、uni.setTabBarBadge text 必为字符串)及动态数字精度对齐(decimals 显式匹配、u-count-to 参数全为 Number、$nextTick 后启动)。

直接用 u-badge 或 t-badge 就能实现,但必须配对好父容器定位、数值类型和平台限制——漏掉任一环,红点不显示、数字错位、安卓静默失败都是常态。
u-badge 的父容器必须设 position: relative
组件内部默认用 absolute 定位,如果父元素没声明 position: relative,徽标会相对于页面根节点偏移,位置完全失控。
- 务必在包裹
的外层上加style="position: relative" -
offset是数组格式,如[-10, -10],单位是rpx,负值才能把角标往左上拉进图标范围 - 若不想用绝对定位,显式传
:absolute="false",然后靠 flex 或 margin 手动调位置
数字角标在安卓/iOS 原生 tabbar 上容易失效
uni.setTabBarBadge 不是万能的:iOS 会挤压两位以上数字,安卓部分 ROM(如旧版 EMUI)压根不支持数字只认红点,且必须传字符串。
- 参数
text必须是字符串,uni.setTabBarBadge({ text: '5' })有效,{ text: 5 }静默失败 - iOS 超过 99 建议截断为
'99+',否则字体缩放变形、圆框撑开 - 安卓首次调用建议加
setTimeout(() => uni.setTabBarBadge(...), 100),确保 tabbar 已挂载 - 红点(
uni.showTabBarRedDot)和数字角标是两个独立状态,removeTabBarBadge不会自动恢复红点
t-badge / u-count-to 混用时 decimal 和 type 易冲突
当徽标内容是动态数字(比如「+12.5」),t-badge 的 count 和 u-count-to 的 end-val 都要对齐小数精度,否则滚动动画卡顿或显示 NaN。
-
count设为12.5,t-badge默认不保留小数,得配合overflow或自定义插槽渲染 - 若用
u-count-to做滚动数字徽标,start-val、end-val、duration必须全为Number类型,字符串如"12.5"会导致NaN -
decimals必须显式匹配小数位数,end-val=12.5→:decimals="1",否则末尾补零或截断异常 - 小程序中不要在
onLoad立即启动u-count-to,等this.$nextTick()后再调.start()
最易被忽略的是:红点和数字角标在不同平台由不同原生控件渲染,你写的逻辑可能只在 H5 正常,真机上 iOS 和安卓行为完全不同——别信模拟器,每次改完必须拿三台真机(iOS 17+、Android 14、低端安卓)各测一遍。











