PDS proposals
← All proposals

Icon Button

Starting point for an IconButton proposal.

Extends a PDS componentOpen in Storybook

proposals/IconButton/custom.md30 lines · View on GitHub

Custom and net-new: IconButton

Everything in this proposal that is not plain PDS v2. npm run check:tokens reads this file: each net-new class, custom CSS variable and raw value found in the code must appear here in backticks.

Net-new components

None.

Additions to existing PDS components

  • On .pds-icon-button: .pds-icon-button--agentic

Net-new props

  • isAgentic: AI gradient border (needs hasBorder).

Custom CSS variables

  • --icon-button-background — set on .pds-icon-button
  • --icon-button-background-hover — set on .pds-icon-button
  • --icon-button-border — set on .pds-icon-button
  • --icon-button-border-hover — set on .pds-icon-button
  • --icon-button-fill — set on .pds-icon-button.pds-icon-button--agentic
  • --icon-button-foreground — set on .pds-icon-button
  • --icon-button-size — set on .pds-icon-button

Raw values kept on purpose

None.