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.on-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.