Native Select

一貫したデザインシステム統合を備えた、スタイル付きのネイティブ HTML 選択要素です。

スタイル付きのセレクトコンポーネントについては、Select を参照してください。

import {
  NativeSelect,
  NativeSelectOption,

インストール


pnpm dlx shadcn@latest add native-select

使い方

import {
  NativeSelect,
  NativeSelectOptGroup,
  NativeSelectOption,
} from "@/components/ui/native-select"

<NativeSelect>
  <NativeSelectOption value="">Select a fruit</NativeSelectOption>
  <NativeSelectOption value="apple">Apple</NativeSelectOption>
  <NativeSelectOption value="banana">Banana</NativeSelectOption>
  <NativeSelectOption value="blueberry">Blueberry</NativeSelectOption>
  <NativeSelectOption value="pineapple">Pineapple</NativeSelectOption>
</NativeSelect>

構成

シンプル

NativeSelect の直下に配置されるオプション (NativeSelectOptGroup はありません)。

NativeSelect
├── NativeSelectOption
├── NativeSelectOption
├── NativeSelectOption
└── NativeSelectOption

グループ付き

NativeSelectOptGroup を使用して、オプションをカテゴリーに整理します。

NativeSelect
├── NativeSelectOptGroup
│   ├── NativeSelectOption
│   └── NativeSelectOption
└── NativeSelectOptGroup
    ├── NativeSelectOption
    └── NativeSelectOption

グループ

NativeSelectOptGroup を使用して、オプションをカテゴリーに整理します。

import {
  NativeSelect,
  NativeSelectOptGroup,

無効

disabled プロパティを NativeSelect コンポーネントに追加して、選択を無効にします。

import {
  NativeSelect,
  NativeSelectOption,

無効な状態

検証エラーの表示には aria-invalid を、スタイリング用に Field コンポーネントへの data-invalid 属性を使用します。

import {
  NativeSelect,
  NativeSelectOption,

NativeSelect と Select の違い

ネイティブブラウザーの動作、優れたパフォーマンス、モバイルに最適化されたドロップダウンが必要な場合は NativeSelect を使用してください。
カスタムスタイル、アニメーション、複雑な操作が必要な場合は Select を使用してください。

RTL

shadcn/ui で RTL サポートを有効にするには、RTL 構成ガイドを参照してください。

"use client"

import * as React from "react"

API リファレンス

NativeSelect

ネイティブ HTML の選択要素をラップするメインの選択コンポーネント。

<NativeSelect>
  <NativeSelectOption value="option1">Option 1</NativeSelectOption>
  <NativeSelectOption value="option2">Option 2</NativeSelectOption>
</NativeSelect>

NativeSelectOption

選択内の個々のオプションを表します。

Prop	Type	Default
`value`	`string`
`disabled`	`boolean`	`false`

NativeSelectOptGroup

関連するオプションをグループ化し、整理しやすくします。

Prop	Type	Default
`label`	`string`
`disabled`	`boolean`	`false`

<NativeSelectOptGroup label="Fruits">
  <NativeSelectOption value="apple">Apple</NativeSelectOption>
  <NativeSelectOption value="banana">Banana</NativeSelectOption>
</NativeSelectOptGroup>

Message Scroller Pagination

On This Page

インストール使い方構成シンプルグループ付きグループ無効無効な状態 NativeSelect と Select の違い RTL API リファレンス NativeSelect NativeSelectOption NativeSelectOptGroup

shadcn/uiアプリをVercelにデプロイ

OpenAI、Sonos、Adobeなどに採用されています。

Vercelは、アプリや機能を大規模にデプロイするためのツールとインフラを提供します。