טיפ
רמזים המופיעים בעת ריחוף והבלטה עבור כפתורי סמל, קיצורי מקלדת ותוויות מקוצרות — עם עיצוב ניאו-ברוטליסטי הכולל מסגרת וצל.
import { Button } from "@/components/ui/button"
import {
Tooltip,ה-tooltip הוא תווית קצרה שמופיעה ב-hover או בפוקוס מקלדת ומתארת את הבקרה שהיא עוטפת — טקסט משלים, אף פעם לא מקום לתוכן אינטראקטיבי. נבנה על גבי הפרימיטיב Base UI Tooltip, עם portal ומודע להתנגשויות, ומעוצב לפי המתכון הנאו-ברוטליסטי: מסגרת עבה, צל חד ומילוי הפוך כדי שייקרא על כל רקע.
השתמשו בו כש:
- כפתורי אייקון בלבד — נותנים שם לפעולה שאייקון חשוף לא מעביר: סרגלי כלים, פעולות שורת טבלה, בקרות עורך.
- קיצורי מקלדת — מפרטים את הקישור ליד התווית עם
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 }
עדכנו את נתיבי ה-import כך שיתאימו להגדרות הפרויקט שלכם.
הוסיפו את 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דוגמאות#
צד#
השתמשו ב-prop 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 עוקב אחרי דפוס Tooltip של WAI-ARIA: ה-popup מרנדר עם role="tooltip" והפרימיטיב מצביע את aria-describedby של הטריגר אליו, כך שקוראי מסך מכריזים על הרמז כתיאור של הבקרה. ה-tooltip עצמו אף פעם לא מקבל פוקוס — שימו קישורים או כפתורים ב-Popover במקום, והשאירו את הטריגר מובן בלעדיו.
אינטראקציות מקלדת:
| מקש | פעולה |
|---|---|
Tab / Shift + Tab | מעבירים מוקד לטריגר — פוקוס פותח את ה-tooltip, עזיבה סוגרת אותו |
Escape | סוגרים את ה-tooltip בזמן שהמוקד נשאר על הטריגר |
Enter / Space | מפעילים את הפעולה של הטריגר עצמו — ה-tooltip הוא תיאור, לא בקרה |
תיעוד ה-API#
למידע נוסף, עיינו בתיעוד של Base UI.