npm 包 mn-chips 使用教程

阅读时长 4 分钟读完

如果你正在开发一个前端应用,你可能需要添加一个类似 Gmail 的功能。其中,用户可以通过添加文本块来形成标签。这种功能在前端方面比较常见。开发这样的功能需要从头写一些代码,劳逸结合,有没有省事的工具呢?对,就是 npm 包 mn-chips。在本文中,我们将会介绍如何从安装到使用这个 npm 包,以及如何在自己的代码中使用这个包。

安装

mn-chips 是一个 npm 包,所以,首先要安装 node.js 和 npm。安装 node.js 和 npm 的这一步,不需要在这篇文阐述,参见 官网

接下来,我们可以在终端上使用 npm 安装 mn-chips 包,安装命令如下:

安装完成后,我们可以在项目中的 package.json 文件中看到 mn-chips:

使用

首先,我们在项目中引入 mn-chips:

基本用法

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

在这个例子中,我们使用构造函数创建 Chips 实例,并指定其父容器的 CSS 选择器 '#chips_wrapper' 和一些可选参数。我们还在 Chips 实例上注册了两个事件处理程序。

配置选项

其中,你可以看到,我们使用了 focusOnCreated: false。这意味着即使 Chips 焦点在创建后不会自动聚焦。再看一个例子:

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

在这个例子中,我们使用了许多选项。你会发现,这个例子使用了更多的选项:

  • placeholder: 文本框为空时的提示信息
  • label: 文本框整个 Label 中的文本
  • secondaryPlaceholder: 当文本框为空且标签已经存在时的文本
  • data: 初始时可接受 tag 和可以拥有 image 的数据

事件处理程序

请注意,我们在 Chips 实例上注册了几个事件处理程序。这些处理程序可能包括:

  • chips-focus: 每当焦点在 chips 上时触发
  • chips-blur: 每当焦点从 chips 上移开时触发
  • chips-add: 每当添加新标签时触发
  • chips-remove: 在从 chips 中删除标记时每次触发
  • chips-select: 选择标签时每次触发
  • chips-change: 更改标记时每次触发

结论

现在你知道了如何安装和使用 npm 包 mn-chips ,以及如何在自己的代码中使用它。也就是说,您不再需要从头开始编写 JavaScript。提示:在购买这样的方式之前,请务必查看 NPM 包 mn-chips 的文档,这样您就可以深入了解其功能和支持的选项。

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

纠错
反馈