Skip to content

Tooltip

Tooltip组件可以在用户悬停或点击界面元素时,以浮动的方式显示一段文本或图标,提供有关该元素的附加信息,例如解释按钮的功能、标签的含义等。

基础用法

使用content属性决定提示消息。

基础用法
Tooltip 组件的基础用法
<template>
  <ElTooltip 
    content="content"
  >
    <ElButton> 显示 Tooltip </ElButton>
  </ElTooltip>
</template>
<script setup>
import ElTooltip from '@/components/Tooltip/Tooltip.vue'
import ElButton from '@/components/Button/Button.vue'
</script>

展示位置

通过placement属性决定提示展示的位置效果。

placement属性值为:[方向]-[对齐位置];四个方向:top、left、right、bottom;三种对齐位置:start, end,默认为空。 如 placement="left-end",则提示信息出现在目标元素的左侧,且提示信息的底部与目标元素的底部对齐。

Hover触发
Hover触发Tooltip的显示
<template>
  <div class="tooltip-base-box">
    <div class="row center">
      <el-tooltip
        class="box-item"
        effect="dark"
        content="Top Left prompts info"
        placement="top-start"
      >
        <el-button>top-start</el-button>
      </el-tooltip>
      <el-tooltip
        class="box-item"
        effect="dark"
        content="Top Center prompts info"
        placement="top"
      >
        <el-button>top</el-button>
      </el-tooltip>
      <el-tooltip
        class="box-item"
        effect="dark"
        content="Top Right prompts info"
        placement="top-end"
      >
        <el-button>top-end</el-button>
      </el-tooltip>
    </div>
    <div class="row">
      <el-tooltip
        class="box-item"
        effect="dark"
        content="Left Top prompts info"
        placement="left-start"
      >
        <el-button>left-start</el-button>
      </el-tooltip>
      <el-tooltip
        class="box-item"
        effect="dark"
        content="Right Top prompts info"
        placement="right-start"
      >
        <el-button>right-start</el-button>
      </el-tooltip>
    </div>
    <div class="row">
      <el-tooltip
        class="box-item"
        effect="dark"
        content="Left Center prompts info"
        placement="left"
      >
        <el-button class="mt-3 mb-3">left</el-button>
      </el-tooltip>
      <el-tooltip
        class="box-item"
        effect="dark"
        content="Right Center prompts info"
        placement="right"
      >
        <el-button>right</el-button>
      </el-tooltip>
    </div>
    <div class="row">
      <el-tooltip
        class="box-item"
        effect="dark"
        content="Left Bottom prompts info"
        placement="left-end"
      >
        <el-button>left-end</el-button>
      </el-tooltip>
      <el-tooltip
        class="box-item"
        effect="dark"
        content="Right Bottom prompts info"
        placement="right-end"
      >
        <el-button>right-end</el-button>
      </el-tooltip>
    </div>
    <div class="row center">
      <el-tooltip
        class="box-item"
        effect="dark"
        content="Bottom Left prompts info"
        placement="bottom-start"
      >
        <el-button>bottom-start</el-button>
      </el-tooltip>
      <el-tooltip
        class="box-item"
        effect="dark"
        content="Bottom Center prompts info"
        placement="bottom"
      >
        <el-button>bottom</el-button>
      </el-tooltip>
      <el-tooltip
        class="box-item"
        effect="dark"
        content="Bottom Right prompts info"
        placement="bottom-end"
      >
        <el-button>bottom-end</el-button>
      </el-tooltip>
    </div>
  </div>
</template>
<script setup>
import ElTooltip from '@/components/Tooltip/Tooltip.vue'
import ElButton from '@/components/Button/Button.vue'
</script>
<style>
.tooltip-base-box {
  width: 600px;
}
.tooltip-base-box .row {
  display: flex;
  align-items: center;
  justify-content: space-between;
}
.tooltip-base-box .center {
  justify-content: center;
}
.tooltip-base-box .box-item {
  width: 110px;
  margin-top: 10px;
}
</style>

Hover触发

通过trigger属性改变Tooltip的触发方式,可选值有 hover | click

Hover触发
Hover触发Tooltip的显示
<template>
  <ElTooltip 
    content="Content"
    trigger="hover"
  >
    <ElButton> Hover状态下 显示 Tooltip显示 </ElButton>
  </ElTooltip>
</template>
<script setup>
import ElTooltip from '@/components/Tooltip/Tooltip.vue'
import ElButton from '@/components/Button/Button.vue'
</script>

更多内容的文字提示

展示多行文本或者是设置文本内容的格式

用具名 slot content,替代tooltip中的content属性。

Hover触发
Hover触发Tooltip的显示
<template>
  <el-tooltip>
    <template #content> multiple lines<br />second line </template>
    <el-button>Top center</el-button>
  </el-tooltip>
</template>
<script setup>
import ElTooltip from '@/components/Tooltip/Tooltip.vue'
import ElButton from '@/components/Button/Button.vue'
</script>