탐색과 공개@neumorphism-ui/tooltip

Tooltip

Base UI Tooltip 기반으로 Provider, Root, Trigger, Portal, Positioner와 Popup을 조합합니다. 기본 provider 지연은 250ms이며 popup은 trigger 주변 충돌을 자동으로 피합니다.

@neumorphism-ui/tooltip
Registry JSON

미리보기

버튼에 hover하거나 focus하세요.

설치

설치: tooltipnpx shadcn@latest add @neumorphism-ui/tooltip

CLI가 npm 의존성, base 토큰, utils와 컴포넌트 소스를 순서대로 확인하고 설치합니다.

Registry를 처음 사용한다면 namespace 설정 을 먼저 완료하세요.

사용법

사용법: 설치npx shadcn@latest add @neumorphism-ui/button @neumorphism-ui/tooltip

Import

Tooltip import 코드
import { Button } from "@/components/ui/button"
import {
  Tooltip,
  TooltipContent,
  TooltipProvider,
  TooltipTrigger,
} from "@/components/ui/tooltip"

Example

Tooltip 사용 코드
<TooltipProvider>
  <Tooltip>
    <TooltipTrigger
      render={<Button size="icon" aria-label="설정 열기" />}
    >
      ⚙
    </TooltipTrigger>
    <TooltipContent side="top">
      설정
    </TooltipContent>
  </Tooltip>
</TooltipProvider>

API 레퍼런스

컴포넌트속성타입기본값설명
TooltipProviderdelaynumber250pointer hover 후 tooltip을 열기까지의 지연 시간(ms)입니다.
Tooltipopen / defaultOpenbooleanfalsecontrolled 또는 초기 uncontrolled 열림 상태입니다.
TooltiponOpenChange(open: boolean) => void—열림 상태가 바뀔 때 호출됩니다.
TooltipTriggerrenderReactElement | (props, state) => ReactElement—버튼이나 링크에 tooltip trigger 동작을 합성합니다.
TooltipContentside / align"top" | "right" | "bottom" | "left" / "start" | "center" | "end""top" / "center"trigger를 기준으로 popup 위치를 정합니다.
TooltipContentsideOffsetnumber8trigger와 popup 사이의 간격입니다.

접근성

  • 01

    Tooltip은 trigger의 접근 가능한 이름을 대신하지 않으므로 아이콘 버튼에는 별도 aria-label이 필요합니다.

  • 02

    내용은 짧고 보조적이어야 하며 필수 지침이나 오류 메시지를 Tooltip에만 넣지 않습니다.

  • 03

    Base UI가 hover뿐 아니라 keyboard focus에서 열고 Escape로 닫는 동작을 제공합니다.