ElementPlus Tooltip 文字提示

Tooltip 文字提示

常用于展示鼠標(biāo) hover 時(shí)的提示信息。

基礎(chǔ)用法

在這里我們提供 9 種不同方向的展示方式，可以通過以下完整示例來理解，選擇你要的效果。

使用content屬性來決定hover時(shí)的提示信息。由placement屬性決定展示效果：placement屬性值為：方向-對(duì)齊位置；四個(gè)方向：top、left、right、bottom；三種對(duì)齊位置：start, end，默認(rèn)為空。如placement="left-end"，則提示信息出現(xiàn)在目標(biāo)元素的左側(cè)，且提示信息的底部與目標(biāo)元素的底部對(duì)齊。

<template>
  <div class="box">
  <div class="top">
    <el-tooltip
      class="item"
      effect="dark"
      content="Top Left 提示文字"
      placement="top-start"
    >
      <el-button>上左</el-button>
    </el-tooltip>
    <el-tooltip
      class="item"
      effect="dark"
      content="Top Center 提示文字"
      placement="top"
    >
      <el-button>上邊</el-button>
    </el-tooltip>
    <el-tooltip
      class="item"
      effect="dark"
      content="Top Right 提示文字"
      placement="top-end"
    >
      <el-button>上右</el-button>
    </el-tooltip>
  </div>
  <div class="left">
    <el-tooltip
      class="item"
      effect="dark"
      content="Left Top 提示文字"
      placement="left-start"
    >
      <el-button>左上</el-button>
    </el-tooltip>
    <el-tooltip
      class="item"
      effect="dark"
      content="Left Center 提示文字"
      placement="left"
    >
      <el-button>左邊</el-button>
    </el-tooltip>
    <el-tooltip
      class="item"
      effect="dark"
      content="Left Bottom 提示文字"
      placement="left-end"
    >
      <el-button>左下</el-button>
    </el-tooltip>
  </div>

  <div class="right">
    <el-tooltip
      class="item"
      effect="dark"
      content="Right Top 提示文字"
      placement="right-start"
    >
      <el-button>右上</el-button>
    </el-tooltip>
    <el-tooltip
      class="item"
      effect="dark"
      content="Right Center 提示文字"
      placement="right"
    >
      <el-button>右邊</el-button>
    </el-tooltip>
    <el-tooltip
      class="item"
      effect="dark"
      content="Right Bottom 提示文字"
      placement="right-end"
    >
      <el-button>右下</el-button>
    </el-tooltip>
  </div>
  <div class="bottom">
    <el-tooltip
      class="item"
      effect="dark"
      content="Bottom Left 提示文字"
      placement="bottom-start"
    >
      <el-button>下左</el-button>
    </el-tooltip>
    <el-tooltip
      class="item"
      effect="dark"
      content="Bottom Center 提示文字"
      placement="bottom"
    >
      <el-button>下邊</el-button>
    </el-tooltip>
    <el-tooltip
      class="item"
      effect="dark"
      content="Bottom Right 提示文字"
      placement="bottom-end"
    >
      <el-button>下右</el-button>
    </el-tooltip>
  </div>
</div>
</template>

<style>
  .box {
    width: 400px;

    .top {
      text-align: center;
    }

    .left {
      float: left;
      width: 60px;
    }

    .right {
      float: right;
      width: 60px;
    }

    .bottom {
      clear: both;
      text-align: center;
    }

    .item {
      margin: 4px;
    }

    .left .el-tooltip__popper,
    .right .el-tooltip__popper {
      padding: 8px 10px;
    }
  }
</style>

主題

Tooltip 組件提供了兩個(gè)不同的主題：dark和light。

通過設(shè)置effect屬性來改變主題，默認(rèn)為dark。

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

更多 Content

展示多行文本或者是設(shè)置文本內(nèi)容的格式

用具名 slot 分發(fā)content，替代tooltip中的content屬性。

<template>
  <el-tooltip placement="top">
  <template #content> 多行信息<br />第二行信息 </template>
  <el-button>Top center</el-button>
</el-tooltip>
</template>

高級(jí)擴(kuò)展

除了這些基本設(shè)置外，還有一些屬性可以讓使用者更好的定制自己的效果：

transition 屬性可以定制顯隱的動(dòng)畫效果，默認(rèn)為fade-in-linear。 如果需要關(guān)閉 tooltip 功能，disabled 屬性可以滿足這個(gè)需求，它接受一個(gè)Boolean，設(shè)置為true即可。

事實(shí)上，這是基于 Vue-popper 的擴(kuò)展，你可以自定義任意 Vue-popper 中允許定義的字段。 當(dāng)然 Tooltip 組件實(shí)際上十分強(qiáng)大，文末的 API 文檔會(huì)做一一說明。

<template>
  <el-tooltip
    :disabled="disabled"
    content="點(diǎn)擊關(guān)閉 tooltip 功能"
    placement="bottom"
    effect="light"
  >
    <el-button @click="disabled = !disabled"
      >點(diǎn)擊{{disabled ? '開啟' : '關(guān)閉'}} tooltip 功能</el-button
    >
  </el-tooltip>
</template>

<script>
  export default {
    data() {
      return {
        disabled: false,
      }
    },
  }
</script>

tooltip 內(nèi)不支持 router-link 組件，請(qǐng)使用 vm.$router.push 代替。
tooltip 內(nèi)不支持 disabled form 元素，參考MDN，請(qǐng)?jiān)?disabled form 元素外層添加一層包裹元素。

Attributes