Badge

Badge is a small status indicator for another element.


// import as component
import Badge from 'primevue/badge';

// import as directive
import BadgeDirective from 'primevue/badgedirective';

app.directive('badge', BadgeDirective);

Text to display is defined with the value property.

2

<Badge value="2"></Badge>

Severity defines the variant of a badge.

26841235

<Badge value="2"></Badge>
<Badge value="6" severity="secondary"></Badge>
<Badge value="8" severity="success"></Badge>
<Badge value="4" severity="info"></Badge>
<Badge value="12" severity="warn"></Badge>
<Badge value="3" severity="danger"></Badge>
<Badge value="5" severity="contrast"></Badge>

Use the size property to customize the dimensions of a Badge.

8642

<Badge value="8" size="xlarge" severity="success"></Badge>
<Badge value="6" size="large" severity="warn"></Badge>
<Badge value="4" severity="info"></Badge>
<Badge value="2" size="small"></Badge>

A Badge can be added to any element using the directive.


<span v-badge="2">
    <i class="pi pi-bell" style="font-size: 2rem" />
</span>
<span v-badge.danger="'5+'">
    <i class="pi pi-calendar" style="font-size: 2rem" />
</span>
<span v-badge.danger>
    <i class="pi pi-envelope" style="font-size: 2rem" />
</span>

Buttons have built-in support for badges to display a badge inline.


<Button type="button" label="Emails" badge="8" />
<Button type="button" label="Messages" icon="pi pi-users" severity="secondary" badge="4" badgeSeverity="info" />

Screen Reader

Badge does not include any roles and attributes by default, any attribute is passed to the root element so aria roles and attributes can be added if required. If the badges are dynamic, aria-live may be utilized as well. In case badges need to be tabbable, tabindex can be added to implement custom key handlers.

Keyboard Support

Component does not include any interactive elements.