OtherUtils 其他工具函数

utils工具函数中许多无法归类，将全部在本页列举。

阻止默认事件，比如点击a标签应该跳转，使用该函数可禁止默认跳转。

完整写法：axPreventDefault(event)，参数说明如下：

• event:必填项，通常为window对象。

举例：无。

对象不存在报错并直接返回，不再继续执行。

完整写法：axCreateId(prefix, type, elem)，可简写为：axCreateId(prefix)，参数说明如下：

• prefix:必填项，文本前缀。
• type:选填项，可以填数字，也可以填'id'，如果不填该函数将以时间戳创建字符串；如果elem存在并且该参数填'id'，那么将返回该元素id值。
• elem:可以填"#id"、".className"、"div"等原生选择器以及Dom对象。

举例：axCreateId('ax', 10)。可能返回：'ax-9kjherwd45'（10位随机字符）

该函数让节点内使用滚轮却不滚动页面的滚动条，常用于窗口。

完整写法：axPreventScroll(preventDom, scrollDom)，可简写为：axPreventScroll(preventDom)，参数说明如下：

• preventDom:必填项，父节点，可以填"#id"、".className"、"div"等原生选择器以及Dom对象。
• scrollDom:选填项，子节点，可以填"#id"、".className"、"div"等原生选择器以及Dom对象。如果不填，将作用域父节点。

举例：axPreventScroll('#parent', '#child') ，该例子在#child元素中可使用滚动条，但是页面的滚动条不会滚动。

该函数是本框架所使用的模板引擎。

完整写法：axTplEngine(html, data)，参数说明如下：

• html:必填项，带变量的字符串，变量或js代码用'<#'和'#>'包裹，变量使用this.*方式引用。
• data:选必填项，支持html渲染内容的参数对象。

举例：axTplEngine(`<div><#' this.country '#></div>`, {country:' china'}) ，该例子将返回字符串：<div>china</div>。

该函数可以让数组进行完全排列组合，返回新数组。

完整写法：axArrange(origin, n)，参数说明如下：

• origin:必填项，原始字符串
• n:必填项，数组维度length。

举例：axArrange('man', 2) ，该例子将返回[['m','a'],['m','n'],['a','n']]。

该函数可以创建矢量动画结果效果。

完整写法：axResult(elem, state)，参数说明如下：

• elem:必填项，现有子节点对象，可以填"#id"、".className"、"div"等原生选择器以及Dom对象。
• state:必填项，可以填success、error、question和info。

举例：axResult('#demo', 'success') ，该例子将在#demo元素创建一个成功结果动画。

该函数用来创建窗口主体内容，专属用于dialog、drawer和popup插件。

完整写法：axCreateContent(options, instance, type,callback)，参数说明如下：

• options:必填项，dialog、drawer或popup插件的options。
• instance:必填项，dialog、drawer或popup插件的实例本身，通常为this。
• type:选填项，异步提交的方式，默认post，可填get。
• callback:选填项，回调函数。

该函数用来创建窗口底部内容，专属用于dialog、drawer和popup插件。

完整写法：axFooterBtns(options, instance)，参数说明如下：

• options:必填项，dialog、drawer或popup插件的options。
• instance:必填项，dialog、drawer或popup插件的实例本身，通常为this。

该函数可以将任意时间转成本地时间戳。

完整写法：axLocalTime(date, utc)，参数说明如下：

• date:必填项，日期，格式可以是"YYYY-MM-DD" 或 "YYYY/MM/DD"。
• utc:选填项，所填时间是否是utf时间，可填true或false。true和false的时间转换结果会相差8个小时

举例：axLocalTime('2022-2-12')，该例子将返回时间戳：1644595200000。

该函数用于点击提交表单校验。

完整写法：axValidRepeat(e, outer, callback, optons={data:axValids,interval : 100})，参数说明如下：

• e:必填项，通常是window。
• outer:必填项，表单项的父层，可以是form节点，也可以是某div节点，但是必须与表单项的父节点一致，所以建议是form节点。
• callback:选填项，校验成功后执行回调函数。
• options:选填项，参数，有两个参数如下：
• data:必填项，数组数据，格式为：[{parent:'',children:{name:'',verified:'',text:''}},{}]；默认为axValids即当页的所有校验数据。
• interval:必填项，表单项校验的间隔时间，纯是为了显示逐个校验效果，默认100毫秒。

举例：略。

该函数封装了原生cookie方法，支持cookie的写入、读取和删除。

写入cookie，完整写法：axCookie.set(name, value, {type:'day',expires:365})

读取cookie，完整写法：axCookie.get(name)

删除cookie，完整写法：axCookie.remove(name)

set的options参数说明如下。

• type:选填项，以什么单位过期，可选择second或s，minite或m，hour或h，day或d，默认day。
• expires:选填项，过期时间，与type对应使用，默认365；可以填具体日期字符串
• path:选填项，cookie有效范围，与原生cookie方法一致。
• domain:选填项，cookie的作用域，与原生cookie方法一致。
• secure:选填项，使用通过HTTPS传递cookie，与原生cookie方法一致。
• sameSite:选填项，是否禁止第三方获取cookie，与原生cookie方法一致。

举例：axCookie.set('myname':'AXUI',{path:'/'})，该例子设置myname=AXUI的cookie，并对全站有效。

该函数封装了原生localstorage方法，支持数据的写入、读取和删除。

写入数据，完整写法：axLocalStorage.set(key, value, {type:'day',expires:365})

