@mdui/jq/functions/removeData.js

拥有和 jQuery 相似 API 的轻量级 JavaScript 工具库

import { removeAll, removeMultiple } from '../shared/data.js';
import { isUndefined, isString } from '../shared/helper.js';
/**
 * 移除指定元素上存放的数据
 * @param element 存放数据的元素
 * @param name
 * 数据键名
 *
 * 若未指定键名，将移除元素上所有数据
 *
 * 多个键名可以用空格分隔，或者用数组表示多个键名
  @example
```js
// 移除元素上键名为 name 的数据
removeData(document.body, 'name');
```
 * @example
```js
// 移除元素上键名为 name1 和 name2 的数据
removeData(document.body, 'name1 name2');
```
 * @example
```js
// 移除元素上键名为 name1 和 name2 的数据
removeData(document.body, ['name1', 'name2']);
```
 * @example
```js
// 移除元素上所有数据
removeData(document.body);
```
 */
export const removeData = (element, name) => {
    if (isUndefined(name)) {
        return removeAll(element);
    }
    const keys = isString(name)
        ? name.split(' ').filter((nameItem) => nameItem)
        : name;
    removeMultiple(element, keys);
};