콘텐츠로 건너뛰기
1.6k

툴팁

아이콘 버튼, 키보드 단축키 및 잘린 레이블에 대한 마우스 오버 및 포커스 힌트 — 네오브루탈리즘 스타일의 테두리와 그림자 효과를 적용했습니다.

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

툴팁은 호버나 키보드 포커스 시 나타나는 짧은 레이블로, 감싼 컨트롤을 설명합니다. 보조 텍스트이며 상호작용 콘텐츠를 둘 곳이 아닙니다. Base UI Tooltip 프리미티브를 기반으로 하며 포털과 충돌 감지를 지원하고, 어떤 배경에서도 읽히도록 두꺼운 테두리, 선명한 그림자, 반전 채움으로 네오브루탈리즘 공식을 입혔습니다.

다음과 같은 경우에 사용합니다.

  • 아이콘만 있는 버튼 — 맨 아이콘이 말하지 못하는 동작을 이름 붙입니다. 툴바, 테이블 행 동작, 에디터 컨트롤.
  • 키보드 단축키 — 아래 예제처럼 레이블 옆에 Kbd로 바인딩을 적습니다.
  • 잘리거나 짧은 텍스트 — 전체 파일 이름, 잘린 테이블 셀, 축약된 상태 코드.

설치

다음 명령을 실행합니다.

pnpm dlx shadcn@latest add https://neobrutalism.com/r/base/tooltip.json
npx shadcn@latest add https://neobrutalism.com/r/base/tooltip.json
yarn dlx shadcn@latest add https://neobrutalism.com/r/base/tooltip.json
bunx --bun shadcn@latest add https://neobrutalism.com/r/base/tooltip.json

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

app/layout.tsx
import { TooltipProvider } from "@/components/ui/tooltip"
 
export default function RootLayout({ children }) {
  return (
    <html lang="en">
      <body>
        <TooltipProvider>{children}</TooltipProvider>
      </body>
    </html>
  )
}

다음 의존성을 설치합니다.

pnpm add @base-ui/react
npm install @base-ui/react
yarn add @base-ui/react
bun add @base-ui/react

다음 코드를 복사하여 프로젝트에 붙여넣습니다.

components/ui/tooltip.tsx
"use client"

import * as React from "react"
import { Tooltip as TooltipPrimitive } from "radix-ui"

import { cn } from "@/lib/utils"

function TooltipProvider({
  delayDuration = 0,
  ...props
}: React.ComponentProps<typeof TooltipPrimitive.Provider>) {
  return (
    <TooltipPrimitive.Provider
      data-slot="tooltip-provider"
      delayDuration={delayDuration}
      {...props}
    />
  )
}

function Tooltip({
  ...props
}: React.ComponentProps<typeof TooltipPrimitive.Root>) {
  return <TooltipPrimitive.Root data-slot="tooltip" {...props} />
}

function TooltipTrigger({
  ...props
}: React.ComponentProps<typeof TooltipPrimitive.Trigger>) {
  return <TooltipPrimitive.Trigger data-slot="tooltip-trigger" {...props} />
}

function TooltipContent({
  className,
  sideOffset = 0,
  children,
  ...props
}: React.ComponentProps<typeof TooltipPrimitive.Content>) {
  return (
    <TooltipPrimitive.Portal>
      <TooltipPrimitive.Content
        data-slot="tooltip-content"
        sideOffset={sideOffset}
        className={cn(
          "z-50 inline-flex w-fit max-w-xs origin-(--radix-tooltip-content-transform-origin) items-center gap-1.5 rounded border-2 bg-foreground px-2 py-1 text-xs text-background shadow-md has-data-[slot=kbd]:pr-1.5 data-[side=bottom]:slide-in-from-top-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" />
      </TooltipPrimitive.Content>
    </TooltipPrimitive.Portal>
  )
}

export { Tooltip, TooltipContent, TooltipProvider, TooltipTrigger }

임포트 경로를 프로젝트 구성에 맞게 조정합니다.

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

app/layout.tsx
import { TooltipProvider } from "@/components/ui/tooltip"
 
export default function RootLayout({ children }) {
  return (
    <html lang="en">
      <body>
        <TooltipProvider>{children}</TooltipProvider>
      </body>
    </html>
  )
}

사용법

import {
  Tooltip,
  TooltipContent,
  TooltipTrigger,
} from "@/components/ui/tooltip"
<Tooltip>
  <TooltipTrigger>Hover</TooltipTrigger>
  <TooltipContent>
    <p>Add to library</p>
  </TooltipContent>
</Tooltip>

구성

다음 구성을 사용하여 Tooltip을 구축합니다.

Tooltip
├── TooltipTrigger
└── TooltipContent

예제

표시 위치

side prop을 사용하여 툴팁의 표시 위치를 변경합니다.

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

키보드 단축키 포함

import { SaveIcon } from "lucide-react"

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

비활성화된 버튼

비활성화된 버튼을 span으로 감싸서 해당 버튼에 툴팁을 표시합니다.

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

RTL

Neobrutalism에서 RTL 지원을 활성화하는 방법은 RTL 설정 가이드를 참고하세요.

"use client"

import {

접근성

툴팁은 WAI-ARIA Tooltip 패턴을 따릅니다. 콘텐츠(팝업)는 role="tooltip"으로 렌더링되고 프리미티브가 트리거의 aria-describedby를 가리키므로, 스크린 리더가 힌트를 컨트롤 설명으로 읽습니다. 툴팁 자체는 포커스를 받지 않습니다. 링크나 버튼은 Popover에 두고, 툴팁 없이도 트리거를 이해할 수 있게 하세요.

키보드 상호작용:

키동작
Tab / Shift + Tab트리거로 포커스 이동 — 포커스하면 툴팁이 열리고, 떠나면 닫힘
Escape포커스는 트리거에 둔 채 툴팁 닫기
Enter / Space트리거 자체 동작 활성화 — 툴팁은 설명이지 컨트롤이 아님

API 참조

Base UI Tooltip 문서를 참고하세요.