Vue元件之Tooltip

答案在風中飄著發表於2017-10-17

前言

本文主要Alert 元件的大致框架, 提供少量可配置選項。 旨在大致提供思路

tooltip

常用於展示滑鼠 hover 時的提示資訊。

模板結構

<template>
  <div style="position:relative;">
    <span ref="trigger">
      <slot>
      </slot>
    </span>
    <div class="tooltip"
      v-bind:class="{
        `top`:     placement === `top`,
        `left`:    placement === `left`,
        `right`:   placement === `right`,
        `bottom`:  placement === `bottom`,
        `disable`: type === `disable`,
        `delete`:  type === `delete`,
        `visible`: show === true  
      }"
      ref="popover"
      role="tooltip">
      <div class="tooltip-arrow"></div>
      <div class="tooltip-inner">
        <slot name="content" v-html="content"></slot>
      </div>
    </div>
  </div>
</template>

大致結構DOM結構 一個div 包含 箭頭 及 氣泡內容。

v-bind中可選tooltip位置,是否禁用,及顯示隱藏

slot 差值供自定義 預設接收content內容

script

import EventListener from `../utils/EventListener.js`;

export default {
  props: {
    // 需要監聽的事件
    trigger: {
      type: String,
      default: `click`
    },
    effect: {
      type: String,
      default: `fadein`
    },
    title: {
      type: String
    },
    // toolTip訊息提示
    content: {
      type: String
    },
    header: {
      type: Boolean,
      default: true
    },
    placement: {
      type: String
    }
  },
  data() {
    return {
      // 通過計算所得 氣泡位置  
      position: {
        top: 0,
        left: 0
      },
      show: true
    };
  },
  watch: {
    show: function(val) {
      if (val) {
        const popover = this.$refs.popover;
        const triger = this.$refs.trigger.children[0];
        // 通過placement計算出位子
        switch (this.placement) {
          case `top` :
            this.position.left = triger.offsetLeft - popover.offsetWidth / 2 + triger.offsetWidth / 2;
            this.position.top = triger.offsetTop - popover.offsetHeight;
            break;
          case `left`:
            this.position.left = triger.offsetLeft - popover.offsetWidth;
            this.position.top = triger.offsetTop + triger.offsetHeight / 2 - popover.offsetHeight / 2;
            break;
          case `right`:
            this.position.left = triger.offsetLeft + triger.offsetWidth;
            this.position.top = triger.offsetTop + triger.offsetHeight / 2 - popover.offsetHeight / 2;
            break;
          case `bottom`:
            this.position.left = triger.offsetLeft - popover.offsetWidth / 2 + triger.offsetWidth / 2;
            this.position.top = triger.offsetTop + triger.offsetHeight;
            break;
          default:
            console.log(`Wrong placement prop`);
        }
        popover.style.top = this.position.top + `px`;
        popover.style.left = this.position.left + `px`;
      }
    }
  },
  methods: {
    toggle() {
      this.show = !this.show;
    }
  },
  mounted() {
    if (!this.$refs.popover) return console.error("Couldn`t find popover ref in your component that uses popoverMixin.");
    // 獲取監聽物件
    const triger = this.$refs.trigger.children[0];
    // 根據trigger監聽特定事件
    if (this.trigger === `hover`) {
      this._mouseenterEvent = EventListener.listen(triger, `mouseenter`, () => {
        this.show = true;
      });
      this._mouseleaveEvent = EventListener.listen(triger, `mouseleave`, () => {
        this.show = false;
      });
    } else if (this.trigger === `focus`) {
      this._focusEvent = EventListener.listen(triger, `focus`, () => {
        this.show = true;
      });
      this._blurEvent = EventListener.listen(triger, `blur`, () => {
        this.show = false;
      });
    } else {
      this._clickEvent = EventListener.listen(triger, `click`, this.toggle);
    }
    this.show = !this.show;
  },
  // 在元件銷燬前移除監聽,釋放記憶體
  beforeDestroy() {
    if (this._blurEvent) {
      this._blurEvent.remove();
      this._focusEvent.remove();
    }
    if (this._mouseenterEvent) {
      this._mouseenterEvent.remove();
      this._mouseleaveEvent.remove();
    }
    if (this._clickEvent) this._clickEvent.remove();
  }
};
// EventListener.js
const EventListener = {
  /**
   * Listen to DOM events during the bubble phase.
   *
   * @param {DOMEventTarget} target DOM element to register listener on.
   * @param {string} eventType Event type, e.g. `click` or `mouseover`.
   * @param {function} callback Callback function.
   * @return {object} Object with a `remove` method.
   */
  listen(target, eventType, callback) {
    if (target.addEventListener) {
      target.addEventListener(eventType, callback, false);
      return {
        remove() {
          target.removeEventListener(eventType, callback, false);
        }
      };
    } else if (target.attachEvent) {
      target.attachEvent(`on` + eventType, callback);
      return {
        remove() {
          target.detachEvent(`on` + eventType, callback);
        }
      };
    }
  }
};

export default EventListener;

封裝的事件監聽

使用

使用content屬性來決定hover時的提示資訊。由placement屬性決定展示效果:placement屬性值為:方向-對齊位置;四個方向:topleftrightbottomtrigger屬性用於設定觸發tooltip的方式,預設為hover

<d-tooltip content="我是tooltip">
  <d-button type="text">滑鼠移動到我上面試試</d-button>
</d-tooltip>
<d-tooltip content="我是tooltip" trigger="click">
  <d-button type="text">點我試試</d-button>
</d-tooltip>

content內容分發

設定一個名為contentslot

<d-tooltip>
  <d-button type="text">滑鼠移動到我上面試試</d-button>
  <p slot="content" class="tooltip-content">我是內容分發的conent。</p>
</d-tooltip>

Attributes

引數 說明 型別 可選值 預設值
content 顯示的內容,也可以通過 slot#content 傳入 DOM String
placement Tooltip 的出現位置 String top/right/bottom/left top
trigger tooltip觸發方式 String hover

相關文章