Tooltip
จาก shadcnคำแนะนำสั้น ๆ ที่โผล่เมื่อชี้หรือโฟกัสที่ element เหมาะกับปุ่มไอคอนที่ไม่มีข้อความกำกับ เลือกด้านที่โผล่ได้ 4 ด้าน
ติดตั้ง
Terminal
pnpm dlx shadcn@latest add @whereui/tooltipต้องผูก registry และติดตั้ง @whereui/theme นำหน้าเสมอเมื่อติดตั้งครั้งแรก
การใช้งาน
import { Tooltip, TooltipContent, TooltipTrigger } from "@/components/ui/tooltip"import { Button } from "@/components/ui/button"<Tooltip> <TooltipTrigger render={<Button variant="outline" />}>ชี้ที่นี่</TooltipTrigger> <TooltipContent>รายละเอียดเพิ่มเติม</TooltipContent></Tooltip>ข้อควรรู้
- Base UI ไม่มี asChild — ใช้ prop render ส่ง component ที่ต้องการให้ trigger แสดงผลเป็น
- ปรับด้านด้วย side (top, right, bottom, left) และระยะห่างด้วย sideOffset บน TooltipContent
- tooltip ควรเป็นข้อมูลเสริมเท่านั้น ห้ามเก็บข้อมูลจำเป็นไว้ใน tooltip เพราะผู้ใช้จอสัมผัสเข้าไม่ถึง
ซอร์สโค้ด
components/ui/tooltip.tsx
"use client"import { Tooltip as TooltipPrimitive } from "@base-ui/react/tooltip"import { cn } from "cn"function TooltipProvider({ delay = 0, ...props}: TooltipPrimitive.Provider.Props) { return ( <TooltipPrimitive.Provider data-slot="tooltip-provider" delay={delay} {...props} /> )}function Tooltip({ ...props }: TooltipPrimitive.Root.Props) { return <TooltipPrimitive.Root data-slot="tooltip" {...props} />}function TooltipTrigger({ ...props }: TooltipPrimitive.Trigger.Props) { return <TooltipPrimitive.Trigger data-slot="tooltip-trigger" {...props} />}function TooltipContent({ className, side = "top", sideOffset = 4, align = "center", alignOffset = 0, children, ...props}: TooltipPrimitive.Popup.Props & Pick< TooltipPrimitive.Positioner.Props, "align" | "alignOffset" | "side" | "sideOffset" >) { return ( <TooltipPrimitive.Portal> <TooltipPrimitive.Positioner align={align} alignOffset={alignOffset} side={side} sideOffset={sideOffset} className="isolate z-50" > <TooltipPrimitive.Popup data-slot="tooltip-content" className={cn( "z-50 inline-flex w-fit max-w-xs origin-(--transform-origin) items-center gap-1.5 rounded-md bg-foreground px-3 py-1.5 text-xs text-background has-data-[slot=kbd]:pr-1.5 data-[side=bottom]:slide-in-from-top-2 data-[side=inline-end]:slide-in-from-left-2 data-[side=inline-start]:slide-in-from-right-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-[slot=kbd]:relative **:data-[slot=kbd]:isolate **:data-[slot=kbd]:z-50 **:data-[slot=kbd]:rounded-sm data-[state=delayed-open]:animate-in data-[state=delayed-open]:fade-in-0 data-[state=delayed-open]:zoom-in-95 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", className )} {...props} > {children} <TooltipPrimitive.Arrow className="z-50 size-2.5 translate-y-[calc(-50%-2px)] rotate-45 rounded-[2px] bg-foreground fill-foreground data-[side=bottom]:top-1 data-[side=inline-end]:top-1/2! data-[side=inline-end]:-left-1 data-[side=inline-end]:-translate-y-1/2 data-[side=inline-start]:top-1/2! data-[side=inline-start]:-right-1 data-[side=inline-start]:-translate-y-1/2 data-[side=left]:top-1/2! data-[side=left]:-right-1 data-[side=left]:-translate-y-1/2 data-[side=right]:top-1/2! data-[side=right]:-left-1 data-[side=right]:-translate-y-1/2 data-[side=top]:-bottom-2.5" /> </TooltipPrimitive.Popup> </TooltipPrimitive.Positioner> </TooltipPrimitive.Portal> )}export { Tooltip, TooltipTrigger, TooltipContent, TooltipProvider }