# @justeattakeaway/pie-icon-button

> PIE Design System Icon Button built using Web Components

Latest version **2.8.4** (published 2026-11-18) · Apache-2.0 license · 0 weekly downloads

## Install

```sh
npm install @justeattakeaway/pie-icon-button
pnpm add @justeattakeaway/pie-icon-button
yarn add @justeattakeaway/pie-icon-button
bun add @justeattakeaway/pie-icon-button
```

## Health

**Score 65/100 (B)** — status: active.

Positive: has types; esm support; no vulnerabilities; recently updated; high maintenance score.

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 2.8.4 |
| Published | 2026-11-18 |
| First published | 2023-05-25 |
| Weekly downloads | 0 |
| License | Apache-2.0 |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 3 |
| Unpacked size | 55.1 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 42 |
| Author | Just Eat Takeaway.com - Design System Team |
| Maintainers | mwh1989, anastasiia.horban, ashleynolan, jamieomaguire, lizzie.turney, davidpn.11, roberto.santana, mmakwe-onyeka, fozzie-bot, siggerzz, maledr5 |

## Links

- npm: https://www.npmjs.com/package/@justeattakeaway/pie-icon-button
- Repository: https://github.com/justeattakeaway/pie
- Homepage: https://webc.pie.design/?path=/docs/components-icon-button--overview
- Issues: https://github.com/justeattakeaway/pie/issues
- npm.io page: https://npm.io/package/@justeattakeaway/pie-icon-button

## Dependencies (3)

