コンテンツへスキップ
1.6k

ネイティブ選択

フォーム、フィルター、国選択機能向けに再設計されたネイティブのHTMLセレクト要素――ネオブルータリズム風の枠線と影を備えた、OSによってレンダリングされるドロップダウンです。

import {
  NativeSelect,
  NativeSelectOption,

Native Select は、ブラウザ本体の <select> 要素 に薄いスタイル層を載せたものです。プリミティブもポータルも JavaScript もありません。閉じたコントロールはネオブルータリストのレシピ（太い枠線、硬い影、太字のタイポグラフィ）を受け、開いた一覧は OS のピッカーのままです。

次のような場面で使います：

  • 国・タイムゾーン・通貨ピッカー — 長い選択肢は、カスタムポップオーバーより OS の方が速く描画します。
  • モバイル中心のフォーム — iOS／Android はネイティブのピッカーホイールに差し替え、小さな画面ではカスタムドロップダウンより優れます。
  • プレーンなフォーム POST — 本物の <select name="…"> なので、値はフォームと一緒に送信され、ハイドレーション前でも動きます。

インストール

pnpm dlx shadcn@latest add https://neobrutalism.com/r/base/native-select.json
npx shadcn@latest add https://neobrutalism.com/r/base/native-select.json
yarn dlx shadcn@latest add https://neobrutalism.com/r/base/native-select.json
bunx --bun shadcn@latest add https://neobrutalism.com/r/base/native-select.json

以下のコードをコピーして、プロジェクトに貼り付けます。

components/ui/native-select.tsx
import * as React from "react"
import { ChevronDownIcon } from "lucide-react"

import { cn } from "@/lib/utils"

type NativeSelectProps = Omit<React.ComponentProps<"select">, "size"> & {
  size?: "sm" | "default"
}

function NativeSelect({
  className,
  size = "default",
  ...props
}: NativeSelectProps) {
  return (
    <div
      className={cn(
        "group/native-select relative w-fit has-[select:disabled]:opacity-50",
        className
      )}
      data-slot="native-select-wrapper"
      data-size={size}
    >
      <select
        data-slot="native-select"
        data-size={size}
        className="h-8 w-full min-w-0 appearance-none rounded border-2 bg-input py-2 pr-8 pl-3 text-sm shadow-sm transition-colors outline-none select-none selection:bg-primary selection:text-primary-foreground placeholder:text-muted-foreground focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-primary disabled:pointer-events-none disabled:cursor-not-allowed aria-invalid:border-destructive data-[size=sm]:h-7 data-[size=sm]:rounded data-[size=sm]:py-0.5"
        {...props}
      />
      <ChevronDownIcon
        className="pointer-events-none absolute top-1/2 right-2.5 size-4 -translate-y-1/2 text-muted-foreground select-none"
        aria-hidden="true"
        data-slot="native-select-icon"
      />
    </div>
  )
}

function NativeSelectOption({
  className,
  ...props
}: React.ComponentProps<"option">) {
  return (
    <option
      data-slot="native-select-option"
      className={cn("bg-[Canvas] text-[CanvasText]", className)}
      {...props}
    />
  )
}

function NativeSelectOptGroup({
  className,
  ...props
}: React.ComponentProps<"optgroup">) {
  return (
    <optgroup
      data-slot="native-select-optgroup"
      className={cn("bg-[Canvas] text-[CanvasText]", className)}
      {...props}
    />
  )
}

export { NativeSelect, NativeSelectOptGroup, NativeSelectOption }

インポートのパスをプロジェクトの構成に合わせて更新します。

使い方

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>

コンポジション

シンプル

NativeSelectOptGroup を使わず、NativeSelect の直下にオプションを配置します。

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

グループ付き

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

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

使用例

グループ

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

import {
  NativeSelect,
  NativeSelectOptGroup,

無効

NativeSelect コンポーネントに disabled プロパティを追加すると、select を無効化できます。

import {
  NativeSelect,
  NativeSelectOption,

不正な値

aria-invalid を使ってバリデーションエラーを表示し、スタイル付けには Field コンポーネントに data-invalid 属性を指定します。

import {
  NativeSelect,
  NativeSelectOption,

Native Select vs Select

  • ネイティブなブラウザ動作、より高いパフォーマンス、モバイル最適化されたドロップダウンには NativeSelect をご利用ください。
  • カスタムスタイル、アニメーション、複雑なインタラクションには Select をご利用ください。

RTL

Neobrutalism で RTL を有効にする方法は、RTL 設定ガイドをご覧ください。

"use client"

import * as React from "react"

アクセシビリティ

これはプラットフォーム本体の <select> で、ブラウザが既に支援技術へ公開しています。WAI-ARIA の select-only combobox パターン が模倣しようとしているコントロールそのものです。ARIA の配線は不要で、<Label htmlFor> または aria-label でアクセシブルネームを付けてください。

キーボード挙動はブラウザが提供するため、OS とブラウザで少し差があります。共通セットは次のとおりです：

キー操作
Space / Alt + ArrowDownオプション一覧を開く
ArrowDown / ArrowUp次／前のオプションをハイライト
Home / End最初／最後のオプションへジャンプ
Enterハイライト中のオプションを確定して一覧を閉じる
Escape値を変えずに一覧を閉じる
印字可能文字typeahead — 入力に一致する次のオプションへジャンプ

APIリファレンス

NativeSelect

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

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

NativeSelectOption

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

PropTypeDefault
valuestring
disabledbooleanfalse

NativeSelectOptGroup

関連するオプションをまとめて、より整理された構成にします。

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