export const title = "Select components"
export const description = "Free and open-source React select components built for modern applications and websites. These select components are built using React Aria and styled with Tailwind CSS."
export const links = {
    github: "https://github.com/untitleduico/react/tree/main/components/base/select",
    rac: "https://react-spectrum.adobe.com/react-aria/Select.html"
}

import * as Demos from "@/components/base/select/select.demo.tsx";

<PreviewAndCode title="Select example">
    <ResizablePreview id="preview" className="flex py-32 px-4 md:px-8 min-h-[320px] items-center justify-center gap-3 rounded-[20px] ring-1 ring-inset ring-secondary bg-primary">
        <div className="w-full max-w-xs">
            <Demos.DefaultDemo />
        </div>
    </ResizablePreview>
    <TabPanel id="code" className="min-h-(--preview-height)">
        <ComponentCode className="max-h-[600px]" component="select/DefaultDemo" />
    </TabPanel>
</PreviewAndCode>

<Divider />

## Installation

You can add this select component using our CLI or manually:

<Tabs className="w-full mt-8">
    <TabList type="underline" items={[{ id:'cli', label:'CLI' }, { id:'manual', label:'Manual' }]} />

    <TabPanel id="cli" className="mt-8">
        ```bash
        npx untitledui@latest add select
        ```
    </TabPanel>

    <TabPanel id="manual">
        <Steps>
            <Step title="Copy component files">
                Copy the files below into your project:

                <ComponentCodeTabs component="base/select" />
            </Step>
            <Step title="Start using the components">
                Great! Now you can start using the select components in your project by just copy/pasting our examples below.
            </Step>
        </Steps>
    </TabPanel>
</Tabs>

<Divider />

## Select examples

Below are examples and variations of this select component:

### Default {{ tocOnly:true }}

<PreviewAndCode title="Default">
    <ResizablePreview id="preview" className="flex py-32 px-4 md:px-8 min-h-[320px] items-center justify-center rounded-[20px] ring-1 ring-inset ring-secondary bg-primary">
        <div className="w-full max-w-xs">
            <Demos.DefaultDemo />
        </div>
    </ResizablePreview>
    <TabPanel id="code" className="min-h-(--preview-height)">
        <ComponentCode className="max-h-[600px]" component="select/DefaultDemo" />
    </TabPanel>
</PreviewAndCode>

### Disabled {{ tocOnly:true }}

<PreviewAndCode title="Disabled">
    <ResizablePreview id="preview" className="flex py-32 px-4 md:px-8 min-h-[320px] items-center justify-center gap-3 rounded-[20px] ring-1 ring-inset ring-secondary bg-primary">
        <div className="w-full max-w-xs">
            <Demos.DisabledDemo />
        </div>
    </ResizablePreview>
    <TabPanel id="code" className="min-h-(--preview-height)">
        <ComponentCode className="max-h-[600px]" component="select/DisabledDemo" />
    </TabPanel>
</PreviewAndCode>

### Sizes {{ tocOnly:true }}

<PreviewAndCode title="Sizes">
    <ResizablePreview id="preview" className="flex py-32 px-4 md:px-8 min-h-[320px] items-center justify-center gap-3 rounded-[20px] ring-1 ring-inset ring-secondary bg-primary">
        <div className="w-full max-w-xs">
            <Demos.SizesDemo />
        </div>
    </ResizablePreview>
    <TabPanel id="code" className="min-h-(--preview-height)">
        <ComponentCode className="max-h-[600px]" component="select/SizesDemo" />
    </TabPanel>
</PreviewAndCode>

### Icon leading {{ tocOnly:true }}

<PreviewAndCode title="Icon leading">
    <ResizablePreview id="preview" className="flex py-32 px-4 md:px-8 min-h-[320px] items-center justify-center gap-3 rounded-[20px] ring-1 ring-inset ring-secondary bg-primary">
        <div className="w-full max-w-xs">
            <Demos.IconLeadingDemo />
        </div>
    </ResizablePreview>
    <TabPanel id="code" className="min-h-(--preview-height)">
        <ComponentCode className="max-h-[600px]" component="select/IconLeadingDemo" />
    </TabPanel>
</PreviewAndCode>

### Avatar leading {{ tocOnly:true }}

<PreviewAndCode title="Avatar leading">
    <ResizablePreview id="preview" className="flex py-32 px-4 md:px-8 min-h-[320px] items-center justify-center gap-3 rounded-[20px] ring-1 ring-inset ring-secondary bg-primary">
        <div className="w-full max-w-xs">
            <Demos.AvatarLeadingDemo />
        </div>
    </ResizablePreview>
    <TabPanel id="code" className="min-h-(--preview-height)">
        <ComponentCode className="max-h-[600px]" component="select/AvatarLeadingDemo" />
    </TabPanel>
</PreviewAndCode>

### Dot leading {{ tocOnly:true }}

<PreviewAndCode title="Dot leading">
    <ResizablePreview id="preview" className="flex py-32 px-4 md:px-8 min-h-[320px] items-center justify-center gap-3 rounded-[20px] ring-1 ring-inset ring-secondary bg-primary">
        <div className="w-full max-w-xs">
            <Demos.DotLeadingDemo />
        </div>
    </ResizablePreview>
    <TabPanel id="code" className="min-h-(--preview-height)">
        <ComponentCode className="max-h-[600px]" component="select/DotLeadingDemo" />
    </TabPanel>
</PreviewAndCode>

### Search {{ tocOnly:true }}

<PreviewAndCode title="Search">
    <ResizablePreview id="preview" className="flex py-32 px-4 md:px-8 min-h-[320px] items-center justify-center gap-3 rounded-[20px] ring-1 ring-inset ring-secondary bg-primary">
        <div className="w-full max-w-xs">
            <Demos.SearchDemo />
        </div>
    </ResizablePreview>
    <TabPanel id="code" className="min-h-(--preview-height)">
        <ComponentCode className="max-h-[600px]" component="select/SearchDemo" />
    </TabPanel>
</PreviewAndCode>

### Tags {{ tocOnly:true }}

<PreviewAndCode title="Tags">
    <ResizablePreview id="preview" className="flex py-32 px-4 md:px-8 min-h-[320px] items-center justify-center gap-3 rounded-[20px] ring-1 ring-inset ring-secondary bg-primary">
        <div className="w-full max-w-[400px]">
            <Demos.TagsDemo />
        </div>
    </ResizablePreview>
    <TabPanel id="code" className="min-h-(--preview-height)">
        <ComponentCode className="max-h-[600px]" component="select/TagsDemo" />
    </TabPanel>
</PreviewAndCode>

<Divider />

<FAQ
    faqs={[
        {
            question: "What sizes are available for the select?",
            answer: "The select supports three sizes: `\"sm\"`, `\"md\"`, and `\"lg\"`. The default size is `\"sm\"`.",
        },
        {
            question: "How do I disable the select?",
            answer: "You can disable the select by setting the `isDisabled` prop to `true`.",
        },
        {
            question: "Can I add a search to the select?",
            answer: "Yes. Use the `Select.ComboBox` compound component instead of `Select` to enable search/filtering of options.",
        },
        {
            question: "How do I add icons or avatars to select items?",
            answer: "Pass `icon` for a leading icon or `avatarUrl` for a leading avatar on `Select.Item`. You can also pass `icon` on the `Select` component itself to show an icon in the trigger.",
        },
        {
            question: "Is the select accessible?",
            answer: "Yes. The select is built on React Aria Components, which provides full keyboard navigation, screen reader support, and ARIA attributes out of the box.",
        },
    ]}
/>