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" />
The code above renders like:
Title default
Title ^1.9.0
Title beta
Title caution
Custom Children
<Badge>
accepts 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 the following props:
ts
interface Props {
// When `<slot>` is passed, this value gets ignored.
text?: string
// Defaults to `tip`.
type?: 'info' | 'tip' | 'warning' | 'danger'
}