Skip to content

Badge ​

The badge lets you add status to your headers. For example, it could be useful to specify the section's type, or supported version.

Usage ​

You may use the Badge component which is globally available.

html
### Title <Badge type="info" text="default" />
### Title <Badge type="tip" text="^1.9.0" />
### Title <Badge type="warning" text="beta" />
### Title <Badge type="danger" text="caution" />

Code above renders like:

Title default ​

Title ^1.9.0 ​

Title beta ​

Title caution ​

Custom Children ​

<Badge> accept children, which will be displayed in the badge.

html
### Title <Badge type="info">custom element</Badge>

Title custom element ​

Customize Type Color ​

You can customize the style of badges by overriding css variables. The following are the default values:

css
:root {
  --vp-badge-info-border: transparent;
  --vp-badge-info-text: var(--vp-c-text-2);
  --vp-badge-info-bg: var(--vp-c-default-soft);

  --vp-badge-tip-border: transparent;
  --vp-badge-tip-text: var(--vp-c-brand-1);
  --vp-badge-tip-bg: var(--vp-c-brand-soft);

  --vp-badge-warning-border: transparent;
  --vp-badge-warning-text: var(--vp-c-warning-1);
  --vp-badge-warning-bg: var(--vp-c-warning-soft);

  --vp-badge-danger-border: transparent;
  --vp-badge-danger-text: var(--vp-c-danger-1);
  --vp-badge-danger-bg: var(--vp-c-danger-soft);
}

<Badge> ​

<Badge> component accepts following props:

ts
interface Props {
  // When `<slot>` is passed, this value gets ignored.
  text?: string

  // Defaults to `tip`.
  type?: 'info' | 'tip' | 'warning' | 'danger'
}

Released under the MIT License.