- [@justeattakeaway/pie-spinner](https://npm.io/package/@justeattakeaway/pie-spinner.md) 1.5.12
- [@justeattakeaway/pie-webc-core](https://npm.io/package/@justeattakeaway/pie-webc-core.md) 22.1.0
- [@justeattakeaway/pie-icons-webc](https://npm.io/package/@justeattakeaway/pie-icons-webc.md) 1.31.1

## Recent versions

- 2.8.4 (latest) — 2026-11-18
- 0.0.0-snapshot-release-20261118102158 (snapshot-release) — 2026-11-18
- 0.21.3-next.0 (next) — 2023-11-16
- 2.8.3 — 2026-11-18
- 0.0.0-snapshot-release-20261117171525 — 2026-11-17
- 0.0.0-snapshot-release-20261117100349 — 2026-11-17
- 0.0.0-snapshot-release-20261117084101 — 2026-11-17
- 0.0.0-snapshot-release-20261110113822 — 2026-11-10
- 2.8.2 — 2026-11-05
- 0.0.0-snapshot-release-20261104130132 — 2026-11-04
- 0.0.0-snapshot-release-20261104103259 — 2026-11-04
- 0.0.0-snapshot-release-20261103180059 — 2026-11-03
- 2.8.1 — 2026-10-14
- 0.0.0-snapshot-release-20261013151643 — 2026-10-13
- 0.0.0-snapshot-release-20261013150640 — 2026-10-13
- … 347 more at https://npm.io/package/@justeattakeaway/pie-icon-button/versions

## README

# @justeattakeaway/pie-icon-button

[Source Code](https://github.com/justeattakeaway/pie/tree/main/packages/components/pie-icon-button) | [Design Documentation](https://pie.design/components/icon-button) | [NPM](https://www.npmjs.com/package/@justeattakeaway/pie-icon-button)

<p>
  <a href="https://www.npmjs.com/@justeattakeaway/pie-icon-button">
    <img alt="GitHub Workflow Status" src="https://img.shields.io/npm/v/@justeattakeaway/pie-icon-button.svg">
  </a>
</p>

`@justeattakeaway/pie-icon-button` is a Web Component built using the Lit library. It offers a simple and accessible icon button component for web applications.

## Table of Contents

- [Installation](#installation)
- [Documentation](#documentation)
  - [Properties](#properties)
  - [Slots](#slots)
  - [CSS Variables](#css-variables)
  - [Events](#events)
- [Usage Examples](#usage-examples)
- [Questions and Support](#questions-and-support)
- [Contributing](#contributing)

## Installation

> To install any of our web components in your application, we would suggest following the [getting started guide](https://webc.pie.design/?path=/docs/introduction-getting-started--docs) to set up your project.

Ideally, you should install the component using the **`@justeattakeaway/pie-webc`** package, which includes all of the components. Or you can install the individual component package.

## Documentation

### Properties
| Prop | Options | Description | Default |
|------|---------|-------------|---------|
| `aria` | `{ label?: string }`, `{ labelledby?: string }`, `{ describedby?: string }`, `{ description?: string }`, `{ expanded?: boolean }`, `{ controls?: string }`, `{ haspopup?: string }` | The ARIA attributes available to use on the icon button. Offers `label`, `labelledby`, `describedby`, `description`, `expanded`, `controls`, and `haspopup`. `description` is applied as an `aria-description` attribute, so the text travels as a string and is not bound by IDREF resolution. | `undefined` |
| `size` | `"xsmall"`, `"small"`, `"medium"`, `"large"` | Set the size of the icon button. | `"medium"` |
| `variant` | `"primary"`, `"primary-alternative"`, `"primary-alternative-dark"`, `"secondary"`, `"outline"`, `"ghost"`, `"ghost-secondary"`, `"ghost-secondary-dark"`, `"inverse"`, `"inverse-outline"`, `"ghost-inverse"`, `"ghost-inverse-light"`, `"translucent"` | Set the variant of the icon button. | `"primary"` |
| `disabled` | `true`, `false` | If true, disables the icon button. | `false` |
| `isLoading` | `true`, `false` | If true, displays a loading indicator inside the icon button. | `false` |


### Slots
| Slot      | Description                                                                 |
|-----------|-----------------------------------------------------------------------------|
| `default` | The default slot is used to pass an icon into the icon button component. Please use an icon from `justeattakeaway/pie-icons-webc`.  |

### CSS Variables
This component does not expose any CSS variables for style overrides.

### Events

This component does not emit any custom events. In order to add event listening to this component, you can treat it like a native HTML element in your application.

## Usage Examples

**For HTML:**

```js
// import as module into a js file e.g. main.js
import '@justeattakeaway/pie-webc/components/icon-button.js';
import '@justeattakeaway/pie-icons-webc/dist/IconClose.js';
```

```html
<!-- pass js file into <script> tag -->
<pie-icon-button onclick="e => console.log(e)">
  <icon-close></icon-close>
</pie-icon-button>
<script type="module" src="/main.js"></script>
```

**For Native JS Applications, Vue, Angular, Svelte, etc.:**

```js
// Vue templates (using Nuxt 3)
import '@justeattakeaway/pie-webc/components/icon-button.js';

<pie-icon-button @click="handleClick">
  <icon-close></icon-close>
</pie-icon-button>
```

**For React Applications:**

```jsx
import { PieIconButton } from '@justeattakeaway/pie-webc/react/icon-button.js';
import { IconClose } from '@justeattakeaway/pie-icons-webc/dist/react/IconClose.js';

<PieIconButton onClick={handleClick}>
  <IconClose></IconClose>
</PieIconButton>
```

## Questions and Support

If you work at Just Eat Takeaway.com, please contact us on **#help-designsystem**. Otherwise, please raise an issue on [Github](https://github.com/justeattakeaway/pie/issues).

## Contributing

Check out our [contributing guide](https://github.com/justeattakeaway/pie/wiki/Contributing-Guide) for more information on [local development](https://github.com/justeattakeaway/pie/wiki/Contributing-Guide#local-development) and how to run specific [component tests](https://github.com/justeattakeaway/pie/wiki/Contributing-Guide#testing).

---
_Source: https://npm.io/package/@justeattakeaway/pie-icon-button · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
