el-tooltip 超出宽度显示提示内容，支持自定义提示内容

小乔FEer

已于 2023-01-13 11:01:16 修改

阅读量1k

点赞数 1

文章标签： javascript 前端 vue.js

于 2023-01-13 11:00:22 首次发布

本文链接：https://blog.csdn.net/oucqsy/article/details/128670897

版权

该组件实现了超出内容区域宽度时显示Tooltip，Tooltip内容可自定义，并能根据鼠标位置调整显示位置。组件使用了ElementUI的Tooltip，并添加了额外的配置选项，如偏移量、位置和禁用状态。

摘要由CSDN通过智能技术生成

功能需求

超出内容区域宽度显示tooltip
自定义tooltip内容
tooltip位置跟随鼠标位置显示

组件源码

<template>
  <el-tooltip
    v-bind="$attrs"
    :popper-class="['ts-ellipsis-tooltip', popperClass]"
    :placement="tooltipPlacement"
    :disabled="disabled"
    :offset="tooltipOffset"
  >
    <template #content>
      <slot v-if="$slots.content" name="content" />
      <template v-else>
        {{ content || text }}
      </template>
    </template>
    <div :class="['ts-ellipsis', { 'cursor-default': !disabled && placement === 'mouse' }, textClass]" @mouseover="handleMouseover">
      <span :ref="uniqueRefName">{{ text }}</span>
    </div>
  </el-tooltip>
</template>

<script>
import { uniqueId } from 'lodash';

export default {
  props: {
    text: { // 默认显示的文本
      type: String,
      default: ''
    },
    content: { // tooltip显示内容
      type: String,
      default: ''
    },
    offset: { // 偏移量
      type: String,
      default: ''
    },
    placement: { // tooltip位置，支持mouse值，跟随鼠标位置显示
      type: String,
      default: ''
    },
    popperClass: { // tooltip class
      type: String,
      default: ''
    },
    textClass: { // text class
      type: String,
      default: ''
    },
    refName: { // 为页面文字标识（如在同一页面中调用多次组件，此参数不可重复）
      type: String,
      default: ''
    }
  },
  data() {
    return {
      uniqueRefName: '',
      disabled: true,
      tooltipPlacement: this.placement,
      tooltipOffset: this.offset
    };
  },
  created() {
    this.uniqueRefName = this.refName || uniqueId('ellipsis-');
  },
  methods: {
    handleMouseover({ offsetX }) {
      const contentRef = this.$refs[this.uniqueRefName];
      const parentWidth = contentRef.parentNode.offsetWidth;
      const contentWidth = contentRef.offsetWidth;
      if (this.placement === 'mouse') { // tooltip跟随鼠标位置显示
        this.tooltipPlacement = 'bottom-start';
        this.tooltipOffset = offsetX + 5;
      }
      this.disabled = contentWidth <= parentWidth;
    },
  }
};
</script>

<style lang="scss" scoped>
.ts-ellipsis {
  overflow: hidden;
  white-space: nowrap;
  text-overflow: ellipsis;

  &.cursor-default {
    cursor: default;
  }
}
</style>

组件调用

// placement跟随鼠标移动，其他情况和el-tooltip位置一致
<ts-ellipsis-tooltip
  popper-class="my-ellipsis-tooltip"
  text="这是显示文本"
  effect="light"
  placement="mouse"
  :open-delay="1"
>
  <template #content>
    这是tooltip内容
  </template>
</ts-ellipsis-tooltip>