Tooltip 文字提示

优质
小牛编辑
120浏览
2023-12-01

常用于展示鼠标 hover 时的提示信息。

与其他组件一样,此组件未依赖任何第三方组件,这是与 element-vue 的不同之处。

基础用法

在这里我们提供 9 种不同方向的展示方式,可以通过以下完整示例来理解,选择你要的效果。

使用 ng-template#tip 属性来决定 hover 时的提示信息或模板。由 placement 属性决定展示效果,提示框体展示的位置与朝向。具体请参阅组件接口文档。

<div class="box">
  <div class="top">
    <el-tooltip placement="top-start">
      <el-button>上左</el-button>
      <ng-template #tip><span>placement is top-start</span></ng-template>
    </el-tooltip>
    <el-tooltip placement="top">
      <el-button>上边</el-button>
      <ng-template #tip> <span>placement is top</span> </ng-template>
    </el-tooltip>
    <el-tooltip placement="top-end">
      <el-button>上右</el-button>
      <ng-template #tip><span>placement is top-end</span></ng-template>
    </el-tooltip>
  </div>
  <div class="left">
    <el-tooltip placement="left-start">
      <el-button>左上</el-button>
      <ng-template #tip><span>placement is left-start</span></ng-template>
    </el-tooltip>
    <el-tooltip placement="left">
      <el-button>左边</el-button>
      <ng-template #tip><span>placement is left</span></ng-template>
    </el-tooltip>
    <el-tooltip placement="left-end">
      <el-button>左下</el-button>
      <ng-template #tip><span>placement is left-end</span></ng-template>
    </el-tooltip>
  </div>
  <div class="right">
    <el-tooltip placement="right-start">
      <el-button>右上</el-button>
      <ng-template #tip><span>placement is right-start</span></ng-template>
    </el-tooltip>
    <el-tooltip placement="right">
      <el-button>右边</el-button>
      <ng-template #tip><span>placement is right</span></ng-template>
    </el-tooltip>
    <el-tooltip placement="right-end">
      <el-button>右下</el-button>
      <ng-template #tip><span>placement is right-end</span></ng-template>
    </el-tooltip>
  </div>
  <div class="bottom">
    <el-tooltip placement="bottom-start">
      <el-button>下左</el-button>
      <ng-template #tip><span>placement is bottom-start</span></ng-template>
    </el-tooltip>
    <el-tooltip placement="bottom">
      <el-button>下边</el-button>
      <ng-template #tip><span>placement is bottom</span></ng-template>
    </el-tooltip>
    <el-tooltip placement="bottom-end">
      <el-button>下右</el-button>
      <ng-template #tip> <span>placement is bottom-end</span> </ng-template>
    </el-tooltip>
  </div>
</div>

主题

Tooltip 组件提供了两个不同的主题:darklight

通过设置 effect 属性来改变主题,默认为 dark

<el-tooltip placement="top">
  <el-button>Dark</el-button>
  <ng-template #tip>
    <span>Top center</span>
  </ng-template>
</el-tooltip>
<el-tooltip placement="bottom" effect="light">
  <el-button>Light</el-button>
  <ng-template #tip>
    <span>Bottom center</span>
  </ng-template>
</el-tooltip>

禁用

设置提示禁用

设置禁用后不会影响内容本身的响应,但不再弹出提示。

<el-tooltip placement="bottom" [elDisabled]="true">
  <el-button>elDisabled</el-button>
  <ng-template #tip>
    <span>Top center</span>
  </ng-template>
</el-tooltip>

Tooltip Attributes

参数说明类型可选值默认值
effect默认提供的主题stringdark/lightdark
tip显示的内容ng-template
push栅格向右移动格数number0
placementTooltip 的出现位置stringtop/top-start/top-end/bottom/bottom-start/bottom-end/left/left-start/left-end/right/right-start/right-endbottom
elDisabledTooltip 是否可用boolean
visible-arrow是否显示 Tooltip 箭头boolean1
popper-class为 Tooltip 的 popper 添加类名string