umer936/multi-emails-input

该软件包最新版本(v1.1)没有可用的许可证信息。

multi-emails-input 是一个将 div 转换为多电子邮件输入的小型库

安装: 41

依赖关系: 0

建议者: 0

安全性: 0

星星: 0

关注者: 1

分支: 2

语言:JavaScript

v1.1 2024-03-21 21:04 UTC

This package is auto-updated.

Last update: 2024-09-21 22:17:27 UTC


README

multi-emails-input 是一个将 div 转换为多电子邮件输入的小型库,基本上如果你有任何 div 并且想将其转换为多电子邮件输入,这个库是做这件事的最佳选择。

该库是用纯 JavaScript 编写的,如果需要,可以转换为 npm 软件包。

如何使用?

您可以从将 JavaScript 文件添加到 HTML 开始。

<script src="<PATH_TO_LIB>/emails-input.js"></script>

同时将 CSS 文件添加到您的 head 标签中

<link rel="stylesheet" src="<PATH_TO_LIB>/emails-input.css" />

您可以使用提供的函数将 div 选择器包装起来,如下所示

<div id="emails-input"></div>
<script>
  const inputContainerNode = document.querySelector('#emails-input');
  const emailsInput = EmailsInput(inputContainerNode);
</script>

这将把普通的 div 转换为多电子邮件输入容器。

特性

  • 可以通过按下 Enter 键、输入逗号 , 或通过在输入字段上失去焦点 blur 事件来创建电子邮件块。
  • 可以通过每个块中的 X 符号删除一个块。
  • 粘贴的电子邮件将立即转换为块。(例如,“max@mail.ruivan@mail.ru”)它们应该转换为多个块。
  • 无效的电子邮件不会添加到返回的列表中。
  • 重复的电子邮件有不同的样式以供识别,并可被删除。
  • EmailsInput 函数,如上例所示,返回一个包含 2 个元素的对象
    • getEmailsList:一个函数,返回一个包含有效电子邮件的数组,如元素所示。
    • addEmail:一个函数,您可以发送一个电子邮件,并将其添加到列表中。
  • 所有代码都提供了 JSDOC,这有助于确定类型。
  • 该库已过测试,在所有浏览器上均运行正常,包括 ie11

选项

  • limitEmailsToDomain:是一个选项,用于定义哪些电子邮件是有效的,哪些不是,例如,如果您将此选项提供为 gmail,则除了 gmail 之外的所有电子邮件都将被视为无效。
  • invalidEmailClass:是一个选项,用于提供无效电子邮件的不同类,以覆盖默认样式,如果用户需要的话。
  • validEmailClass:是一个选项,用于提供有效电子邮件的不同类,与无效的类似。
  • 示例
const emailsInput = EmailsInput(inputContainerNode, {
  limitEmailsToDomain: 'gmail',
  invalidEmailClass: 'custom-invalid-email',
  validEmailClass: 'custom-valid-email',
});