Drawer
จาก shadcnลิ้นชักเลื่อนจากขอบจอ รองรับการปัดเพื่อปิดและจุดยึดระหว่างทาง (snap points) เหมาะกับตัวกรองหรือแผงรายละเอียดบนมือถือ
ติดตั้ง
Terminal
pnpm dlx shadcn@latest add @whereui/drawerต้องผูก registry และติดตั้ง @whereui/theme นำหน้าเสมอเมื่อติดตั้งครั้งแรก
การใช้งาน
import { Button } from "@/components/ui/button"import { Drawer, DrawerClose, DrawerContent, DrawerFooter, DrawerHeader, DrawerTitle, DrawerTrigger } from "@/components/ui/drawer"<Drawer showSwipeHandle> <DrawerTrigger render={<Button variant="outline" />}>เปิด</DrawerTrigger> <DrawerContent> <DrawerHeader> <DrawerTitle>ตัวกรอง</DrawerTitle> </DrawerHeader> <DrawerFooter> <DrawerClose render={<Button />}>เสร็จสิ้น</DrawerClose> </DrawerFooter> </DrawerContent></Drawer>ตัวอย่างเพิ่มเติม
เปิดจากด้านซ้าย/ขวา
ข้อควรรู้
- ค่าเริ่มต้นเลื่อนออกจากด้านล่าง ตั้ง swipeDirection เป็น left / right / up เพื่อเปลี่ยนด้าน
- showSwipeHandle แสดงที่จับปัดด้านบน ช่วยบอกผู้ใช้มือถือว่าปัดปิดได้
ซอร์สโค้ด
components/ui/drawer.tsx
"use client"import * as React from "react"import { Drawer as DrawerPrimitive } from "@base-ui/react/drawer"import { cn } from "cn"type DrawerContextProps = { hasSnapPoints: boolean modal: DrawerPrimitive.Root.Props["modal"] showSwipeHandle: boolean swipeDirection: NonNullable<DrawerPrimitive.Root.Props["swipeDirection"]>}const DrawerContext = React.createContext<DrawerContextProps | null>(null)function useDrawer() { const context = React.useContext(DrawerContext) if (!context) { throw new Error("useDrawer must be used within a Drawer.") } return context}function Drawer({ modal = true, showSwipeHandle = false, snapPoints, swipeDirection = "down", ...props}: DrawerPrimitive.Root.Props & { showSwipeHandle?: boolean}) { const hasSnapPoints = snapPoints != null && snapPoints.length > 0 const contextValue = React.useMemo( () => ({ hasSnapPoints, modal, showSwipeHandle, swipeDirection }), [hasSnapPoints, modal, showSwipeHandle, swipeDirection] ) return ( <DrawerContext.Provider value={contextValue}> <DrawerPrimitive.Root data-slot="drawer" modal={modal} snapPoints={snapPoints} swipeDirection={swipeDirection} {...props} /> </DrawerContext.Provider> )}function DrawerTrigger({ ...props }: DrawerPrimitive.Trigger.Props) { return <DrawerPrimitive.Trigger data-slot="drawer-trigger" {...props} />}function DrawerPortal({ ...props }: DrawerPrimitive.Portal.Props) { return <DrawerPrimitive.Portal data-slot="drawer-portal" {...props} />}function DrawerClose({ ...props }: DrawerPrimitive.Close.Props) { return <DrawerPrimitive.Close data-slot="drawer-close" {...props} />}function DrawerOverlay({ className, ...props}: DrawerPrimitive.Backdrop.Props) { return ( <DrawerPrimitive.Backdrop data-slot="drawer-overlay" className={cn( "fixed inset-0 z-50 min-h-dvh bg-black/10 opacity-[max(var(--drawer-overlay-min-opacity,0),calc(1-var(--drawer-swipe-progress)))] transition-opacity duration-450 ease-[cubic-bezier(0.32,0.72,0,1)] select-none data-ending-style:pointer-events-none data-ending-style:opacity-0 data-ending-style:duration-[calc(var(--drawer-swipe-strength)*400ms)] data-snap-points:[--drawer-overlay-min-opacity:0.5] data-starting-style:opacity-0 data-swiping:duration-0 supports-backdrop-filter:backdrop-blur-xs supports-[-webkit-touch-callout:none]:absolute", className )} {...props} /> )}function DrawerSwipeHandle({ className, ...props}: React.ComponentProps<"div">) { return ( <div data-slot="drawer-swipe-handle" aria-hidden="true" className={cn( "relative z-10 flex shrink-0 cursor-grab transition-opacity duration-200 group-data-nested-drawer-open/drawer-popup:opacity-0 group-data-nested-drawer-swiping/drawer-popup:opacity-100 group-data-[swipe-axis=x]/drawer-popup:h-full group-data-[swipe-axis=x]/drawer-popup:w-3 group-data-[swipe-axis=x]/drawer-popup:items-center group-data-[swipe-axis=y]/drawer-popup:h-3 group-data-[swipe-axis=y]/drawer-popup:w-full group-data-[swipe-axis=y]/drawer-popup:justify-center group-data-[swipe-direction=down]/drawer-popup:items-end group-data-[swipe-direction=left]/drawer-popup:order-last group-data-[swipe-direction=left]/drawer-popup:justify-start group-data-[swipe-direction=right]/drawer-popup:justify-end group-data-[swipe-direction=up]/drawer-popup:order-last group-data-[swipe-direction=up]/drawer-popup:items-start after:block after:shrink-0 after:rounded-full after:bg-muted group-data-[swipe-axis=x]/drawer-popup:after:h-24 group-data-[swipe-axis=x]/drawer-popup:after:w-1 group-data-[swipe-axis=y]/drawer-popup:after:h-1 group-data-[swipe-axis=y]/drawer-popup:after:w-24 active:cursor-grabbing", className )} {...props} /> )}function DrawerContent({ className, children, ...props}: DrawerPrimitive.Popup.Props) { const { hasSnapPoints, modal, showSwipeHandle, swipeDirection } = useDrawer() const swipeAxis = swipeDirection === "down" || swipeDirection === "up" ? "y" : "x" return ( <DrawerPortal data-slot="drawer-portal"> {modal === true && ( <DrawerOverlay data-snap-points={hasSnapPoints ? "" : undefined} /> )} <DrawerPrimitive.Viewport data-slot="drawer-viewport" data-modal={modal} className="pointer-events-none fixed inset-0 z-50 select-none data-[modal=true]:pointer-events-auto" > <DrawerPrimitive.Popup data-slot="drawer-popup" data-swipe-axis={swipeAxis} data-snap-points={hasSnapPoints ? "" : undefined} className={cn( // Base. "group/drawer-popup pointer-events-auto fixed z-50 m-(--drawer-inset,0px) flex h-(--drawer-content-height) max-h-(--drawer-content-max-height,none) min-h-0 w-(--drawer-content-width,auto) transform-[translate3d(var(--translate-x,0px),var(--translate-y,0px),0)_scale(var(--stack-scale))] flex-col bg-popover text-sm text-popover-foreground transition-[transform,height,opacity,filter] duration-450 ease-[cubic-bezier(0.22,1,0.36,1)] will-change-transform outline-none select-none [interpolate-size:allow-keywords] data-[swipe-direction=down]:rounded-t-xl data-[swipe-direction=down]:border-t data-[swipe-direction=left]:rounded-r-xl data-[swipe-direction=left]:border-r data-[swipe-direction=right]:rounded-l-xl data-[swipe-direction=right]:border-l data-[swipe-direction=up]:rounded-b-xl data-[swipe-direction=up]:border-b", // Nested. "data-nested-drawer-open:overflow-hidden data-nested-drawer-open:brightness-95", // Bleed. "after:pointer-events-none after:absolute after:bg-(--drawer-bleed-background,var(--color-popover)) data-[swipe-axis=x]:after:inset-y-0 data-[swipe-axis=x]:after:w-(--bleed) data-[swipe-axis=y]:after:inset-x-0 data-[swipe-axis=y]:after:h-(--bleed) data-[swipe-direction=down]:after:top-full data-[swipe-direction=left]:after:right-full data-[swipe-direction=right]:after:left-full data-[swipe-direction=up]:after:bottom-full", // Sizing. "[--drawer-content-height:var(--drawer-height,auto)] data-[swipe-axis=x]:[--drawer-content-width:75%] data-[swipe-axis=y]:[--drawer-content-max-height:calc(100dvh-6rem)] data-[swipe-axis=y]:data-snap-points:[--drawer-content-height:100dvh] data-[swipe-axis=x]:sm:[--drawer-content-width:24rem]", // Stack. "[--bleed:3rem] [--peek:1rem] [--stack-height:var(--drawer-frontmost-height,var(--drawer-height,0px))] [--stack-peek-offset:max(0px,calc((var(--nested-drawers)-var(--stack-progress))*var(--peek)))] [--stack-progress:clamp(0,var(--drawer-swipe-progress),1)] [--stack-scale-base:max(0,calc(1-(var(--nested-drawers)*var(--stack-step))))] [--stack-scale:clamp(0,calc(var(--stack-scale-base)+(var(--stack-step)*var(--stack-progress))),1)] [--stack-shrink:calc(1-var(--stack-scale))] [--stack-step:0.05]", // Transitions. "data-ending-style:transform-(--closed-transform) data-ending-style:opacity-[0.9999] data-ending-style:duration-[calc(var(--drawer-swipe-strength)*400ms)] data-nested-drawer-swiping:duration-0 data-ending-style:data-nested-drawer-swiping:duration-[calc(var(--drawer-swipe-strength)*400ms)] data-starting-style:transform-(--closed-transform) data-swiping:duration-0 data-ending-style:data-swiping:duration-[calc(var(--drawer-swipe-strength)*400ms)]", // Axis: y. "data-[swipe-axis=y]:inset-x-0 data-[swipe-axis=y]:data-nested-drawer-open:h-(--stack-height)", // Axis: x. "data-[swipe-axis=x]:inset-y-0 data-[swipe-axis=x]:flex-row", // Direction: down. "data-[swipe-direction=down]:bottom-0 data-[swipe-direction=down]:origin-bottom data-[swipe-direction=down]:[--closed-transform:translate3d(0,calc(100%+var(--drawer-inset,0px)+2px),0)] data-[swipe-direction=down]:[--translate-y:calc(var(--drawer-snap-point-offset,0px)+var(--drawer-swipe-movement-y)-var(--stack-peek-offset)-(var(--stack-shrink)*var(--stack-height)))]", // Direction: up. "data-[swipe-direction=up]:top-0 data-[swipe-direction=up]:origin-top data-[swipe-direction=up]:[--closed-transform:translate3d(0,calc(-100%-var(--drawer-inset,0px)-2px),0)] data-[swipe-direction=up]:[--translate-y:calc(var(--drawer-snap-point-offset,0px)+var(--drawer-swipe-movement-y)+var(--stack-peek-offset)+(var(--stack-shrink)*var(--stack-height)))]", // Direction: left. "data-[swipe-direction=left]:left-0 data-[swipe-direction=left]:origin-left data-[swipe-direction=left]:[--closed-transform:translate3d(calc(-100%-var(--drawer-inset,0px)-2px),0,0)] data-[swipe-direction=left]:[--translate-x:calc(var(--drawer-swipe-movement-x)+var(--stack-peek-offset)+(var(--stack-shrink)*100%))]", // Direction: right. "data-[swipe-direction=right]:right-0 data-[swipe-direction=right]:origin-right data-[swipe-direction=right]:[--closed-transform:translate3d(calc(100%+var(--drawer-inset,0px)+2px),0,0)] data-[swipe-direction=right]:[--translate-x:calc(var(--drawer-swipe-movement-x)-var(--stack-peek-offset)-(var(--stack-shrink)*100%))]", className )} {...props} > {showSwipeHandle && <DrawerSwipeHandle />} <DrawerPrimitive.Content data-slot="drawer-content" className={cn( "flex min-h-0 flex-1 flex-col overflow-hidden overscroll-contain rounded-[inherit] transition-opacity duration-300 ease-[cubic-bezier(0.45,1.005,0,1.005)] select-text group-data-nested-drawer-open/drawer-popup:opacity-0 group-data-nested-drawer-swiping/drawer-popup:opacity-100 group-data-swiping/drawer-popup:select-none" )} > {children} </DrawerPrimitive.Content> </DrawerPrimitive.Popup> </DrawerPrimitive.Viewport> </DrawerPortal> )}function DrawerHeader({ className, ...props }: React.ComponentProps<"div">) { return ( <div data-slot="drawer-header" className={cn( "flex shrink-0 flex-col gap-0.5 p-4 pb-0 group-data-[swipe-axis=y]/drawer-popup:text-center md:gap-0.5 md:text-left", className )} {...props} /> )}function DrawerFooter({ className, ...props }: React.ComponentProps<"div">) { return ( <div data-slot="drawer-footer" className={cn("mt-auto flex shrink-0 flex-col gap-2 p-4 pt-0", className)} {...props} /> )}function DrawerTitle({ className, ...props }: DrawerPrimitive.Title.Props) { return ( <DrawerPrimitive.Title data-slot="drawer-title" className={cn( "font-heading text-base font-medium text-foreground", className )} {...props} /> )}function DrawerDescription({ className, ...props}: DrawerPrimitive.Description.Props) { return ( <DrawerPrimitive.Description data-slot="drawer-description" className={cn("text-sm text-balance text-muted-foreground", className)} {...props} /> )}export { Drawer, DrawerPortal, DrawerOverlay, DrawerSwipeHandle, DrawerTrigger, DrawerClose, DrawerContent, DrawerHeader, DrawerFooter, DrawerTitle, DrawerDescription,}