ข้ามไปเนื้อหา
WhereUI

ค้นหาในเอกสาร

ค้นหาชื่อ component หรือหน้าเอกสาร

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 }