@wordpress/token列表

可构造的普通JavaScriptDOMTokenList(DOM令牌列表)实现,支持非浏览器运行时。

安装

安装模块

npm安装@wordpress/token-list

此包假定您的代码将在2015年+环境。如果您使用的环境对此类语言功能和API的支持有限或不支持,您应该包括polyfill发货@wordpress/babel预设在代码中。

用法

构造一个新的令牌列表,可以选择初始值。返回接口与DOMTokenList匹配的值。

从“@wordpress/token-list”导入TokenList;const tokens=新TokenList('abc def');tokens.add('ghi');tokens.remove(“def”);tokens.replace('abc','xyz');console.log(tokens.value);//“xyz ghi”

全部DOMTokenList的方法已实现。

请注意,以下实现与规范:

  • TokenList#支持将始终返回true,而不管传递的令牌是什么。
  • 令牌列表#add删除令牌列表#将忽略标记参数的空字符串参数或空白,而不是抛出错误.
  • 项不能被其索引作为属性引用。使用TokenList#项目而不是。

浏览器支持

虽然它可以在实现中使用,但它并不打算用作元素#classList或其他实例DOMTokenList(DOM令牌列表).

实施DOMTokenList(DOM令牌列表)通过提供的接口@wordpress/token列表在支持ES5(IE8及更新版本)的环境中广泛兼容。这就是说,由于其内部实施利用阵列TokenList#条目,每个的令牌列表号,TokenList#键,以及TokenList#值,如果您打算使用这些函数,则可能需要确保这些函数得到支持或被polyfilled填充。

  • https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/entries#Browser_compatibility
  • https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/values#Browser_compatibility

TokenList自己的内部实现DOMTokenList(DOM令牌列表)接口并没有利用这些函数中的任何一个,所以不需要为基本用法聚合它们。

参与此包

这是古腾堡项目的一部分。该项目组织为单回购。它由多个独立的软件包组成,每个包都有特定的用途。此monorepo中的包发布到净现值并由使用WordPress(文字出版社)以及其他软件项目。

要了解更多关于对这个包或古腾堡整体贡献的信息,请阅读该项目的主要内容投稿人指南.