npm 包 wiki.min.js 使用教程

阅读时长 4 分钟读完

前言

在前端开发中,经常会需要在网页中添加一些词汇或者名词的解释。这时候我们需要使用一个名为 wiki.min.js 的 npm 包。本文将详细介绍如何使用以及相关注意事项。

wiki.min.js 是什么?

wiki.min.js 是一个基于 JavaScript 的工具包,它可以快速、简单地为页面中的关键字添加说明信息。它支持多种效果,比如弹框、下拉菜单等,使用起来十分方便。

如何使用

安装

使用 npm 进行安装:

或者直接在 HTML 文件中引入:

基本使用

在 HTML 文件中,使用类名 wiki 来标识需要添加说明信息的关键字。例如:

然后在 JavaScript 文件中引入 wiki.min.js

-- -------------------- ---- -------
------ ---- ---- --------------

-- -----------
----- ---- - --- ------
  -- ----------
  ----- --------
  -- ---
  ------- -
    -
      -------- ---- ---
      ----- ------ - -------
      ---- ----
      ------ -----
    --
    -
      -------- ---- ---
      ----- ------ - -------
      ---- ----
      ------ -----
    --
  --
---

-- --
--------------

细节注意

  • result 中每一项都需要提供 keyworddesc 两个必要的属性。
  • 可以通过 mode 属性来决定效果,支持 hover(鼠标经过触发)、click(点击触发)和 text(只显示文本,不触发任何效果)三种。
  • 当需要显示图片时,可提供 image 属性,值为图片地址。
  • 在进行初始化时,也可以传入一些全局配置参数,比如 zIndex(层叠顺序)、distance(效果触发距离)、offset(距离参考元素边缘的偏移值)等。

示例代码

-- -------------------- ---- -------
--------- -----
------
  ------
    ------------------ ------------
    ------- ---------------------------------------------
    ------- -----------------------
      ----- ---- - --- ------
        ------- -
          -
            -------- ---- ---
            ----- ------ - -------
            ---- ----
            ------ -----
          --
          -
            -------- ---- ---
            ----- ------ - -------
            ---- ----
            ------ -----
          --
        --
        ----- --------
      ---

      --------------
    ---------
    -------
      ---------- -
        ------- ----- -----
        ----------- -------
      -
      ----- -
        ------ --------
        ---------------- ----------
        ------- --------
      -
    --------
  -------
  ------
    ---- ------------------
      ---
        ----
        ------- ---------------- ----------
        -
        ------- ---------------- ----------
        -
      ----
    ------
  -------
-------

结语

通过这篇文章的介绍,相信大家已经对 npm 包 wiki.min.js 有了一定的了解。它的使用非常简单,同时支持多种效果,并且具有较高的自定义能力。我们可以通过传递不同的数据源和参数来满足不同的需求。

来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/60066bcf967216659e244d1e

纠错
反馈