Skip to content

React

The PillButton component renders a button with a pill-shaped design.

Pill buttons are secondary interactive elements used for filtering, tagging, or toggling options whitin the interface. They are visually lighter than standard buttons and should never be used for primary actions.

There are two main use cases:

  • Selectable Pills: used to represent filters or toggles that can be selected/deselected.
  • Informational Pills: used to highlight contextual information (e.g. labels or statuses).

PillButtonProperties extends <React.HTMLAttributes<HTMLButtonElement>> which means it includes all standard HTML attributes that can be applied to a button element.

Prop Type Description Optional
text string The text label displayed inside the pill button ❌
className ClassValue Custom class names applied to the button element ✅
buttonSize 'sm' | 'md' | 'lg' Defines the size of the button ✅
isHighlight boolean Indicates if the button should appear highlighted ✅
isSelected boolean Indicates if the button is currently selected ✅
isCta boolean Marks the button as a Call-To-Action (CTA) ✅
onOverlay boolean Indicates if the button is displayed on an overlay ✅
leadingIcon ToyotaIcon | LexusIcon Icon displayed before the text ✅
trailingIcon ToyotaIcon | LexusIcon Icon displayed after the text ✅
import { PillButton } from '@tmedxp/react-components';
const PillButtonExample = () => {
return <PillButton text="Pill Button" />;
};
export { PillButtonExample };