Skip to content

Label

Label for status and state of something.

Usage

Basic Usage

Default color of label is black

Label
Label
preview
vue
<template>
  <p-label>Label</p-label>
  <p-label>
    <span>Label</span>
    <pi-checkmark-circle-solid-16 />
  </p-label>
</template>

Colors

Label available in 4 different colors. There are primary, info, success, warning, and danger.

Label
Label
Label
Label
Label
preview
vue
<template>
  <p-label color="primary">Label</p-label>
  <p-label color="info">Label</p-label>
  <p-label color="success">Label</p-label>
  <p-label color="warning">Label</p-label>
  <p-label color="danger">Label</p-label>
</template>

Custom Color

label
label
label
preview
vue
<template>
  <p-label class="bg-gold-40">label</p-label>
  <p-label class="text-yellow-30">label</p-label>
  <p-label 
    class="bg-purple-0 text-purple-40 dark:bg-purple-50 dark:text-purple-20">
    label
  </p-label>
</template>

Variants

Label has 3 variants namely default, light and dot. When variant is not set, label will looks as a default

Label
Label
Label
preview
vue
<template>
  <p-label>Label</p-label>
  <p-label variant="light">Label</p-label>
  <p-label variant="dot">Label</p-label>
</template>

Sample Light Variant

Label
Label
Label
Label
Label
preview
vue
<template>
  <p-label color="primary" variant="light">Label</p-label>
  <p-label color="info" variant="light">Label</p-label>
  <p-label color="warning" variant="light">Label</p-label>
  <p-label color="success" variant="light">Label</p-label>
  <p-label color="danger" variant="light">Label</p-label>
</template>

Sample Dot Variant

Label
Label
Label
Label
Label
preview
vue
<template>
  <p-label color="primary" variant="dot">Label</p-label>
  <p-label color="info" variant="dot">Label</p-label>
  <p-label color="warning" variant="dot">Label</p-label>
  <p-label color="success" variant="dot">Label</p-label>
  <p-label color="danger" variant="dot">Label</p-label>
</template>

Sizing

Label has 4 size, namely lg, md, sm and xs. When size is not set, default label is md

Label
Label
Label
Label
preview
vue
<template>
  <p-label color="info" size="lg">Label</p-label>
  <p-label color="info" size="md">Label</p-label>
  <p-label color="info" size="sm">Label</p-label>
  <p-label color="info" size="xs">Label</p-label>
</template>

Dismissible

Label has dismiss feature. It can be show or hide by dismissable props. If dismissable set to true, dismiss button will show.

Label
Label
Label
preview
vue
<template>
  <p-label color="info" :dismissable="true">Label</p-label>
  <p-label color="info" variant="light" :dismissable="true">Label</p-label>
  <p-label color="info" variant="dot" :dismissable="true">Label</p-label>
</template>

Variables

Label use local CSS variables for enhanced real-time customization. Use this variable for level color (like badge) customization.

.label.label--default

sass
--p-label-bg-variant-default: theme(backgroundColor.inverse);
--p-label-bg-dark-variant-default: theme(backgroundColor.dark.inverse);
--p-label-text-variant-default: theme(textColor.state-emphasis);
--p-label-text-dark-variant-default: theme(textColor.dark.on-emphasis);

.label.label--variant-dot

sass
--p-label-dot-default: theme(backgroundColor.inverse);
--p-label-dot-dark-default: theme(backgroundColor.dark.inverse);

API

Props

PropsTypeDefaultDescription
colorString-Label color variant, valid value is primary, info, success, warning and danger
variantStringdefaultLabel variant, valid value is default, light and dot.
sizeStringmdLabel variant, valid value is lg, md, sm and xs.
dismissableBooleanfalseShow / Hide dismiss button

Slots

NameDescription
defaultContent to place in badge

Events

NameArgumentsDescription
dismissed-Event when close button clicked

Released under the MIT License.