• key:必填项，属性名。
• value:必填项，属性值，可以是数字、字符串、数组或对象，需要注意：函数或DOM节点将被忽略。
• type:选填项，以什么单位过期，可选择second或s，minite或m，hour或h，day或d，默认day。
• expires:选填项，过期时间，与type对应使用，默认0（永不过期，直到清除浏览器缓存或手动删除）；可以填具体日期字符串。

读取数据，完整写法：axLocalStorage.get(key)，key是指属性

删除数据，完整写法：axLocalStorage.remove(key)，key可以是单个属性（单个删除）也可以是属性数组（批量删除）

找到键值，完整写法：axLocalStorage.key(num)，num是指第几个属性

清空数据，完整写法：axLocalStorage.clear()

举例：axLocalStorage.set('myname':'AXUI')，该例子设置myname=AXUI的数据。

防抖函数通用用于keyup事件上，使用表现为：持续键入后停留一段时间才执行keyup事件。

完整写法：axDebounce(fun, delay)，参数说明如下：

• fun:必填项，执行函数。
• delay:选填项，延迟时间，单位毫秒，默认200。

举例：略。

节流函数通用用于click事件上，使用表现为：连续快速点击多次也只会执行一次。

完整写法：axThrottle(fun, interval)，参数说明如下：

• fun:必填项，执行函数。
• interval:选填项，间隔时间，单位毫秒，默认200。

举例：略。

数组元素移动函数，在数组内可将某元素自由移动，返回原数组。

完整写法：axMoveArr(arr, from,to)，参数说明如下：

• arr:必填项，操作的数组对象。
• from:必填项，将要移动的数组索引值。
• to:必填项，将要落脚的位置索引值。

举例：略。

用于数组排序，支持一维数组（list）和带children属性的二维数组（table）。

完整写法：axSort(data, sorts, type)，参数说明如下：

• arr:必填项，操作的数组对象。
• sorts:必填项，排序方式，支持以下格式：
• 带attr属性的对象数组，col可以是数字或字符串，适用于table类型数据，例如：[{ col: 'age', attr:'label',order: 'desc' }...]
• 不带attr属性的对象数组，col通常是字符串，适用于一维数据，例如：[{ col: 'age',order: 'desc' }...]
• 带attr属性的对象，col可以是数字或字符串，适用于table类型数据，例如：{ col: 'age', attr:'',order: 'desc' }
• 不带attr属性的对象，col通常是字符串，适用于一维数据，例如：{ col: 'age',order: 'desc' }
• type:选填项，用于哪种数据类型，默认是一维数组（axList类型），可填table表示数据类型是axSheet类型

举例：略。

用于设置cookie和localstorage的过期时间，返回到期时间（国标时间格式，非本地时间格式）。

完整写法：axExpires(type,expires)，参数说明如下：

• type:必填项，设置时间的类型，字符类型，可设置s、m、h、d，也即使秒、分、时、日；默认是d
• expires:必填项，设置多久后过期，数字类型或日期字符串，与type对应使用，如果type是d，expires是2，则表示2天后过期；如果填写的是一个日期字符串则type参数无效。

举例：略。

用于设置获取字符之前和之后的字符串片段。

完整写法：axStrEnd (str, key, type, inside)，参数说明如下：

• str:必填项，字符串
• key:必填项，分割字符串的字符，可是一个字符也可以是多个字符。
• type:选填项，可填beforebegin（从左往右找）、afterbegin（从左往右找）、beforeend（从右往左找）和afterend（从右往左找），默认afterend。
• inside:选填项，返回的结果是否包含key字符，默认true包含，可选择false不包含。

如果str为空或key为空返回false；type是其他内容，返回空字符串。

用于根据不同格式的值从数组中找出一个对象。

完整写法：axFindItem(obj, data,map)，参数说明如下：

• obj:必填项，将要检索的内容，可以是普通字符串、带#的字符串、数字、DOM节点、{id:''}单key对象或{id:'',label:'',heder:''}多key对象/[]对象
• data:必填项，将要检索的数据源。
• map:选填项，属性映射；默认map={string:'label',number:'id',dom:'headerDom'},也就是说如果obj是一个字符串那么，那么将从data中label属性查找匹配（完全匹配）。

如果obj=1，将从data中找到id===1的项，如果没有对应的属性则取索引；如果obj='china'，将从data中找到label==='china'的项；如果obj='#one'，将从data中找到dom的id属性为'one'的项；如果obj是一个DOM节点，将从data中找到dom===obj的项；如果obj是一个对象({}/[])，将从data直接找到对应项。

举例：略。

根据多个关键字从数据组查找并获得新数组。新数组每一项包含的属性有：source数据源、weight关键字权重和keys包含的关键字

完整写法：axArrSearch (keys, props, source, options)，参数说明如下：

• keys:必填项，将要检索的关键字，可以是单个字符串，带分隔符的字符串或字符串数组
• props:必填项，将要检索的数组对象中的属性，可以是单个字符串，带分隔符的字符串（强制英文逗号）或字符串数组。
• source:必填项，数据源数组。
• options:选填项，检索参数，支持以下属性：
• fuzzy:模糊匹配方式，默认为true以获得尽可能多的数据，可使用false为精确匹配以获得尽可能少的数据
• separator:关键字字符串的分隔符，默认是空格
• max:最多输出数据的length值，超过将被截掉。
• reorder:是否对检索结果按权重排序，默认true，可选择false不排序
• ignore:是否忽略英文大小写，默认true忽略，可选择false不忽略

举例：略。