- **browser** `- Object 浏览器检测信息`
npm install @o2oa/util- Object 浏览器检测信息
- Function 生成uuid
- Function 检查变量类型
- Function 通过嵌入 script 标签，执行js脚本
- Function 执行代码片段, 使用Function包装
- Function 延时调用函数。有些方法只需要调用一次，但有可能在短时间内被多次触发时使用
- Function 将文本内容拷贝到剪切板, 返回Promise, 如果剪贴板的内容被更新，它就会resolve，如果无法写入，则reject
- Function 对HTML文本进行编码
- Function 对编码后的HTML文本进行解码
- Function 过滤掉html中的javascript脚本内容，防止javascript注入
- Function 深度克隆一个Json对象，!!!不要传入javascript对象!!!
- Function 合并多个JSON对象，传入要合并的多个JSON对象，并返回一个新的JSON对象。 !!!不要传入javascript对象!!!
- Function 创建标签在新浏览器窗口中打开url，防止浏览器禁止弹出窗口
- Function 将用 - 分隔的字符串，转换驼峰拼写格式
- Function 将驼峰命名字符串转换为用 - 分隔每个单词
- Function 清除给定字符串的多余空字符
- Function 将字符串首字母大写
- async Function 传入多个promise，并行处理，等价与Promise.all
- Function 传入一个对象或map，返回第一个值为true的 key
- Function 判断传入的对象是否是可迭代对象
- Function 判断传入的对象是否是Promise
- Function 计算一个字符串所占的字节数
- Function 第二个参数为异步函数，返回函数的返回值，并为node元素添加loading样式
- Function 将json对象转换为css文本，json的key为选择器
- Function 在arr中删除所有值等于value的元素，直接修改arr
- Function 在arr中删除所有值等于value的元素，如果value是function，则使用findIndex，将value作为执行函数找到要删除元素的索引，直接修改arr
- Function 获取两个数组中的交集元素
- Function 获取两个数组中, A数组相对于 B数组的补集。(在 B中存在，但 A中不存在的元素)
- Function 判断一个字符串，是否是o2oa组织的distinguishedName，并判断类型。返回类型：I(身份)、P(个人)、U(组织)、G(群组)、R(角色)、UD(职务)、UA(组织属性)、PA(个人属性)、unknown
- Function 返回distinguishedName的简称
javascript
import {dom} from '@o2oa/util';
const el = dom('div#myid.classname', {
"data-o2-attr": "div元素的自定义属性"
});
document.body.append(el);
dom.addClass('input#id', 'newClassname');
//...
`
- dom.el ( selector, [el] ) : Element
- 此方法返回文档中与指定选择器或选择器组匹配的第一个 Element对象。如果找不到匹配项，则返回null。（同document.querySelector或Element.querySelector方法）
- dom.els ( selector, [el] ) : NodeList
- 此方法返回与指定的选择器组匹配的文档中的元素列表 (使用深度优先的先序遍历文档的节点)。返回的对象是 NodeList 。（同document.querySelectorAll或Element.querySelectorAll方法）
- dom.addClass ( el, className ) : Element
- 为一个Element添加class属性值
- dom.removeClass ( el, className ) : Element
- 为一个Element删除一个class属性值
- dom.hasClass ( el, className ) : boolean
- 判断一个Element的class属性中是否有指定的值
- dom.toggleClass ( el, className, [force=false] ) : Element
- 换一个Element的class属性值。如果有指定属性值，则删除它；如果没有指定属性值，则添加它。
- dom.checkClass ( el, className, check ) : Element
- 根据check的值(true 或 false)，决定为Element元素添加或删除指定的className
- dom.set ( el, key, [value] ) : Element
- 给目标Element设置属性
- dom.get ( el, key ) : string
- 获取目标Element的属性值
- dom.getScroll ( el) : object
- 获取目标Element滚动的距离
- dom.getOffsetParent ( el ) : Element
- 获取包含目标Element的最近的上级定位元素
- dom.getPosition ( el, [relative] ) : object
- 获取目标Element的位置
- - dom.setPosition ( el, positions ) : Element
- 设置目标Element的位置。（left和top）
- dom.getSize ( el ) : object
- 获取目标元素的大小
- dom.getScrollSize ( el ) : object
- 获取目标元素的大小，包括由于 overflow 溢出而在屏幕上不可见的内容。
- dom.getStyle ( el, key ) : string
- 获取目标元素计算后的样式值。
- dom.getStyles ( el, key... ) : object
- 获取目标元素计算后的多个样式值。
- dom.setStyle ( el， key, value ) : Element
- 给目标Element设置css样式。
- dom.setStyles ( el, styles ) : Element
- 给目标Element设置多个css样式。
- dom.isPositioned ( el ) : boolean
- 判断目标元素是否是一个定位元素。
- dom.show ( el ) : Element
- 设置目标元素可见。
- dom.hide ( el ) : Element
- 设置目标元素隐藏。
- dom.getParentSrcollNode ( el ) : Element
- 获取包含目标元素的可滚动元素。
- dom.getParent ( el, [match] ) : Element
- 获取目标元素符合匹配条件的最近上级元素。
- dom.isDisplayNone ( el) : Element
- 判断当前元素及其父元素的display是否为none。
日期时间操作
- cloneDate ( date ) : Date
- 克隆日期
- lastDayOfMonth ( year, month ) : Date
- 传入年和月(1~12)，获取对应月份的最后一天。
- lastTimeOfMonth ( year, month ) : Date
- 传入年和月(1~12)，获取对应月份的最后一天，时间为最后一秒。
- lastTimeOfDate ( date, isClone ) : Date
- 传入日期，获取对应日期的最后一刻。
- clearTime ( date, isClone ) : Date
- 传入日期，清除时间。
- increment ( date, interval , times ) : Date
- 传入日期，增加times个单位。interval可以为 year, month, week, day, hour, minute, second, and ms
- formatDate ( date, format ) : String
- 将日期时间格式化为指定的格式，并返回格式化后的字符串。
`javascript
{Date} date 需格式化日期
{String} format 格式化字符串，如 YYYY-MM-DD HH:mm:ss
Y - 年份
M - 月份
D - 日期
H - 小时（24 小时制）
h - 小时（12 小时制）
m - 分
s - 秒
q - 季度
S - 毫秒
a - 上午/下午
A - AM/PM
const date = new Date();
formatDate(date, 'YYYY-MM-DD HH:mm:ss'); // 2023-02-16 08:25:05
formatDate(date, 'YYYY年MM月DD日 HH:mm:ss'); // 2023年02月16日 08:25:05
formatDate(date, 'YYYY-MM-DD HH:mm:ss S'); // 2023-02-16 08:25:05 950
formatDate(date, 'YYYY-MM-DD HH:mm:ss A'); // 2023-02-16 08:25:05 上午
`
- isIntersect ( rangeA, rangeB, ignoreBoundary ) : Boolean
- 传入数组[日期1开始时间，日期1结束时间]，[日期2开始时间，日期2结束时间]，是否忽略边界。返回日期1和日期2是否相交。
`javascript
const date1Start = new Date('2000-01-01 00:00:00');
const date1End = new Date('2000-01-01 23:59:59');
const date2Start = new Date('2000-01-01 23:00:00');
const date2End = new Date('2000-01-02 23:59:59');
const flag = isIntersect([date1Start, date1End], [date2Start, date2End]); //返回true
``