Skip to content

Badge 徽标

该组件一般用于图标右上角显示未读的消息数量,提示用户点击,有圆点和圆包含文字两种形式。

TuniaoUI微标包含了点和带内容的两种形式。

注意

该组件内部是使用了absulote绝对定位,所以如果使用了当前组件的父元素需要设置position:relative相对定位。再通过调整topright参数实现位置设置。

平台差异说明

AppH5微信小程序支付宝小程序百度小程序头条小程序QQ小程序
兼容中兼容中兼容中兼容中

基本使用

微标内容通过slot传入。

vue
<tn-badge>99</tn-badge>

设置微标的颜色

可以通过backgrundColorfontColor来设置颜色信息。设置微标的颜色可以使用TuniaoUI内置样式中的颜色值进行设置

vue
<tn-badge backgroundColor="#01BEFF" fontColor="#080808">99</tn-badge>
<tn-badge backgroundColor="tn-bg-blue" fontColor="tn-color-white">99</tn-badge>

设置微标大小

可以通过设置tn-badge组件的radius设置微标的圆大小。

vue
<tn-badge :redius="32">99</tn-badge>

设置微标为一个点

可以通过设置tn-badge组件的dot为true,将微标变成一个点,此时微标内的内容将不再进行显示。

vue
<tn-badge :dot="true"></tn-badge>

使微标的中心点和父元素的右上角重合

为了方便用户在不定内容时也可以实现中心点重合,提供了一个参数,通过设置translateCenter可以使微标的中心点和父元素的右上角重合。

vue
<tn-badge :translateCenter="true">99+</tn-badge>

API

Props

属性名说明类型默认值可选值
index用于区分多个微标的点击事件String|Number0-
backgroundColor背景颜色String#FFFFFF颜色的十六进制值,rgba(),rgb(),TuniaoUI内置的颜色类名
fontColor字体颜色String-颜色的十六进制值,rgba(),rgb(),TuniaoUI内置的颜色类名
fontSize字体大小Number18-
fontUnit字体大小的单位Stringrpx-
radius微标大小Number--
padding内边距String4rpx 8rpx-
margin外边距String--
dot显示为一个点Booleanfalsetrue
absolute相对于父元素绝对定位Booleanfalsetrue
topabsolutetrue时生效,相对于父元素上边的位置String--
rightabsolutetrue时生效,相对于父元素右边的位置String--
translateCenterabsolutetrue时生效,中心点与父元素右上角重合Booleantruefalse

Slots

名称说明
default微标显示的内容,可自定义内容展示

Event

事件名称说明回调参数
click按钮点击事件index