راهنمای ابزار
نکات شناور و فوکوس برای دکمههای آیکونی، میانبرهای صفحهکلید و برچسبهای کوتاهشده — با جلوهی نئوبروتالیستی حاشیه و سایه.
import { Button } from "@/components/ui/button"
import {
Tooltip,Tooltip برچسب کوتاهی است که با hover یا فوکوس صفحهکلید ظاهر میشود و کنترلی را که میپیچد توصیف میکند — متن مکمل، هرگز جایی برای محتوای تعاملی. بر پایهٔ Base UI Tooltip ساخته شده، portalled و collision-aware، با دستور پخت نئوبروتالیستی: حاشیهٔ ضخیم، سایهٔ سخت و fill معکوس تا روی هر پسزمینه خوانا باشد.
برای این موارد از آن استفاده کنید:
- دکمههای فقطآیکون — اقدامی را که آیکون لخت نمیگوید نام ببرید: نوار ابزار، اقدام ردیف جدول، کنترل ویرایشگر.
- میانبر صفحهکلید — binding را کنار برچسب با
Kbdبنویسید، مثل نمونهٔ پایین. - متن کوتاهشده یا فشرده — نام کامل فایل، سلول جدول بریدهشده، کد وضعیت مختصر.
نصب#
دستور زیر را اجرا کنید:
pnpm dlx shadcn@latest add https://neobrutalism.com/r/base/tooltip.jsonnpx shadcn@latest add https://neobrutalism.com/r/base/tooltip.jsonyarn dlx shadcn@latest add https://neobrutalism.com/r/base/tooltip.jsonbunx --bun shadcn@latest add https://neobrutalism.com/r/base/tooltip.json
TooltipProvider را به ریشهٔ برنامهٔ خود اضافه کنید.
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/reactnpm install @base-ui/reactyarn add @base-ui/reactbun add @base-ui/react
کد زیر را کپی کرده و در پروژهٔ خود بچسبانید.
"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 را به ریشهٔ برنامهٔ خود اضافه کنید.
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 استفاده کنید.
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#
برای فعالکردن پشتیبانی از RTL در Neobrutalism، راهنمای پیکربندی RTL را ببینید.
"use client"
import {دسترسیپذیری#
Tooltip از الگوی WAI-ARIA Tooltip پیروی میکند: پاپآپ با role="tooltip" رندر میشود و primitive مقدار aria-describedby تریگر را به آن اشاره میدهد تا صفحهخوان راهنما را بهعنوان توضیح کنترل اعلام کند. خود tooltip هرگز فوکوس نمیگیرد — لینک یا دکمه را در Popover بگذارید و تریگر را بدون آن قابلفهم نگه دارید.
تعاملات صفحهکلید:
| کلید | عمل |
|---|---|
Tab / Shift + Tab | انتقال فوکوس به تریگر — فوکوس tooltip را باز میکند، ترک کردن میبندد |
Escape | بستن tooltip در حالی که فوکوس روی تریگر میماند |
Enter / Space | فعالسازی اقدام خود تریگر — tooltip توضیح است نه کنترل |
مرجع API#
مستندات Base UI Tooltip را ببینید.