delay
@description 生产延迟执行函数,用于防止高频函数执行
@param {function} func - 需要执行的函数
@param {number} wait - 延迟执行的时间,单位为毫秒,默认为 300 毫秒
@returns {function} 返回处理过的函数
getJSONprop
@description 获取元素的属性,并进行格式化
@param {jquery element} $ele - 元素
@param {string} name - 属性名
@returns {object|number|bool|undefined} 返回格式化后的属性,如果返回 undefined 表示获取失败
jsonAttr
@description 将一个json对象存入属性
@param {jquery element} $ele - 元素
@param {string} name - 属性名
@param {object} value - 需要存入的对象
@returns {object} 返回存入的对象
serialize
将对象转换为url查询参数
data 需要转化为查询参数的对象
escapeHtml
@description 转译一段字符串
@param {string} str - 需要转译的字符串
@returns {string} 返回转译完成的字符串
unescapeHtml
@description 反转译一段字符串
@param {string} str - 需要反转译的字符串
@returns {string} 返回反转译完成的字符串
encodeHTMLSource
@description 编码HTML代码字符串
@param {string} code - 需要编码的HTML代码字符串
@returns {string} 返回编码完成的HTML代码字符串
decodeHTMLSource
@description 解码HTML代码字符串
@param {string} code - 需要解码的HTML代码字符串
@returns {string} 返回解码完成的HTML代码字符串
validateData (未支持)
验证数据格式是否合格
非空:data-required="true"
最大字符数:data-maxlength="5"
最小字符数:data-minlength="5"
远程验证:data-remote="/path/to/remote/validator" (如用户名是否已被占用)
匹配验证:data-match="#inputToMatch" (如再次输入密码)
正则验证
数值:data-type="number"
电话:data-type="tel"
邮件:data-type="email"
url:data-type="url"
日期:data-type="date"
自定义:data-pattern="Reg(ular )?Exp(ression)?"
getValue
获取元素数据
$ele jquery 对象
hasFile
检查 data 数据中有无文件类型数据
@param {object} data 数据对象
@return {Boolean} 是否有文件数据
combineUrl
给已有url添加query和fragment
url 已有url,不传则为当前页面url
query 需要添加的 query
fragment 需要添加的 fragment
getBase64Image
Get image data from 相关链接
传入图像Element
randomNumber
生成六位随机数字,无参数
notify
@description 页面提示功能,可提示在特定元素,也可提示在全局
@param {jQuery element} $ele - 若传入 $ 表示全局提示,若传入jQuery对象,表示在该元素上提示
@param {string} info - 提示文本
@param {string} className - 提示类名,关联提示样式 success/error/warn/info,默认是 "error" 错误提示
@param {string} style - 样式主题,默认是 "bootstrap" 主题
@param {boolean/number} hide - 是否自动隐藏,可传入毫秒数表示多少毫秒后隐藏,或传入false表示不隐藏,默认是3000
noty
@description 页面提示功能,提示在全局,可访问defaultConfig来修改默认配置
@param {object} config - 提示配置,必须有text属性表示提示文字
getData
获取数据,传入需要获取数据的集合,包括元素或者数据变量,返回获取到的数据对象
@param {object} source - 需要获取数据的集合
@param {object} source.defaultData - 默认数据
@param {object} source.vmVar - viewmodel的数据
@param {object} source.sourceEle - 需要获取数据的元素
@param {Element} triggerOwner - 触发获取数据的dom元素
anijsTrigger
发出自定义事件,使用该函数可保证发出事件在 wide 预处理结束后发出
showMessage
@description 显示消息对象
@param {object} message - 消息对象
@param {array} message.global - 全局消息列表
@param {object} message.global[] - 全局消息列表项
@param {string} message.global[].text - 全局消息提示文本,必填
@param {string} message.global[].className - 全局消息提示文本,默认 error,可选 alert,success,error,warning,info
@param {string} message.global[].layout - 全局消息提示文本,默认 topRight,可选 top、topLeft、topCenter、topRight、center、centerLeft、centerRight、bottom、bottomLeft、bottomCenter、bottomRight
@param {string} message.global[].mint - 全局消息提示文本,默认 mint,可选 relax、mint、sunset、metroui、semanticui、bootstrap-v3、bootstrap-v4、nest
@param {number|false} message.global[].timeout - 全局消息提示文本,默认 3500,毫秒数或false
@param {array} message.element - 元素消息列表
@param {object} message.element[] - 元素消息列表项
@param {string} message.element[].text - 元素消息提示文本,必填
@param {string} message.element[].className - 元素消息提示文本,必填,元素name
@param {string} message.element[].layout - 元素消息提示文本,默认error,提示类型success/error/warn/info
@param {string} message.element[].mint - 元素消息提示文本,默认 "bottom left",提示位置 "top"、"middle" or "bottom"、"left"、"center" or "right"
@param {number|false} message.element[].timeout - 元素消息提示文本, 默认 3000,自动关闭,或毫秒数
onVisibleDo
构造函数,该函数在元素可见时执行
@param {jquery element} $ele 元素,该元素可见时函数才会执行
@param {function} ) callback 需要执行的函数
updateProp
更新特殊属性,特殊属性值 data-- 或 data-x- 开头
@param {jquery element} $ele 需要更新属性的元素
@param {string} attrName 属性名
@param {string} value 属性值
ajaxProgressInit
修改 $ 的 ajax 方法,使之转化为 promise 方式,并支持 progress 获取,在 wwclass 初始化中被调用
@param {object} $ jquery
fetch
wide 标准的 Ajax 获取数据请求方法
prsStrCmd
@description 解析命令字符串内容,可能是多条命令
@param {string} commandStr - 命令字符串 [[command:param1|param2]][[command2:param1|param2]]...
@returns {array} command - 解析结果
@returns {object} command[] - 解析结果项
@returns {string} command[].str - 命令字符串
@returns {string} command[].command - 命令类型
@returns {array|null} command[].params - 命令参数, null 表示没有参数
prsCmd
@description 解析命令内容,可能是命令对象也可能是命令字符串
@param {string|object} command - 命令字符串 [[command:param1|param2]][[command2:param1|param2]]...
@returns {array} command - 解析结果
@returns {object} command[] - 解析结果项
@returns {string} command[].str - 命令字符串
@returns {string} command[].command - 命令类型
@returns {array|null} command[].params - 命令参数, null 表示没有参数
parsingUrl
@description 解析命令内容,一个字符串的网页地址
@param {string|object} command - 命令字符串 [command:param1]...
@returns {object} command - 解析结果,返回一个包含该网页各部分信息的对象,[source,protocol,host.....]