Select

A dropdown select component with ASCII styling and arrow indicator.

Docs•API Reference
â–¼
â–¼
â–¼

Selected: option1

Country: None

Installation

npm install react-ascii-ui

Usage

import { AsciiSelect } from 'react-ascii-ui';

export default function Example() {
  const [value, setValue] = useState('');

  return (
    <AsciiSelect 
      value={value}
      onChange={(e) => setValue(e.target.value)}
    >
      <option value="">Choose an option</option>
      <option value="option1">Option 1</option>
      <option value="option2">Option 2</option>
      <option value="option3">Option 3</option>
    </AsciiSelect>
  );
}

Examples

Basic Select

â–¼
<AsciiSelect>
  <option>Choose an option</option>
  <option value="1">Option 1</option>
  <option value="2">Option 2</option>
</AsciiSelect>

Controlled

â–¼
const [value, setValue] = useState('option2');

<AsciiSelect 
  value={value}
  onChange={(e) => setValue(e.target.value)}
>
  <option value="option1">Option 1</option>
  <option value="option2">Option 2</option>
  <option value="option3">Option 3</option>
</AsciiSelect>

Disabled

â–¼
<AsciiSelect disabled>
  <option>Disabled Select</option>
  <option>Cannot be selected</option>
</AsciiSelect>

API Reference

Props

PropTypeDefaultDescription
childrenReact.ReactNode-Option elements to display in the dropdown
valuestring-Current selected value
onChange(event) => void-Callback fired when selection changes
disabledbooleanfalseWhether the select is disabled
classNamestring""Additional CSS classes

AsciiSelect extends all HTML select attributes and React.SelectHTMLAttributes.