Skip to content

Pill

Pill is a type of button that is often used as a filter, but can also be used as a rounded button for overlays, etc.

React

released

Vue

released

Elements

released

Android

released

iOS

released

Example

Usage

Design Guidelines

See Figma: Warp - Components / Pill

Questions?

Feel free to ask any questions on usage in the Warp DS Slack channel: #nmp-warp-design-system

Frameworks

Import

js
import { Pill } from "@warp-ds/react";

Syntax

Filter Pill

jsx
<Pill label="Filter Pill" />

Filter Pill with changed pill screen reader label

jsx
<Pill label="Filter Pill" openSRLabel="Activate Filter" />

Closable Filter Pill

jsx
<Pill canClose label="Closable Filter Pill" />

Closable Filter Pill with changed close button screen reader label

jsx
<Pill canClose label="Closable Filter Pill" closeSRLabel="Deactivate Filter" />

Suggestion Pill

jsx
<Pill suggestion label="Suggestion Pill" />

Closable Suggestion Pill

jsx
<Pill suggestion canClose label="Closable Suggestion Pill" />

Props

Optional Props

nametypedefaultnotes

label

string

undefined

The text content of the pill.

icon

ReactNode

undefined

Used to render an icon inside the pill. You can pass any valid HTML. This will override the label property. @deprecated Do not use.

canClose

boolean

false

Whether the pill should be removable via a close button.

openSRLabel

string

"Open filter"

Label read by screen readers when targeting the pill.

closeSRLabel

string

"Remove filter {label}"

Label read by screen readers when targeting the close button.

suggestion

boolean

false

Whether the pill should be rendered as a suggestion.

className

string

undefined

Additional classes applied to the button element of the pill as long as canClose is set to false.

Events

namewhen

onClick

Action to be called when the pill is clicked.

onClose

Action to be called when the close button is clicked.

Released under the Apache 2.0 License.