GitHub

Tooltip

요소가 키보드 포커스를 받거나 마우스를 올렸을 때 관련 정보를 표시하는 팝업입니다.

examples/krds/tooltip-demo.tsx
import { Button } from "@/components/ui/button"
import {
  Tooltip,

설치

다음 명령어를 실행합니다.

pnpm dlx shadcn@latest add https://krdscn.gwlee.kr/r/tooltip.json

앱 루트에 TooltipProvider를 추가합니다.

app/layout.tsx
import { TooltipProvider } from "@/components/ui/tooltip"

export default function RootLayout({ children }) {
  return (
    <html lang="ko">
      <body>
        <TooltipProvider>{children}</TooltipProvider>
      </body>
    </html>
  )
}

사용법

import {
  Tooltip,
  TooltipContent,
  TooltipTrigger,
} from "@/components/ui/tooltip"
<Tooltip>
  <TooltipTrigger>도움말</TooltipTrigger>
  <TooltipContent>
    <p>이 항목은 제출 후 수정할 수 있습니다.</p>
  </TooltipContent>
</Tooltip>

구성

다음 조합으로 Tooltip:

Tooltip
├── TooltipTrigger
└── TooltipContent

예제

위치

side prop으로 툴팁 위치를 변경합니다.

examples/krds/tooltip-sides.tsx
import { Button } from "@/components/ui/button"
import {
  Tooltip,

키보드 단축키

examples/krds/tooltip-keyboard.tsx
import { SaveIcon } from "lucide-react"

import { Button } from "@/components/ui/button"

비활성 버튼

비활성 버튼은 span으로 감싸 툴팁 트리거를 제공합니다.

examples/krds/tooltip-disabled.tsx
import { Button } from "@/components/ui/button"
import {
  Tooltip,

RTL

RTL 지원을 활성화하려면 RTL 설정 가이드를 참고하세요.

examples/krds/tooltip-rtl.tsx
"use client"

import {

API 참조

Radix Tooltip 문서를 참고하세요.