Skip to content

Tooltip 文字提示

常用于展示额外的说明信息。

基础用法

默认通过 hover 触发,可以设置 contentplacement 等属性控制展示内容和位置。

基础用法
Tooltip 组件的基础用法
<script setup lang="ts">
import Button from '@/components/Button/Button.vue'
import Tooltip from '@/components/Tooltip/Tooltip.vue'
</script>

<template>
  <Tooltip content="这是一段提示信息">
    <Button>Hover 显示 Tooltip</Button>
  </Tooltip>

  <Tooltip content="点击触发" trigger="click">
    <Button type="primary">Click 显示 Tooltip</Button>
  </Tooltip>
</template>

API

Tooltip Attributes

参数说明类型默认值
content提示内容(也可以使用 slot)string-
trigger触发方式'click' | 'hover'hover
placement出现位置(Popper Placement)Placementbottom
manual是否手动控制显示/隐藏booleanfalse
popperOptionspopper.js 配置项Partial<Options>-
transition过渡动画名称stringfade
openDelay延迟显示的时间,毫秒number0
closeDelay延迟关闭的时间,毫秒number0

Tooltip Events

事件名说明回调参数
visible-change显隐状态变化时触发(visible: boolean)

Tooltip Exposed Methods

通过 ref 获取组件实例,可以调用以下方法:

方法名说明签名
show手动显示 tooltip() => void
hide手动隐藏 tooltip() => void