Sabil UI

Search documentation

Search for a command to run...

Components

Select

Displays a list of options for the user to pick from, triggered by a button.

Installation#

  1. Install the dependencies

    npm install cn radix-ui lucide-react
  2. Copy the source into your project

    components/ui/select.tsx
    "use client"import * as React from "react"import { cn } from "cn"import { Select as SelectPrimitive } from "radix-ui"import { ChevronDownIcon, CheckIcon, ChevronUpIcon } from "lucide-react"function Select({  ...props}: React.ComponentProps<typeof SelectPrimitive.Root>) {  return <SelectPrimitive.Root data-slot="select" {...props} />}function SelectGroup({  className,  ...props}: React.ComponentProps<typeof SelectPrimitive.Group>) {  return (    <SelectPrimitive.Group      data-slot="select-group"      className={cn("scroll-my-1 p-1", className)}      {...props}    />  )}function SelectValue({  ...props}: React.ComponentProps<typeof SelectPrimitive.Value>) {  return <SelectPrimitive.Value data-slot="select-value" {...props} />}function SelectTrigger({  className,  size = "default",  children,  ...props}: React.ComponentProps<typeof SelectPrimitive.Trigger> & {  size?: "sm" | "default"}) {  return (    <SelectPrimitive.Trigger      data-slot="select-trigger"      data-size={size}      className={cn(        "flex w-fit items-center justify-between gap-1.5 rounded-lg border border-input bg-background py-2 pr-2.5 pl-3 shadow-xs text-sm whitespace-nowrap transition-colors outline-none select-none focus-visible:border-ring focus-visible:ring-3 focus-visible:ring-ring/50 disabled:cursor-not-allowed disabled:opacity-50 aria-invalid:border-destructive aria-invalid:ring-3 aria-invalid:ring-destructive/20 data-placeholder:text-muted-foreground data-[size=default]:h-10 data-[size=sm]:h-8 data-[size=sm]:rounded-[min(var(--radius-md),10px)] *:data-[slot=select-value]:line-clamp-1 *:data-[slot=select-value]:flex *:data-[slot=select-value]:items-center *:data-[slot=select-value]:gap-1.5 dark:bg-input/30 dark:hover:bg-input/50 dark:aria-invalid:border-destructive/50 dark:aria-invalid:ring-destructive/40 [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4",        className      )}      {...props}    >      {children}      <SelectPrimitive.Icon asChild>        <ChevronDownIcon className="pointer-events-none size-4 text-muted-foreground" />      </SelectPrimitive.Icon>    </SelectPrimitive.Trigger>  )}function SelectContent({  className,  children,  position = "item-aligned",  align = "center",  ...props}: React.ComponentProps<typeof SelectPrimitive.Content>) {  return (    <SelectPrimitive.Portal>      <SelectPrimitive.Content        data-slot="select-content"        data-align-trigger={position === "item-aligned"}        className={cn("relative z-50 max-h-(--radix-select-content-available-height) min-w-36 origin-(--radix-select-content-transform-origin) overflow-x-hidden overflow-y-auto rounded-xl bg-popover text-popover-foreground shadow-lg shadow-black/[0.06] ring-1 ring-overlay-border duration-100 data-[align-trigger=true]:animate-none data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2 data-open:animate-in data-open:fade-in-0 data-open:zoom-in-95 data-closed:animate-out data-closed:fade-out-0 data-closed:zoom-out-95", position ==="popper"&&"data-[side=bottom]:translate-y-1 data-[side=left]:-translate-x-1 data-[side=right]:translate-x-1 data-[side=top]:-translate-y-1", className )}        position={position}        align={align}        {...props}      >        <SelectScrollUpButton />        <SelectPrimitive.Viewport          data-position={position}          className={cn(            "data-[position=popper]:h-(--radix-select-trigger-height) data-[position=popper]:w-full data-[position=popper]:min-w-(--radix-select-trigger-width)",            position === "popper" && ""          )}        >          {children}        </SelectPrimitive.Viewport>        <SelectScrollDownButton />      </SelectPrimitive.Content>    </SelectPrimitive.Portal>  )}function SelectLabel({  className,  ...props}: React.ComponentProps<typeof SelectPrimitive.Label>) {  return (    <SelectPrimitive.Label      data-slot="select-label"      className={cn("px-1.5 py-1 text-xs text-muted-foreground", className)}      {...props}    />  )}function SelectItem({  className,  children,  ...props}: React.ComponentProps<typeof SelectPrimitive.Item>) {  return (    <SelectPrimitive.Item      data-slot="select-item"      className={cn(        "relative flex w-full cursor-default items-center gap-1.5 rounded-lg py-1 pr-8 pl-1.5 text-sm outline-hidden select-none focus:bg-accent focus:text-accent-foreground not-data-[variant=destructive]:focus:**:text-accent-foreground data-disabled:pointer-events-none data-disabled:opacity-50 [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4 *:[span]:last:flex *:[span]:last:items-center *:[span]:last:gap-2",        className      )}      {...props}    >      <span className="pointer-events-none absolute right-2 flex size-4 items-center justify-center">        <SelectPrimitive.ItemIndicator>          <CheckIcon className="pointer-events-none" />        </SelectPrimitive.ItemIndicator>      </span>      <SelectPrimitive.ItemText>{children}</SelectPrimitive.ItemText>    </SelectPrimitive.Item>  )}function SelectSeparator({  className,  ...props}: React.ComponentProps<typeof SelectPrimitive.Separator>) {  return (    <SelectPrimitive.Separator      data-slot="select-separator"      className={cn("pointer-events-none -mx-1 my-1 h-px bg-border", className)}      {...props}    />  )}function SelectScrollUpButton({  className,  ...props}: React.ComponentProps<typeof SelectPrimitive.ScrollUpButton>) {  return (    <SelectPrimitive.ScrollUpButton      data-slot="select-scroll-up-button"      className={cn(        "z-10 flex cursor-default items-center justify-center bg-popover py-1 [&_svg:not([class*='size-'])]:size-4",        className      )}      {...props}    >      <ChevronUpIcon      />    </SelectPrimitive.ScrollUpButton>  )}function SelectScrollDownButton({  className,  ...props}: React.ComponentProps<typeof SelectPrimitive.ScrollDownButton>) {  return (    <SelectPrimitive.ScrollDownButton      data-slot="select-scroll-down-button"      className={cn(        "z-10 flex cursor-default items-center justify-center bg-popover py-1 [&_svg:not([class*='size-'])]:size-4",        className      )}      {...props}    >      <ChevronDownIcon      />    </SelectPrimitive.ScrollDownButton>  )}export {  Select,  SelectContent,  SelectGroup,  SelectItem,  SelectLabel,  SelectScrollDownButton,  SelectScrollUpButton,  SelectSeparator,  SelectTrigger,  SelectValue,}
    
  3. Make sure the foundation is in place

    Components read their colors, radius and surfaces from the tokens in app/globals.css. See Theming.

Usage#

import {  Select,  SelectContent,  SelectGroup,  SelectItem,  SelectLabel,  SelectScrollDownButton,  SelectScrollUpButton,  SelectSeparator,  SelectTrigger,  SelectValue,} from "@/components/ui/select"

Examples#

Align Item

Toggle to align the item with the trigger.

Disabled

Groups

Invalid

Scrollable