Skip to content
MarkasUI
Type to search

    Guide

    MarkasUI

    Form

    Feedback

    Overlay

    Navigation

    Data

    Sections

    Animations

    Backgrounds

    Buttons

    Templates

    Pages

    Badge

    Small pill-shaped status label with a colored dot for neutral, primary, success, warning, and danger.

    Badge
    Badge
    Badge
    Draft New Active Pending Failed
    DraftNewActivePendingFailed

    Badge

    <x-markas.badge variant="neutral" dot>Badge</x-markas.badge>
    import { Badge } from "@/components/markas/Badge";
    
    <Badge variant="neutral" dot>Badge</Badge>
    import Badge from "@/components/markas/Badge.vue";
    
    <Badge variant="neutral" dot>Badge</Badge>
    <script lang="ts">
      import Badge from "$lib/components/markas/Badge.svelte";
    </script>
    
    <div class="flex flex-wrap items-center gap-2">
      <Badge>Draft</Badge>
      <Badge variant="primary">New</Badge>
      <Badge variant="success">Active</Badge>
      <Badge variant="warning">Pending</Badge>
      <Badge variant="danger">Failed</Badge>
    </div>
    ---
    import Badge from "@/components/markas/Badge.astro";
    ---
    
    <div class="flex flex-wrap items-center gap-2">
      <Badge>Draft</Badge>
      <Badge variant="primary">New</Badge>
      <Badge variant="success">Active</Badge>
      <Badge variant="warning">Pending</Badge>
      <Badge variant="danger">Failed</Badge>
    </div>
    import { Component } from "@angular/core";
    import { Badge } from "./markas/badge.component";
    
    @Component({
      selector: "markas-example",
      imports: [Badge],
      template: `
        <div class="flex flex-wrap items-center gap-2">
          <span markas-badge>Draft</span>
          <span markas-badge variant="primary">New</span>
          <span markas-badge variant="success">Active</span>
          <span markas-badge variant="warning">Pending</span>
          <span markas-badge variant="danger">Failed</span>
        </div>
      `,
    })
    export default class BadgeExample {}

    Examples

    With icons

    Verified In review Rejected Featured
    VerifiedIn reviewRejectedFeatured
    Verified In review Rejected Featured
    Verified In review Rejected Featured
    Verified In review Rejected Featured

    Counts

    • Inbox 12
    • Mentions 3
    • Failed jobs 99+
    • Inbox12
    • Mentions3
    • Failed jobs99+
    • Inbox12
    • Mentions3
    • Failed jobs99+
    • Inbox 12
    • Mentions 3
    • Failed jobs 99+
    • Inbox12
    • Mentions3
    • Failed jobs99+

    Status in a list

    • Invoice #1024 Due Mar 12
      Paid
    • Invoice #1025 Due Mar 28
      Pending
    • Invoice #1026 Due Feb 20
      Overdue
    • Invoice #1027 Not sent yet
      Draft
    • Invoice #1024Due Mar 12
      Paid
    • Invoice #1025Due Mar 28
      Pending
    • Invoice #1026Due Feb 20
      Overdue
    • Invoice #1027Not sent yet
      Draft
    • Invoice #1024Due Mar 12
      Paid
    • Invoice #1025Due Mar 28
      Pending
    • Invoice #1026Due Feb 20
      Overdue
    • Invoice #1027Not sent yet
      Draft
    • Invoice #1024 Due Mar 12
      Paid
    • Invoice #1025 Due Mar 28
      Pending
    • Invoice #1026 Due Feb 20
      Overdue
    • Invoice #1027 Not sent yet
      Draft
    • Invoice #1024Due Mar 12
      Paid
    • Invoice #1025Due Mar 28
      Pending
    • Invoice #1026Due Feb 20
      Overdue
    • Invoice #1027Not sent yet
      Draft

    Installation

    npx markasui@latest add badge

    Usage

    <x-markas.badge>Draft</x-markas.badge>
    <x-markas.badge variant="success">Active</x-markas.badge>
    <x-markas.badge variant="danger">Failed</x-markas.badge>
    import { Badge } from "@/components/markas/Badge";
    
    <Badge>Draft</Badge>
    <Badge variant="success">Active</Badge>
    <Badge variant="danger">Failed</Badge>
    <script setup lang="ts">
    import Badge from "@/components/markas/Badge.vue";
    </script>
    
    <template>
      <Badge>Draft</Badge>
      <Badge variant="success">Active</Badge>
      <Badge variant="danger">Failed</Badge>
    </template>
    <script lang="ts">
      import Badge from "$lib/components/markas/Badge.svelte";
    </script>
    
    <Badge variant="success">Active</Badge>
    <Badge variant="primary" dot={false}>12</Badge>
    ---
    import Badge from "@/components/markas/Badge.astro";
    ---
    
    <Badge variant="success">Active</Badge>
    <Badge variant="primary" dot={false}>12</Badge>
    import { Component } from "@angular/core";
    import { Badge } from "./markas/badge.component";
    
    @Component({
      selector: "app-invoice-status",
      imports: [Badge],
      template: `
        <span markas-badge variant="success">Active</span>
        <span markas-badge variant="primary" [dot]="false">12</span>
      `,
    })
    export class InvoiceStatus {}
    • Success, warning, and danger text uses ink. The status color comes from the background, border, and dot, because light success and warning lack enough contrast for small text.

    Props

    NameTypeDefaultDescription
    variant'neutral' | 'primary' | 'success' | 'warning' | 'danger'neutralBackground, border, and status dot color.
    dotbooleantrueColored dot before the text. Turn it off for badges with an icon or a count.

    Accessibility

    • A plain span without a role. The badge text is read as is.
    • The colored dot is decorative (aria-hidden), so the status must be written in the text.
    • Success, warning, and danger text uses ink so contrast meets AA in light and dark mode.

    Related components

    More feedback components with the same classes in every framework.