• 介绍

Tippyjs轻量的纯 JavaScript 动态提示工具插件库。它提供了大量的不同悬停效果和超过 20 个可定制的选项。Tippy.js 是超级轻量的，具有相当不错的浏览器兼容性：

Github

//文档：https://atomiks.github.io/tippyjs/

//Github： https://github.com/atomiks/tippyjs

功能特性

Tippy.js是由Popper.js支持的高度可定制的工具提示和弹出库。

• 智能定位引擎

优化的定位引擎，可防止翻转和溢出

• 高性能

在低端设备也能够保持很高的性能

• 多功能

适用于鼠标，键盘和触摸输入

• 无障碍

兼容WAI-ARIA

• 主题化的

通过自定义CSS样式，包括额外的主题和动画

• 插件化

使用插件增强功能

• 轻量级

最小化包的大小

• Typescript的支持

开箱即用的TypeScript支持

• 支持IE11 +

与99％的台式机和97％的移动用户兼容

默认示例

它具有#333的背景色和指向该元素的箭头，并且由鼠标输入或焦点事件触发，因此它会在悬停时显示，通过键盘导航聚焦或在使用触摸设备时轻击。

<button id="myButton">My Button</button>

tippy('#myButton', {
  content: "I'm a Tippy tooltip!"
});

安装

常用npm或者yarn安装使用

# npm
npm i tippy.js

# Yarn
yarn add tippy.js

import tippy from 'tippy.js';
import 'tippy.js/dist/tippy.css';

使用

• 创建tooltips

给在你想要的标签元素上添加data-tippy-content属性

<button data-tippy-content="Tooltip">Text</button>
<button data-tippy-content="Another Tooltip">Text</button>

或者

tippy('#singleElement', {
  content: 'Tooltip'
});

• 自定义

tippy('button', {
  duration: 0,
  arrow: false,
  delay: [1000, 200]
});

也可以指定特定的属性

<button
  data-tippy-duration="0"
  data-tippy-arrow="false"
  data-tippy-delay="[1000, 200]"
>
  Text
</button>

• HTML Content

内容道具可以接受字符串，元素或函数。

普通字符串：

tippy('button', {
  content: '<strong>Bolded content</strong>'
});

innerHtml：

<div id="template" style="display: none;">
  <strong>Bolded content</strong>
</div>

const template = document.getElementById('template');

tippy('button', {
  content: template.innerHTML
});

element:

可以传递元素本身，这对于使事件侦听器保持连接状态（或在框架控制内部元素时非常有用）

const template = document.getElementById('example');
template.style.display = 'block';

tippy(singleButton, {
  content: template
});

Template linking:

如果您有多个引用，每个引用都有其自己的唯一模板，则可以通过以下方式将它们链接到关联的模板：

<button data-template="one">One</button>
<button data-template="two">Two</button>
<button data-template="three">Three</button>

<div style="display: none;">
  <div id="one">
    <strong>Content for `one`</strong>
  </div>
  <div id="two">
    <strong>Content for `two`</strong>
  </div>
  <div id="three">
    <strong>Content for `three`</strong>
  </div>
</div>

tippy('button', {
  content(reference) {
    const id = reference.getAttribute('data-template');
    const template = document.getElementById(id);
    return template.innerHTML;
  }
});

主题Themes

可以通过CSS进行任何自定义样式，本身提供了以下几个主题可供选择

tippy('button', {
  theme: 'light'
});

总结

具体的使用方式还是具体的样式，都可以直接参照官方文档，个人认为这是独立组件中非常不错的一个小组件，enjoy it！