Select
A trigger and listbox for choosing one option.
- Chromium
- Firefox
- WebKit
- WCAG 2.2 AA
Preview
import {
Select,
SelectContent,
SelectGroup,
SelectItem,
SelectLabel,
SelectTrigger,
SelectValue,
} from "@moe-ui/registry/components/ui/select";
import { View } from "react-native";
export default function SelectPreview() {
return (
<View className="w-[180px]">
<Select>
<SelectTrigger accessibilityLabel="Fruit">
<SelectValue placeholder="Select a fruit" />
</SelectTrigger>
<SelectContent>
<SelectGroup>
<SelectLabel>Fruits</SelectLabel>
<SelectItem value="apple" label="Apple">
Apple
</SelectItem>
<SelectItem value="banana" label="Banana">
Banana
</SelectItem>
<SelectItem value="blueberry" label="Blueberry">
Blueberry
</SelectItem>
<SelectItem value="grapes" label="Grapes">
Grapes
</SelectItem>
<SelectItem value="pineapple" label="Pineapple">
Pineapple
</SelectItem>
</SelectGroup>
</SelectContent>
</Select>
</View>
);
}
One command, your source
Installation
pnpm dlx @moe-ui/cli@beta add selectUsage
The CLI installs editable source into your application. Import the component from your configured UI directory:
import { Select } from "@/components/ui/select";Variants and composition
Compound parts and variants remain regular source in your project, so you can change them without wrapping a package API.
Public API
The canonical source panel below lists every public export, dependency, and the complete implementation shipped by the registry.
Keyboard and accessibility
Associate the control with a visible label. Keyboard focus, disabled state, and validation semantics are covered by the web test matrix.
Browser support
This beta is release-tested in Chromium, Firefox, and WebKit in light and dark themes. See the web compatibility matrix for the current gate.
Nothing hiddenCanonical source and public exports12 exports
NativeSelectScrollViewSelectSelectContentSelectGroupSelectItemSelectLabelSelectScrollDownButtonSelectScrollUpButtonSelectSeparatorSelectTriggerSelectValuetype Option"use client";
import { Icon } from "./icon";
import { NativeOnlyAnimatedView } from "./native-only-animated-view";
import { TextClassContext } from "./text";
import { cn } from "../../lib/utils";
import * as SelectPrimitive from "@rn-primitives/select";
import {
Check,
ChevronDown,
ChevronDownIcon,
ChevronUpIcon,
} from "lucide-react-native";
import * as React from "react";
import { Platform, ScrollView, StyleSheet, View } from "react-native";
import { FadeIn, FadeOut } from "react-native-reanimated";
import { FullWindowOverlay as RNFullWindowOverlay } from "react-native-screens";
type Option = SelectPrimitive.Option;
const Select = SelectPrimitive.Root;
const SelectGroup = SelectPrimitive.Group;
function SelectValue({
ref,
className,
...props
}: SelectPrimitive.ValueProps &
React.RefAttributes<SelectPrimitive.ValueRef> & {
className?: string;
}) {
const { value } = SelectPrimitive.useRootContext();
return (
<SelectPrimitive.Value
ref={ref}
className={cn(
"text-foreground line-clamp-1 flex flex-row items-center gap-2 text-sm",
!value && "text-muted-foreground",
className,
)}
{...props}
/>
);
}
function SelectTrigger({
ref,
className,
children,
size = "default",
...props
}: SelectPrimitive.TriggerProps &
React.RefAttributes<SelectPrimitive.TriggerRef> & {
children?: React.ReactNode;
size?: "default" | "sm";
}) {
return (
<SelectPrimitive.Trigger
ref={ref}
className={cn(
"border-input dark:bg-input/30 dark:active:bg-input/50 bg-background flex h-10 flex-row items-center justify-between gap-2 rounded-md border px-3 py-2 shadow-sm shadow-black/5 sm:h-9",
Platform.select({
web: "focus-visible:border-ring focus-visible:ring-ring/50 aria-invalid:ring-destructive/20 dark:aria-invalid:ring-destructive/40 aria-invalid:border-destructive dark:hover:bg-input/50 w-fit whitespace-nowrap text-sm outline-none transition-[color,box-shadow] focus-visible:ring-[3px] disabled:cursor-not-allowed [&_svg]:pointer-events-none [&_svg]:shrink-0",
}),
props.disabled && "opacity-50",
size === "sm" && "h-8 py-2 sm:py-1.5",
className,
)}
{...props}
aria-autocomplete={undefined}
>
<>{children}</>
<Icon
as={ChevronDown}
aria-hidden={true}
className="text-muted-foreground size-4"
/>
</SelectPrimitive.Trigger>
);
}
const FullWindowOverlay =
Platform.OS === "ios" ? RNFullWindowOverlay : React.Fragment;
function SelectContent({
className,
children,
position = "popper",
portalHost,
...props
}: SelectPrimitive.ContentProps &
React.RefAttributes<SelectPrimitive.ContentRef> & {
className?: string;
portalHost?: string;
}) {
return (
<SelectPrimitive.Portal hostName={portalHost}>
<FullWindowOverlay>
<SelectPrimitive.Overlay
style={Platform.select({ native: StyleSheet.absoluteFill })}
>
<TextClassContext.Provider value="text-popover-foreground">
<NativeOnlyAnimatedView
className="z-50"
entering={FadeIn}
exiting={FadeOut}
>
<SelectPrimitive.Content
className={cn(
"bg-popover border-border relative z-50 min-w-[8rem] rounded-md border shadow-md shadow-black/5",
Platform.select({
web: cn(
"animate-in fade-in-0 zoom-in-95 origin-[var(--radix-select-content-transform-origin)] max-h-52 overflow-y-auto overflow-x-hidden",
props.side === "bottom" && "slide-in-from-top-2",
props.side === "top" && "slide-in-from-bottom-2",
),
native: "p-1",
}),
position === "popper" &&
Platform.select({
web: cn(
props.side === "bottom" && "translate-y-1",
props.side === "top" && "-translate-y-1",
),
}),
className,
)}
position={position}
{...props}
>
<SelectScrollUpButton />
<SelectPrimitive.Viewport
className={cn(
"p-1",
position === "popper" &&
cn(
"w-full",
Platform.select({
web: "h-[var(--radix-select-trigger-height)] min-w-[var(--radix-select-trigger-width)]",
}),
),
)}
>
{children}
</SelectPrimitive.Viewport>
<SelectScrollDownButton />
</SelectPrimitive.Content>
</NativeOnlyAnimatedView>
</TextClassContext.Provider>
</SelectPrimitive.Overlay>
</FullWindowOverlay>
</SelectPrimitive.Portal>
);
}
function SelectLabel({
className,
...props
}: SelectPrimitive.LabelProps & React.RefAttributes<SelectPrimitive.LabelRef>) {
return (
<SelectPrimitive.Label
className={cn(
"text-muted-foreground px-2 py-2 text-xs sm:py-1.5",
className,
)}
{...props}
/>
);
}
function SelectItem({
className,
...props
}: SelectPrimitive.ItemProps & React.RefAttributes<SelectPrimitive.ItemRef>) {
return (
<SelectPrimitive.Item
className={cn(
"active:bg-accent group relative flex w-full flex-row items-center gap-2 rounded-sm py-2 pl-2 pr-8 sm:py-1.5",
Platform.select({
web: "focus:bg-accent focus:text-accent-foreground *:[span]:last:flex *:[span]:last:items-center *:[span]:last:gap-2 cursor-default outline-none data-[disabled]:pointer-events-none [&_svg]:pointer-events-none",
}),
props.disabled && "opacity-50",
className,
)}
{...props}
>
<View className="absolute right-2 flex size-3.5 items-center justify-center">
<SelectPrimitive.ItemIndicator>
<Icon as={Check} className="text-muted-foreground size-4 shrink-0" />
</SelectPrimitive.ItemIndicator>
</View>
<SelectPrimitive.ItemText className="text-foreground group-active:text-accent-foreground select-none text-sm" />
</SelectPrimitive.Item>
);
}
function SelectSeparator({
className,
...props
}: SelectPrimitive.SeparatorProps &
React.RefAttributes<SelectPrimitive.SeparatorRef>) {
return (
<SelectPrimitive.Separator
className={cn(
"bg-border -mx-1 my-1 h-px",
Platform.select({ web: "pointer-events-none" }),
className,
)}
{...props}
/>
);
}
/**
* @platform Web only
* Returns null on native platforms
*/
function SelectScrollUpButton({
className,
...props
}: React.ComponentProps<typeof SelectPrimitive.ScrollUpButton>) {
if (Platform.OS !== "web") {
return null;
}
return (
<SelectPrimitive.ScrollUpButton
className={cn(
"flex cursor-default items-center justify-center py-1",
className,
)}
{...props}
>
<Icon as={ChevronUpIcon} className="size-4" />
</SelectPrimitive.ScrollUpButton>
);
}
/**
* @platform Web only
* Returns null on native platforms
*/
function SelectScrollDownButton({
className,
...props
}: React.ComponentProps<typeof SelectPrimitive.ScrollDownButton>) {
if (Platform.OS !== "web") {
return null;
}
return (
<SelectPrimitive.ScrollDownButton
className={cn(
"flex cursor-default items-center justify-center py-1",
className,
)}
{...props}
>
<Icon as={ChevronDownIcon} className="size-4" />
</SelectPrimitive.ScrollDownButton>
);
}
/**
* @platform Native only
* Returns the children on the web
*/
function NativeSelectScrollView({
className,
...props
}: React.ComponentProps<typeof ScrollView>) {
if (Platform.OS === "web") {
return <>{props.children}</>;
}
return <ScrollView className={cn("max-h-52", className)} {...props} />;
}
export {
NativeSelectScrollView,
Select,
SelectContent,
SelectGroup,
SelectItem,
SelectLabel,
SelectScrollDownButton,
SelectScrollUpButton,
SelectSeparator,
SelectTrigger,
SelectValue,
type Option,
};