---
title: "Poll"
description: "A question, its answers, and the share of the vote behind each one."
---

A question, its answers, and the share of the vote behind each one. Compose it from the exported registry parts so local content and behaviour stay in the application while the visual contract stays token-driven.

_Live example of Poll — see the page for the rendered demo._

## Installation

```bash
npx newtui@latest add poll
```

Files written — React: components/ui/poll.tsx. Vue: components/ui/poll/Poll.vue, components/ui/poll/PollAnswer.vue, components/ui/poll/PollAnswers.vue, components/ui/poll/PollFooter.vue, components/ui/poll/PollQuestion.vue, components/ui/poll/index.ts.

## Usage

React:

```tsx
import { Poll } from "@/components/ui/poll"
```

Vue:

```ts
import { Poll, PollAnswer, PollAnswers, PollFooter, PollQuestion } from "@/components/ui/poll"
```

## API reference

**`Poll`**

| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| `children / default slot` | `React.ReactNode / Vue slot` | — | Content rendered inside the component. |
| `className / class` | `string` | — | Additional classes merged with the component defaults. |

## Accessibility

Preserve the native semantics of the rendered elements and pass through ARIA attributes when the surrounding context needs a label or description. Any interactive child needs a visible focus indicator, and meaning must not rely on colour alone.

## Tokens

Poll reads its colours, radii and motion from the `--newt-*` tokens. Override a token rather than editing the component.