111k
新建

Tooltip

PreviousNext

当元素获得键盘焦点或鼠标悬停时显示相关信息的弹出层。

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

安装

运行以下命令：

pnpm dlx shadcn@latest add tooltip

将 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>悬停</TooltipTrigger>
  <TooltipContent>
    <p>添加到库</p>
  </TooltipContent>
</Tooltip>

示例

侧边

使用 side 属性可以改变 tooltip 的位置。

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

带键盘快捷键

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

禁用按钮

通过用 span 包裹禁用按钮，也可以显示 tooltip。

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

RTL

要在 shadcn/ui 中启用 RTL 支持，请参见 RTL 配置指南。

"use client"

import { Button } from "@/examples/base/ui-rtl/button"

API 参考

更多信息请参见 Base UI Tooltip 文档。