# IconButton - **Category:** Inputs (`inputs`) - **Slug:** `inputs/icon-button` - **Status:** stable - **Platforms:** web, mobile - **Import:** `import { IconButton } from "@protocore/pds";` - **Docs:** https://pds.protocore.io/components/inputs/icon-button > A square, icon-only action control — Button's affordances with a required aria-label. ## When to use Use **IconButton** when the action is well-understood from its glyph alone and space is tight — toolbars, table row actions, the close affordance on a panel. - If the meaning isn't unmistakable from the icon, use a text **Button** (with a `startIcon` if you like) instead — an ambiguous glyph is worse than a word. - Always supply an `aria-label`, and consider pairing the control with a **Tooltip** so sighted users get the same label on hover. - For a menu of actions behind one trigger, wrap an IconButton with **DropdownMenu**. ## Mobile (React Native) **Preview.** `@protocore/pds-mobile` ships the React Native sibling of **IconButton**. It mirrors the web API where React Native allows; the package is a **preview** with no device-level QA yet, so pin it and expect small changes. Import it from the mobile package (not `@protocore/pds`), inside a `` — there is no stylesheet, so `style` (a `ViewStyle`) replaces `className` and every value comes from the theme: ```tsx import { IconButton } from "@protocore/pds-mobile"; ``` **Parity with web.** Same interaction model as the mobile Button — square, icon-only, `Pressable`-based. - `accessibilityLabel` is **required** (typed non-optional) — it replaces web's `aria-label` for the icon-only control. - The icon is passed as `children`; press inverts/fills exactly like Button. - `onPress` replaces `onClick`. ```tsx ``` ## Props | Prop | Type | Required | Default | Description | | --- | --- | --- | --- | --- | | `aria-label` | `string` | yes | — | Accessible name for the control. Required — an icon-only button has no visible text. | | `asChild` | `boolean` | no | `false` | Render as the single child element (Radix `Slot`) instead of a `