110k
New

提示工具

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 属性来更改提示工具的位置。

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

带键盘快捷键

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

禁用按钮

通过用 span 包裹禁用按钮来显示提示工具。

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 提示工具 文档。