前端实用工具库——轻量的纯 JavaScript 动态提示工具插件库

JavaScript/前端
387
0
0
2022-03-28
标签   JavaScript库
  • 介绍

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

前端实用工具库——轻量的纯 JavaScript 动态提示工具插件库

Github

//文档:https://atomiks.github.io/tippyjs/
//Github: https://github.com/atomiks/tippyjs

功能特性

前端实用工具库——轻量的纯 JavaScript 动态提示工具插件库

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

  • 智能定位引擎

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

  • 高性能

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

  • 多功能

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

  • 无障碍

兼容WAI-ARIA

  • 主题化的

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

  • 插件化

使用插件增强功能

  • 轻量级

最小化包的大小

  • Typescript的支持

开箱即用的TypeScript支持

  • 支持IE11 +

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

默认示例

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

前端实用工具库——轻量的纯 JavaScript 动态提示工具插件库

<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进行任何自定义样式,本身提供了以下几个主题可供选择

light

light-border

material

translucent

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

总结

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

前端实用工具库——轻量的纯 JavaScript 动态提示工具插件库