Tooltip
A simplified wrapper for Shadcn Tooltip with flexible option handling and automatic type conversion
Installation
npx shadcn@latest add @glrk-ui/tooltipIf you haven't set up the prerequisites yet, check out Prerequest section.
Copy and paste the following code into your project.
"use client"
import { Tooltip as TooltipPrimitive } from "@base-ui/react/tooltip"
import { cn } from "@/lib/utils"
function TooltipProvider({ delay = 0, ...props }: TooltipPrimitive.Provider.Props) {
return (
<TooltipPrimitive.Provider
data-slot="tooltip-provider"
delay={delay}
{...props}
/>
)
}
function Tooltip(props: TooltipPrimitive.Root.Props) {
return <TooltipPrimitive.Root data-slot="tooltip" {...props} />
}
function TooltipTrigger(props: TooltipPrimitive.Trigger.Props) {
return <TooltipPrimitive.Trigger data-slot="tooltip-trigger" {...props} />
}
type tooltipContentT = TooltipPrimitive.Popup.Props & Pick<
TooltipPrimitive.Positioner.Props,
"align" | "alignOffset" | "side" | "sideOffset"
>
function TooltipContent({
className,
side = "top",
sideOffset = 4,
align = "center",
alignOffset = 0,
children,
...props
}: tooltipContentT) {
return (
<TooltipPrimitive.Portal>
<TooltipPrimitive.Positioner
align={align}
alignOffset={alignOffset}
side={side}
sideOffset={sideOffset}
>
<TooltipPrimitive.Popup
data-slot="tooltip-content"
className={cn(
"inline-flex w-fit max-w-xs origin-(--transform-origin) items-center gap-1.5 rounded-md bg-foreground px-3 py-1.5 text-xs text-background has-data-[slot=kbd]:pr-1.5 data-[side=bottom]:slide-in-from-top-2 data-[side=inline-end]:slide-in-from-left-2 data-[side=inline-start]:slide-in-from-right-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]: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="size-2.5 translate-y-[calc(-50%-2px)] rotate-45 rounded-[2px] bg-foreground fill-foreground data-[side=bottom]:top-1 data-[side=inline-end]:top-1/2! data-[side=inline-end]:-left-1 data-[side=inline-end]:-translate-y-1/2 data-[side=inline-start]:top-1/2! data-[side=inline-start]:-right-1 data-[side=inline-start]:-translate-y-1/2 data-[side=left]:top-1/2! data-[side=left]:-right-1 data-[side=left]:-translate-y-1/2 data-[side=right]:top-1/2! data-[side=right]:-left-1 data-[side=right]:-translate-y-1/2 data-[side=top]:-bottom-2.5" />
</TooltipPrimitive.Popup>
</TooltipPrimitive.Positioner>
</TooltipPrimitive.Portal>
)
}
type TooltipWrapperProps = {
trigger: React.ReactNode
content: React.ReactNode
triggerCls?: string
contentCls?: string
contentProps?: Omit<tooltipContentT, "className">
} & Omit<TooltipPrimitive.Provider.Props, "children">
function TooltipWrapper({
trigger,
content,
triggerCls,
contentCls,
contentProps,
...props
}: TooltipWrapperProps) {
return (
<Tooltip {...props}>
<TooltipTrigger className={cn(triggerCls)}>
{trigger}
</TooltipTrigger>
<TooltipContent {...contentProps} className={cn(contentCls)}>
{content}
</TooltipContent>
</Tooltip>
)
}
export {
Tooltip,
TooltipTrigger,
TooltipContent,
TooltipProvider,
TooltipWrapper,
}Usage
Basic
import { TooltipWrapper } from "@/components/ui/tooltip";
export function Basic() {
return (
<TooltipWrapper
trigger="Hover"
content="Some tooltip content"
/>
)
}Reference
TooltipWrapper
Prop
Type