# @blaze-react/select

> The select component represents an input that provides a menu of options

Latest version **0.8.0-alpha.112** (published 2025-10-01) · GPL-3.0 license · 0 weekly downloads

## Install

```sh
npm install @blaze-react/select
pnpm add @blaze-react/select
yarn add @blaze-react/select
bun add @blaze-react/select
```

## Health

**Score 35/100 (D)** — status: stable.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support; pre 1.0.

Negative: stale.

## Facts

| | |
|---|---|
| Version | 0.8.0-alpha.112 |
| Published | 2025-10-01 |
| First published | 2019-06-20 |
| Weekly downloads | 0 |
| License | GPL-3.0 |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 1 |
| Unpacked size | 1.3 MB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Author | byte9 |
| Maintainers | marekb9, mcabrerapf, daoyong, grzegorzi, ishrat, andypail, tanane |

## Links

- npm: https://www.npmjs.com/package/@blaze-react/select
- npm.io page: https://npm.io/package/@blaze-react/select

## Dependencies (1)

- [@blaze-react/tooltip](https://npm.io/package/@blaze-react/tooltip.md) ^0.8.0-alpha.112

## Recent versions

- 0.8.0-alpha.112 (latest) — 2025-10-01
- 0.8.0-alpha.120 (alpha) — 2026-10-12
- 0.8.0-alpha.119 — 2026-10-06
- 0.8.0-alpha.117 — 2026-03-11
- 0.8.0-alpha.115 — 2026-02-23
- 0.8.0-alpha.114 — 2026-01-08
- 0.8.0-alpha.110 — 2025-09-10
- 0.8.0-alpha.103 — 2025-07-07
- 0.8.0-alpha.102 — 2025-07-01
- 0.8.0-alpha.101 — 2025-06-27
- 0.8.0-alpha.100 — 2025-02-26
- 0.8.0-alpha.98 — 2024-11-27
- 0.8.0-alpha.97 — 2024-11-21
- 0.8.0-alpha.96 — 2024-11-21
- 0.8.0-alpha.95 — 2024-11-21
- … 123 more at https://npm.io/package/@blaze-react/select/versions

## README

## Description

The select component represents an input that provides a menu of options.

## Usage

- Array of options

```js
const options = ['London', 'Paris', 'Munich'];

<Select label="Select a city" options={options} onChange={({ event, value }) => {}} required />;
```

- Multidimensional Array of options

```js
const options = [
  ['08001', 'Barcelona'],
  ['17006', 'Madrid'],
];

<Select label="Select label" selected="08001" options={options} onChange={({ event, value }) => {}} />;
```

- Array of objects

```js
const arrayOfObjects = [
  {
    id: 1,
    username: 'Oscar',
    age: 26,
  },
  {
    id: 2,
    username: 'Ismael',
    age: 23,
  },
];

<Select
  label="Select user"
  selected="1"
  options={options}
  keys={['id', 'username']}
  onChange={({ event, value }) => {}}
/>;
```

- Disabling some options

```js
const disabled = ["17006"]


<Select label="Disabled option" onChange={({ event, value }) => {}} options={options} disabled={disabled} />
```

- By default is disabled if none options

```js
<Select label="Disabled" onChange={({ event, value }) => {}} options={[]} />
```

## API

##### Select can receive a number of `props` as follow:

| NAME              |   TYPE   |     DEFAULT      |
| :---------------- | :------: | :--------------: |
| label             |  String  |        ''        |
| required          | Boolean  |      false       |
| options           |  Array   |        []        |
| selected          |  String  |        ''        |
| keys              |  Array   |        []        |
| onChange          | Function |     () => {}     |
| disabled          |  Array   |        []        |
| selectDisabled    | Boolean  |      false       |
| showDefaultOption | Boolean  |       true       |
| defaultTextValue  |  String  | Please Choose... |

---
_Source: https://npm.io/package/@blaze-react/select · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
