Dropdown Menu
Agrupar acciones secundarias. Ahorrar espacio. Mantener UI limpia.
Instalación
Copia y pega el siguiente código en tu proyecto.
1'use client';23import { AnimatePresence, motion, useReducedMotion } from 'motion/react';4import * as React from 'react';5import { cn } from '../lib/cn';6import { useTypeahead } from '../lib/collection';7import { FloatingPortal, useFloating } from '../lib/floating';8import { floatingVariants, reveal, springs, tap } from '../lib/motion';9import { useLayer } from '../lib/overlay';10import { useControllableState } from '../lib/use-controllable-state';1112type IconProps = React.SVGProps<SVGSVGElement> & {13 size?: number | string;14};1516function ChevronDownIcon({ size = 24, strokeWidth = 1.5, ...props }: IconProps) {17 return (18 <svg19 xmlns="http://www.w3.org/2000/svg"20 width={size}21 height={size}22 viewBox="0 0 24 24"23 fill="none"24 stroke="currentColor"25 strokeWidth={strokeWidth}26 strokeLinecap="round"27 strokeLinejoin="round"28 aria-hidden="true"29 {...props}30 >31 <path d="m6 9 6 6 6-6" />32 </svg>33 );34}3536function CheckIcon({ size = 24, strokeWidth = 1.5, ...props }: IconProps) {37 return (38 <svg39 xmlns="http://www.w3.org/2000/svg"40 width={size}41 height={size}42 viewBox="0 0 24 24"43 fill="none"44 stroke="currentColor"45 strokeWidth={strokeWidth}46 strokeLinecap="round"47 strokeLinejoin="round"48 aria-hidden="true"49 {...props}50 >51 <path d="M20 6 9 17l-5-5" />52 </svg>53 );54}5556function DotIcon({ size = 24, ...props }: IconProps) {57 return (58 <svg59 xmlns="http://www.w3.org/2000/svg"60 width={size}61 height={size}62 viewBox="0 0 24 24"63 fill="currentColor"64 aria-hidden="true"65 {...props}66 >67 <circle cx="12" cy="12" r="4" />68 </svg>69 );70}7172type FocusEdge = 'first' | 'last';7374interface DropdownContextValue {75 isOpen: boolean;76 toggleMenu: () => void;77 closeMenu: (options?: { restoreFocus?: boolean }) => void;78 openMenu: (focus?: FocusEdge) => void;79 initialFocusRef: React.RefObject<FocusEdge>;80 triggerRef: React.RefObject<HTMLButtonElement | null>;81 contentRef: React.RefObject<HTMLDivElement | null>;82 triggerId: string;83 contentId: string;84}8586interface DropdownMenuProps {87 children: React.ReactNode;88 className?: string;89 defaultOpen?: boolean;90 open?: boolean;91 onOpenChange?: (open: boolean) => void;92}9394interface DropdownMenuTriggerProps {95 children: React.ReactNode;96 onClick?: (event: React.MouseEvent<HTMLButtonElement>) => void;97 className?: string;98 asChild?: boolean;99}100101interface DropdownMenuContentProps {102 children: React.ReactNode;103 className?: string;104 align?: 'start' | 'center' | 'end';105 sideOffset?: number;106}107108type DropdownMenuItemRole = 'menuitem' | 'menuitemcheckbox' | 'menuitemradio';109110interface DropdownMenuItemProps {111 children: React.ReactNode;112 onClick?: (event: React.MouseEvent<HTMLDivElement>) => void;113 className?: string;114 disabled?: boolean;115 onSelect?: () => void;116 variant?: 'default' | 'destructive';117 asChild?: boolean;118 role?: DropdownMenuItemRole;119 checked?: boolean;120 closeOnSelect?: boolean;121}122123interface DropdownMenuCheckableItemProps extends Omit<124 DropdownMenuItemProps,125 'role' | 'checked' | 'asChild'126> {127 checked?: boolean;128 onCheckedChange?: (checked: boolean) => void;129}130131const DROPDOWN_ICON_VARIANTS = {132 open: { rotate: 180 },133 closed: { rotate: 0 },134} as const;135136const DROPDOWN_ICON_STYLE = { willChange: 'transform' } as const;137const DROPDOWN_CONTENT_STYLE = { willChange: 'opacity, transform, filter' } as const;138139const ORIGIN_CLASSES = {140 bottom: { start: 'origin-top-left', center: 'origin-top', end: 'origin-top-right' },141 top: { start: 'origin-bottom-left', center: 'origin-bottom', end: 'origin-bottom-right' },142} as const;143144const DropdownContext = React.createContext<DropdownContextValue | null>(null);145146const useDropdownContext = (): DropdownContextValue => {147 const context = React.use(DropdownContext);148 if (!context) throw new Error('Dropdown components must be used within DropdownMenu');149 return context;150};151152function useClickOutside(153 ref: React.RefObject<HTMLElement | null>,154 triggerRef: React.RefObject<HTMLElement | null>,155 handler: () => void,156 enabled: boolean,157 isInsideUpperLayer: (target: EventTarget | null) => boolean,158) {159 React.useEffect(() => {160 if (!enabled) return;161 const handlePointerDownOutside = (event: PointerEvent) => {162 if (163 ref.current?.contains(event.target as Node) ||164 triggerRef.current?.contains(event.target as Node) ||165 isInsideUpperLayer(event.target)166 ) {167 return;168 }169 handler();170 };171 document.addEventListener('pointerdown', handlePointerDownOutside);172 return () => document.removeEventListener('pointerdown', handlePointerDownOutside);173 }, [ref, triggerRef, handler, enabled, isInsideUpperLayer]);174}175176function getMenuItems(container: HTMLElement | null): HTMLElement[] {177 if (!container) return [];178 return Array.from(179 container.querySelectorAll<HTMLElement>(180 '[role="menuitem"]:not([aria-disabled="true"]), [role="menuitemcheckbox"]:not([aria-disabled="true"]), [role="menuitemradio"]:not([aria-disabled="true"])',181 ),182 );183}184185function focusEdge(container: HTMLElement | null, edge: FocusEdge) {186 const items = getMenuItems(container);187 (edge === 'last' ? items[items.length - 1] : items[0])?.focus();188}189190const DropdownMenuRoot = ({191 children,192 className,193 defaultOpen = false,194 open: controlledOpen,195 onOpenChange,196}: DropdownMenuProps): React.JSX.Element => {197 const [isOpen, setOpen] = useControllableState({198 value: controlledOpen,199 defaultValue: defaultOpen,200 onChange: onOpenChange,201 });202 const triggerRef = React.useRef<HTMLButtonElement>(null);203 const contentRef = React.useRef<HTMLDivElement>(null);204 const initialFocusRef = React.useRef<FocusEdge>('first');205206 const openMenu = React.useCallback(207 (focus: FocusEdge = 'first') => {208 initialFocusRef.current = focus;209 setOpen(true);210 },211 [setOpen],212 );213214 const closeMenu = React.useCallback(215 (options?: { restoreFocus?: boolean }) => {216 setOpen(false);217 if (options?.restoreFocus !== false) {218 triggerRef.current?.focus();219 }220 },221 [setOpen],222 );223224 const toggleMenu = React.useCallback(() => {225 initialFocusRef.current = 'first';226 setOpen(!isOpen);227 }, [setOpen, isOpen]);228229 const id = React.useId();230 const triggerId = `dropdown-trigger-${id}`;231 const contentId = `dropdown-content-${id}`;232233 const contextValue = React.useMemo(234 () => ({235 isOpen,236 openMenu,237 closeMenu,238 toggleMenu,239 initialFocusRef,240 triggerRef,241 contentRef,242 triggerId,243 contentId,244 }),245 [isOpen, openMenu, closeMenu, toggleMenu, triggerId, contentId],246 );247248 return (249 <DropdownContext value={contextValue}>250 <div className={cn('relative inline-block text-start', className)}>{children}</div>251 </DropdownContext>252 );253};254255const DropdownMenuTrigger = ({256 children,257 onClick,258 className,259 asChild = false,260}: DropdownMenuTriggerProps): React.JSX.Element => {261 const { isOpen, toggleMenu, openMenu, triggerRef, contentRef, triggerId, contentId } =262 useDropdownContext();263 const shouldReduceMotion = useReducedMotion();264265 const handleClick = React.useCallback(266 (e: React.MouseEvent<HTMLButtonElement>) => {267 toggleMenu();268 onClick?.(e);269 },270 [toggleMenu, onClick],271 );272273 const handleKeyDown = React.useCallback(274 (e: React.KeyboardEvent<HTMLButtonElement>) => {275 if (e.key === 'ArrowDown' || e.key === 'ArrowUp') {276 e.preventDefault();277 const edge = e.key === 'ArrowUp' ? 'last' : 'first';278 if (isOpen) focusEdge(contentRef.current, edge);279 else openMenu(edge);280 }281 },282 [isOpen, openMenu, contentRef],283 );284285 const triggerA11yProps = {286 'aria-expanded': isOpen,287 'aria-haspopup': 'menu' as const,288 'aria-controls': isOpen ? contentId : undefined,289 id: triggerId,290 };291292 if (asChild && React.isValidElement(children)) {293 const childProps = children.props as {294 onClick?: (e: React.MouseEvent<HTMLButtonElement>) => void;295 onKeyDown?: (e: React.KeyboardEvent<HTMLButtonElement>) => void;296 };297298 return React.cloneElement(children, {299 ref: triggerRef,300 onClick: (e: React.MouseEvent<HTMLButtonElement>) => {301 childProps.onClick?.(e);302 handleClick(e);303 },304 onKeyDown: (e: React.KeyboardEvent<HTMLButtonElement>) => {305 childProps.onKeyDown?.(e);306 handleKeyDown(e);307 },308 ...triggerA11yProps,309 } as React.HTMLAttributes<HTMLElement>);310 }311312 return (313 <motion.button314 ref={triggerRef}315 type="button"316 onClick={handleClick}317 onKeyDown={handleKeyDown}318 whileTap={!shouldReduceMotion ? tap : undefined}319 transition={springs.snappy}320 className={cn(321 'inline-flex items-center justify-center gap-2 rounded-md px-4 py-2 text-sm font-medium',322 'text-foreground',323 'hover:bg-muted transition-colors',324 'ring-offset-background focus-visible:ring-ring focus-visible:ring-2 focus-visible:ring-offset-2 focus-visible:outline-none',325 className,326 )}327 {...triggerA11yProps}328 >329 {children}330 <motion.span331 aria-hidden="true"332 variants={DROPDOWN_ICON_VARIANTS}333 animate={isOpen ? 'open' : 'closed'}334 transition={springs.snappy}335 style={DROPDOWN_ICON_STYLE}336 >337 <ChevronDownIcon className="text-muted-foreground size-4" size={16} />338 </motion.span>339 </motion.button>340 );341};342343const DropdownMenuContent = ({344 children,345 className,346 align = 'start',347 sideOffset = 6,348}: DropdownMenuContentProps): React.JSX.Element | null => {349 const { isOpen, closeMenu, contentId, triggerId, triggerRef, contentRef, initialFocusRef } =350 useDropdownContext();351 const layer = useLayer(isOpen, false, contentRef);352 const typeahead = useTypeahead();353 const shouldReduceMotion = useReducedMotion();354 const { style: floatingStyle, side } = useFloating({355 open: isOpen,356 anchorRef: triggerRef,357 floatingRef: contentRef,358 side: 'bottom',359 align,360 sideOffset,361 });362 const verticalSide = side === 'top' ? 'top' : 'bottom';363364 const closeWithoutFocus = React.useCallback(365 () => closeMenu({ restoreFocus: false }),366 [closeMenu],367 );368369 useClickOutside(contentRef, triggerRef, closeWithoutFocus, isOpen, layer.isInsideUpperLayer);370371 React.useEffect(() => {372 if (!isOpen) return;373 const frame = requestAnimationFrame(() => {374 focusEdge(contentRef.current, initialFocusRef.current);375 });376 return () => cancelAnimationFrame(frame);377 }, [isOpen, contentRef, initialFocusRef]);378379 const handleKeyDown = React.useCallback(380 (e: React.KeyboardEvent<HTMLDivElement>) => {381 if (e.key === 'Escape') {382 if (!layer.isTopmost()) return;383 e.preventDefault();384 closeMenu();385 return;386 }387 if (e.key === 'Tab') {388 closeMenu();389 return;390 }391392 const items = getMenuItems(contentRef.current);393 if (items.length === 0) return;394395 const currentIndex = items.indexOf(document.activeElement as HTMLElement);396397 let nextIndex: number | null = null;398 if (e.key === 'ArrowDown') {399 nextIndex = currentIndex < 0 ? 0 : (currentIndex + 1) % items.length;400 } else if (e.key === 'ArrowUp') {401 nextIndex =402 currentIndex < 0 ? items.length - 1 : (currentIndex - 1 + items.length) % items.length;403 } else if (e.key === 'Home') {404 nextIndex = 0;405 } else if (e.key === 'End') {406 nextIndex = items.length - 1;407 } else if (408 e.key.length === 1 &&409 !e.altKey &&410 !e.ctrlKey &&411 !e.metaKey &&412 (e.key !== ' ' || typeahead.isTyping())413 ) {414 e.preventDefault();415 e.stopPropagation();416 typeahead.search(e.key, items, currentIndex)?.focus();417 return;418 }419420 if (nextIndex !== null) {421 e.preventDefault();422 items[nextIndex]?.focus();423 }424 },425 [closeMenu, contentRef, layer, typeahead],426 );427428 const style = React.useMemo(429 () => ({430 ...floatingStyle,431 ...(isOpen ? null : { visibility: undefined }),432 ...DROPDOWN_CONTENT_STYLE,433 }),434 [floatingStyle, isOpen],435 );436437 return (438 <FloatingPortal>439 <AnimatePresence>440 {isOpen && (441 <motion.div442 ref={contentRef}443 id={contentId}444 role="menu"445 tabIndex={-1}446 aria-labelledby={triggerId}447 onKeyDownCapture={handleKeyDown}448 variants={shouldReduceMotion ? reveal : floatingVariants[verticalSide]}449 initial="hidden"450 animate="visible"451 exit="exit"452 style={style}453 className={cn(454 'bg-popover text-popover-foreground z-500 max-h-(--available-height) min-w-48 overflow-y-auto overscroll-contain rounded-md shadow-md outline-none',455 ORIGIN_CLASSES[verticalSide][align],456 className,457 )}458 >459 <div className="flex flex-col gap-0.5 p-1">{children}</div>460 </motion.div>461 )}462 </AnimatePresence>463 </FloatingPortal>464 );465};466467const itemClassName = (disabled: boolean, variant: 'default' | 'destructive') =>468 cn(469 'relative flex cursor-pointer items-center gap-2 rounded-sm px-2 py-1.5 text-sm outline-none select-none',470 'transition-colors duration-150',471 'focus:bg-muted pointer-coarse:py-2.5',472 disabled && 'pointer-events-none opacity-40',473 variant === 'destructive' && 'text-destructive-text focus:text-destructive-text',474 );475476const DropdownMenuItem = ({477 children,478 onClick,479 className,480 disabled = false,481 variant = 'default',482 onSelect,483 asChild = false,484 role = 'menuitem',485 checked,486 closeOnSelect = role === 'menuitem',487}: DropdownMenuItemProps): React.JSX.Element => {488 const { closeMenu } = useDropdownContext();489 const checkable = role !== 'menuitem';490 const ariaChecked = checkable ? Boolean(checked) : undefined;491492 const handleClick = React.useCallback(493 (e: React.MouseEvent<HTMLDivElement>) => {494 if (disabled) return;495 e.stopPropagation();496 onClick?.(e);497 onSelect?.();498 if (closeOnSelect) closeMenu();499 },500 [disabled, onClick, onSelect, closeMenu, closeOnSelect],501 );502503 const handleKeyDown = React.useCallback(504 (e: React.KeyboardEvent<HTMLDivElement>) => {505 if (disabled) return;506 if (e.key !== 'Enter' && e.key !== ' ') return;507 e.stopPropagation();508 const target = e.currentTarget as HTMLElement;509 if (target instanceof HTMLAnchorElement && target.hasAttribute('href')) {510 if (e.key === ' ') {511 e.preventDefault();512 target.click();513 }514 return;515 }516 e.preventDefault();517 onClick?.(e as unknown as React.MouseEvent<HTMLDivElement>);518 onSelect?.();519 if (closeOnSelect) closeMenu();520 },521 [disabled, onClick, onSelect, closeMenu, closeOnSelect],522 );523524 const handlePointerMove = React.useCallback(525 (e: React.PointerEvent<HTMLElement>) => {526 if (disabled || e.pointerType === 'touch') return;527 if (document.activeElement !== e.currentTarget) e.currentTarget.focus();528 },529 [disabled],530 );531532 const handlePointerLeave = React.useCallback((e: React.PointerEvent<HTMLElement>) => {533 if (document.activeElement !== e.currentTarget) return;534 e.currentTarget.closest<HTMLElement>('[role="menu"]')?.focus();535 }, []);536537 if (asChild && React.isValidElement(children)) {538 const childProps = children.props as Record<string, unknown>;539 const childOnClick = childProps.onClick as540 | ((e: React.MouseEvent<HTMLDivElement>) => void)541 | undefined;542 const childOnKeyDown = childProps.onKeyDown as543 | ((e: React.KeyboardEvent<HTMLDivElement>) => void)544 | undefined;545 const childOnPointerMove = childProps.onPointerMove as546 | ((e: React.PointerEvent<HTMLElement>) => void)547 | undefined;548 const childOnPointerLeave = childProps.onPointerLeave as549 | ((e: React.PointerEvent<HTMLElement>) => void)550 | undefined;551552 return React.cloneElement(children, {553 onClick: (e: React.MouseEvent<HTMLDivElement>) => {554 childOnClick?.(e);555 handleClick(e);556 },557 onKeyDown: (e: React.KeyboardEvent<HTMLDivElement>) => {558 childOnKeyDown?.(e);559 handleKeyDown(e);560 },561 onPointerMove: (e: React.PointerEvent<HTMLElement>) => {562 childOnPointerMove?.(e);563 handlePointerMove(e);564 },565 onPointerLeave: (e: React.PointerEvent<HTMLElement>) => {566 childOnPointerLeave?.(e);567 handlePointerLeave(e);568 },569 role,570 tabIndex: -1,571 'aria-disabled': disabled || undefined,572 'aria-checked': ariaChecked,573 className: cn(574 itemClassName(disabled, variant),575 className,576 childProps.className as string | undefined,577 ),578 style: childProps.style as React.CSSProperties | undefined,579 } as React.ComponentProps<'div'>);580 }581582 return (583 <div584 role={role}585 tabIndex={-1}586 aria-disabled={disabled || undefined}587 aria-checked={ariaChecked}588 onClick={handleClick}589 onKeyDown={handleKeyDown}590 onPointerMove={handlePointerMove}591 onPointerLeave={handlePointerLeave}592 className={cn(itemClassName(disabled, variant), className)}593 >594 {children}595 </div>596 );597};598599const DropdownMenuCheckboxItem = ({600 checked = false,601 onCheckedChange,602 onSelect,603 children,604 className,605 ...props606}: DropdownMenuCheckableItemProps) => (607 <DropdownMenuItem608 {...props}609 role="menuitemcheckbox"610 checked={checked}611 className={cn('ps-8', className)}612 onSelect={() => {613 onCheckedChange?.(!checked);614 onSelect?.();615 }}616 >617 <span className="absolute start-2 flex size-4 items-center justify-center">618 {checked && <CheckIcon size={14} />}619 </span>620 {children}621 </DropdownMenuItem>622);623624const DropdownMenuRadioItem = ({625 checked = false,626 onCheckedChange,627 onSelect,628 children,629 className,630 closeOnSelect = true,631 ...props632}: DropdownMenuCheckableItemProps) => (633 <DropdownMenuItem634 {...props}635 role="menuitemradio"636 checked={checked}637 closeOnSelect={closeOnSelect}638 className={cn('ps-8', className)}639 onSelect={() => {640 if (!checked) onCheckedChange?.(true);641 onSelect?.();642 }}643 >644 <span className="absolute start-2 flex size-4 items-center justify-center">645 {checked && <DotIcon size={14} />}646 </span>647 {children}648 </DropdownMenuItem>649);650651const DropdownLabel = ({652 children,653 className,654}: {655 children: React.ReactNode;656 className?: string;657}) => {658 return (659 <div660 role="presentation"661 className={cn('text-muted-foreground px-2 py-2 text-xs font-medium', className)}662 >663 {children}664 </div>665 );666};667668const DropdownSeparator = ({ className }: { className?: string }) => {669 return (670 <div671 role="separator"672 aria-orientation="horizontal"673 className={cn('bg-border/50 my-1 h-px', className)}674 />675 );676};677678const DropdownMenu = Object.assign(DropdownMenuRoot, {679 Trigger: DropdownMenuTrigger,680 Content: DropdownMenuContent,681 Item: DropdownMenuItem,682 CheckboxItem: DropdownMenuCheckboxItem,683 RadioItem: DropdownMenuRadioItem,684 Label: DropdownLabel,685 Separator: DropdownSeparator,686});687688export { DropdownMenu };689export type {690 DropdownMenuCheckableItemProps,691 DropdownMenuContentProps,692 DropdownMenuItemProps,693 DropdownMenuProps,694 DropdownMenuTriggerProps,695};
Actualiza las rutas de importación para que coincidan con la estructura de tu proyecto.
Anatomía
1import { DropdownMenu } from '@/components/dropdown-menu';
1<DropdownMenu>2 <DropdownMenu.Trigger asChild>3 <Button variant="outline">Abrir Menú</Button>4 </DropdownMenu.Trigger>5 <DropdownMenu.Content>6 <DropdownMenu.Label>Mi Cuenta</DropdownMenu.Label>7 <DropdownMenu.Item>Perfil</DropdownMenu.Item>8 <DropdownMenu.Item>Configuración</DropdownMenu.Item>9 <DropdownMenu.Separator />10 <DropdownMenu.Item variant="destructive">Cerrar Sesión</DropdownMenu.Item>11 </DropdownMenu.Content>12</DropdownMenu>
Composición
Usa la siguiente composición para construir un
DropdownMenu:DropdownMenu├── DropdownMenu.Trigger└── DropdownMenu.Content├── DropdownMenu.Label├── DropdownMenu.Item└── DropdownMenu.Separator
Variantes
Casillas de verificación (Checkboxes)
1'use client';23import * as React from 'react';4import { Button } from '@/components/button';5import { DropdownMenu } from '@/components/dropdown-menu';67const COLUMNS = [8 { id: 'customer', label: 'Customer' },9 { id: 'status', label: 'Status' },10 { id: 'amount', label: 'Amount' },11 { id: 'method', label: 'Payment method' },12 { id: 'created', label: 'Created' },13] as const;1415const INITIAL_STATE: Record<string, boolean> = {16 customer: true,17 status: true,18 amount: true,19 method: false,20 created: false,21};2223export function Checkboxes() {24 const [visible, setVisible] = React.useState<Record<string, boolean>>(INITIAL_STATE);2526 const toggle = (id: string) => setVisible((prev) => ({ ...prev, [id]: !prev[id] }));27 const shownCount = COLUMNS.filter((column) => visible[column.id]).length;2829 return (30 <DropdownMenu>31 <DropdownMenu.Trigger asChild>32 <Button variant="outline">33 Columns ({shownCount}/{COLUMNS.length})34 </Button>35 </DropdownMenu.Trigger>36 <DropdownMenu.Content className="w-56 max-w-[calc(100vw-2rem)]" align="start">37 <DropdownMenu.Label>Show in orders table</DropdownMenu.Label>38 <DropdownMenu.Separator />39 {COLUMNS.map(({ id, label }) => (40 <DropdownMenu.CheckboxItem41 key={id}42 checked={Boolean(visible[id])}43 onCheckedChange={() => toggle(id)}44 >45 {label}46 </DropdownMenu.CheckboxItem>47 ))}48 </DropdownMenu.Content>49 </DropdownMenu>50 );51}
Grupo de radio (Radio Group)
1'use client';23import * as React from 'react';4import { Button } from '@/components/button';5import { DropdownMenu } from '@/components/dropdown-menu';67const SORT_OPTIONS = [8 { value: 'newest', label: 'Newest first' },9 { value: 'oldest', label: 'Oldest first' },10 { value: 'amount-desc', label: 'Amount, high to low' },11 { value: 'amount-asc', label: 'Amount, low to high' },12] as const;1314export function RadioGroup() {15 const [sort, setSort] = React.useState<string>('newest');16 const active = SORT_OPTIONS.find((option) => option.value === sort);1718 return (19 <DropdownMenu>20 <DropdownMenu.Trigger asChild>21 <Button variant="outline">Sort: {active?.label}</Button>22 </DropdownMenu.Trigger>23 <DropdownMenu.Content className="w-56 max-w-[calc(100vw-2rem)]" align="start">24 <DropdownMenu.Label>Sort 240 orders by</DropdownMenu.Label>25 <DropdownMenu.Separator />26 {SORT_OPTIONS.map((option) => (27 <DropdownMenu.RadioItem28 key={option.value}29 checked={sort === option.value}30 onCheckedChange={() => setSort(option.value)}31 >32 {option.label}33 </DropdownMenu.RadioItem>34 ))}35 </DropdownMenu.Content>36 </DropdownMenu>37 );38}
Referencia de API
DropdownMenu
| Prop | Tipo | Por defecto | Descripción |
|---|---|---|---|
defaultOpen | boolean | false | Estado abierto inicial |
onOpenChange | (open: boolean) => void | - | Callback cuando cambia el estado |
className | string | - | Clases CSS adicionales |
DropdownMenu.Trigger
| Prop | Tipo | Por defecto | Descripción |
|---|---|---|---|
asChild | boolean | false | Renderizar como elemento hijo |
className | string | - | Clases CSS adicionales |
DropdownMenu.Content
| Prop | Tipo | Por defecto | Descripción |
|---|---|---|---|
align | 'start' | 'center' | 'end' | 'start' | Alineación horizontal |
sideOffset | number | 6 | Distancia del activador |
className | string | - | Clases CSS adicionales |
DropdownMenu.Item
| Prop | Tipo | Por defecto | Descripción |
|---|---|---|---|
disabled | boolean | false | Deshabilitar el elemento |
variant | 'default' | 'destructive' | 'default' | Estilo visual |
onSelect | () => void | - | Callback cuando se selecciona |
closeOnSelect | boolean | true | Cierra el menú después de seleccionar |
className | string | - | Clases CSS adicionales |
DropdownMenu.CheckboxItem
Un ítem con
role="menuitemcheckbox" que muestra un check cuando está activo. Deja el menú abierto después de cambiarlo, así se pueden activar varias opciones de una vez.| Prop | Tipo | Por defecto | Descripción |
|---|---|---|---|
checked | boolean | false | Si la opción está activa |
onCheckedChange | (checked: boolean) => void | - | Se llama con el valor nuevo |
closeOnSelect | boolean | false | Cierra el menú después de cambiarlo |
disabled | boolean | false | Deshabilita el ítem |
className | string | - | Clases CSS adicionales |
DropdownMenu.RadioItem
Un ítem con
role="menuitemradio" para elegir una opción de un grupo. Renderiza uno por opción y marca la actual con checked. Por defecto cierra el menú.| Prop | Tipo | Por defecto | Descripción |
|---|---|---|---|
checked | boolean | false | Si es la opción elegida |
onCheckedChange | (checked: boolean) => void | - | Se llama con true cuando se elige la opción |
closeOnSelect | boolean | true | Cierra el menú después de elegir |
disabled | boolean | false | Deshabilita el ítem |
className | string | - | Clases CSS adicionales |
DropdownMenu.Label
| Prop | Tipo | Por defecto | Descripción |
|---|---|---|---|
children | ReactNode | - | Texto de la etiqueta |
DropdownMenu.Separator
Separador visual entre elementos del menú.
Sin props - renderiza una línea horizontal.
¿Encontraste algo que mejorar?
¿Notaste un error, tipografía o detalle faltante en esta página? Ayúdanos a mejorar la documentación abriendo un issue en GitHub.