有你在真好 的个人博客
前端实用工具库——轻量的纯 JavaScript 动态提示工具插件库
阅读:2399 添加日期:2021/3/27 23:16:48 原文链接:https://www.toutiao.com/item/6785369950706991623/
  • 介绍

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 动态提示工具插件库

    ICP备案号:苏ICP备14035786号-1 苏公网安备 32050502001014号