From e3cd9c902049600817bea3eb3247e3fe8be5cf4f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E8=B4=A4=E5=BF=83?= <3277200+sentsim@users.noreply.github.com> Date: Sun, 30 Apr 2023 01:10:55 +0800 Subject: [PATCH] =?UTF-8?q?=E4=BC=98=E5=8C=96=20=E6=B3=A8=E9=87=8A?= =?UTF-8?q?=E5=AD=97=E7=AC=A6=E9=97=B4=E9=9A=94?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- src/layui.js | 234 ++++++++++++++++++++++++++------------------------- 1 file changed, 118 insertions(+), 116 deletions(-) diff --git a/src/layui.js b/src/layui.js index 03a8dadb..361a9356 100644 --- a/src/layui.js +++ b/src/layui.js @@ -18,10 +18,10 @@ this.v = '2.8.1'; // Layui 版本号 } - //识别预先可能定义的指定全局对象 + // 识别预先可能定义的指定全局对象 ,GLOBAL = win.LAYUI_GLOBAL || {} - //获取 layui 所在目录 + // 获取 layui 所在目录 ,getPath = function(){ var jsPath = doc.currentScript ? doc.currentScript.src : function(){ var js = doc.scripts @@ -39,7 +39,7 @@ return config.dir = GLOBAL.dir || jsPath.substring(0, jsPath.lastIndexOf('/') + 1); }() - //异常提示 + // 异常提示 ,error = function(msg, type){ type = type || 'log'; win.console && console[type] && console[type]('layui error hint: ' + msg); @@ -47,38 +47,38 @@ ,isOpera = typeof opera !== 'undefined' && opera.toString() === '[object Opera]' - //内置模块 + // 内置模块 ,modules = config.builtin = { - lay: 'lay' //基础 DOM 操作 - ,layer: 'layer' //弹层 - ,laydate: 'laydate' //日期 - ,laypage: 'laypage' //分页 - ,laytpl: 'laytpl' //模板引擎 - ,form: 'form' //表单集 - ,upload: 'upload' //上传 - ,dropdown: 'dropdown' //下拉菜单 - ,transfer: 'transfer' //穿梭框 - ,tree: 'tree' //树结构 - ,table: 'table' //表格 - ,treeTable: 'treeTable' //树表 - ,element: 'element' //常用元素操作 - ,rate: 'rate' //评分组件 - ,colorpicker: 'colorpicker' //颜色选择器 - ,slider: 'slider' //滑块 - ,carousel: 'carousel' //轮播 - ,flow: 'flow' //流加载 - ,util: 'util' //工具块 - ,code: 'code' //代码修饰器 - ,jquery: 'jquery' //DOM 库（第三方） + lay: 'lay' // 基础 DOM 操作 + ,layer: 'layer' // 弹层 + ,laydate: 'laydate' // 日期 + ,laypage: 'laypage' // 分页 + ,laytpl: 'laytpl' // 模板引擎 + ,form: 'form' // 表单集 + ,upload: 'upload' // 上传 + ,dropdown: 'dropdown' // 下拉菜单 + ,transfer: 'transfer' // 穿梭框 + ,tree: 'tree' // 树结构 + ,table: 'table' // 表格 + ,treeTable: 'treeTable' // 树表 + ,element: 'element' // 常用元素操作 + ,rate: 'rate' // 评分组件 + ,colorpicker: 'colorpicker' // 颜色选择器 + ,slider: 'slider' // 滑块 + ,carousel: 'carousel' // 轮播 + ,flow: 'flow' // 流加载 + ,util: 'util' // 工具块 + ,code: 'code' // 代码修饰器 + ,jquery: 'jquery' // DOM 库（第三方） ,all: 'all' - ,'layui.all': 'layui.all' //聚合标识（功能性的，非真实模块） + ,'layui.all': 'layui.all' // 聚合标识（功能性的，非真实模块） }; - //记录基础数据 + // 记录基础数据 Layui.prototype.cache = config; - //定义模块 + // 定义模块 Layui.prototype.define = function(deps, factory){ var that = this ,type = typeof deps === 'function' @@ -105,7 +105,7 @@ return that; }; - //使用特定模块 + // 使用特定模块 Layui.prototype.use = function(apps, callback, exports, from){ var that = this ,dir = config.dir = config.dir ? config.dir : getPath @@ -115,7 +115,7 @@ if(typeof apps === 'string'){ return [apps]; } - //当第一个参数为 function 时，则自动加载所有内置模块，且执行的回调即为该 function 参数； + // 当第一个参数为 function 时，则自动加载所有内置模块，且执行的回调即为该 function 参数； else if(typeof apps === 'function'){ callback = apps; return ['all']; @@ -123,7 +123,7 @@ return apps; }(); - //如果页面已经存在 jQuery 1.7+ 库且所定义的模块依赖 jQuery，则不加载内部 jquery 模块 + // 如果页面已经存在 jQuery 1.7+ 库且所定义的模块依赖 jQuery，则不加载内部 jquery 模块 if(win.jQuery && jQuery.fn.on){ that.each(apps, function(index, item){ if(item === 'jquery'){ @@ -137,10 +137,10 @@ ,timeout = 0; exports = exports || []; - //静态资源host + // 静态资源host config.host = config.host || (dir.match(/\/\/([\s\S]+?)\//)||['//'+ location.host +'/'])[0]; - //加载完毕 + // 加载完毕 function onScriptLoad(e, url){ var readyRegExp = navigator.platform === 'PLaySTATION 3' ? /^complete$/ : /^(complete|loaded)$/ if (e.type === 'load' || (readyRegExp.test((e.currentTarget || e.srcElement).readyState))) { @@ -155,13 +155,13 @@ } } - //回调 + // 回调 function onCallback(){ exports.push(layui[item]); apps.length > 1 ? that.use(apps.slice(1), callback, exports, from) : ( typeof callback === 'function' && function(){ - //保证文档加载完毕再执行回调 + // 保证文档加载完毕再执行回调 if(layui.jquery && typeof layui.jquery === 'function' && from !== 'define'){ return layui.jquery(function(){ callback.apply(layui, exports); @@ -171,28 +171,30 @@ }() ); } - //如果引入了聚合板，内置的模块则不必重复加载 + // 如果引入了聚合板，内置的模块则不必重复加载 if( apps.length === 0 || (layui['layui.all'] && modules[item]) ){ return onCallback(), that; } - //获取加载的模块 URL - //如果是内置模块，则按照 dir 参数拼接模块路径 - //如果是扩展模块，则判断模块路径值是否为 {/} 开头， - //如果路径值是 {/} 开头，则模块路径即为后面紧跟的字符。 - //否则，则按照 base 参数拼接模块路径 + /* + * 获取加载的模块 URL + * 如果是内置模块，则按照 dir 参数拼接模块路径 + * 如果是扩展模块，则判断模块路径值是否为 {/} 开头， + * 如果路径值是 {/} 开头，则模块路径即为后面紧跟的字符。 + * 否则，则按照 base 参数拼接模块路径 + */ var url = ( modules[item] ? (dir + 'modules/') : (/^\{\/\}/.test(that.modules[item]) ? '' : (config.base || '')) ) + (that.modules[item] || item) + '.js'; url = url.replace(/^\{\/\}/, ''); - //如果扩展模块（即：非内置模块）对象已经存在，则不必再加载 + // 如果扩展模块（即：非内置模块）对象已经存在，则不必再加载 if(!config.modules[item] && layui[item]){ - config.modules[item] = url; //并记录起该扩展模块的 url + config.modules[item] = url; // 并记录起该扩展模块的 url } - //首次加载模块 + // 首次加载模块 if(!config.modules[item]){ var node = doc.createElement('script'); @@ -218,7 +220,7 @@ } config.modules[item] = url; - } else { //缓存 + } else { // 缓存 (function poll() { if(++timeout > config.timeout * 1000 / 4){ return error(item + ' is not a valid module', 'error'); @@ -238,7 +240,7 @@ apps = that.isArray(apps) ? apps : [apps]; that.each(apps, function (index, item) { if (!config.status[item]) { - //return error('module ' + item + ' is not exist'); + // return error('module ' + item + ' is not exist'); } delete that[item]; delete modules[item]; @@ -249,13 +251,13 @@ return that; }; - //获取节点的 style 属性值 + // 获取节点的 style 属性值 Layui.prototype.getStyle = function(node, name){ var style = node.currentStyle ? node.currentStyle : win.getComputedStyle(node, null); return style[style.getPropertyValue ? 'getPropertyValue' : 'getAttribute'](name); }; - //css外部加载器 + // css 外部加载器 Layui.prototype.link = function(href, fn, cssname){ var that = this ,head = doc.getElementsByTagName('head')[0] @@ -278,21 +280,21 @@ if(typeof fn !== 'function') return that; - //轮询 css 是否加载完毕 + // 轮询 css 是否加载完毕 (function poll(status) { var delay = 100 - ,getLinkElem = doc.getElementById(id); //获取动态插入的 link 元素 + ,getLinkElem = doc.getElementById(id); // 获取动态插入的 link 元素 - //如果轮询超过指定秒数，则视为请求文件失败或 css 文件不符合规范 + // 如果轮询超过指定秒数，则视为请求文件失败或 css 文件不符合规范 if(++timeout > config.timeout * 1000 / delay){ return error(href + ' timeout'); } - //css 加载就绪 + // css 加载就绪 if(parseInt(that.getStyle(getLinkElem, 'width')) === 1989){ - //如果参数来自于初始轮询（即未加载就绪时的），则移除 link 标签状态 + // 如果参数来自于初始轮询（即未加载就绪时的），则移除 link 标签状态 if(status === STAUTS_NAME) getLinkElem.removeAttribute('lay-status'); - //如果 link 标签的状态仍为「创建中」，则继续进入轮询，直到状态改变，则执行回调 + // 如果 link 标签的状态仍为「创建中」，则继续进入轮询，直到状态改变，则执行回调 getLinkElem.getAttribute('lay-status') === STAUTS_NAME ? setTimeout(poll, delay) : fn(); } else { getLinkElem.setAttribute('lay-status', STAUTS_NAME); @@ -302,7 +304,7 @@ } }()); - //轮询css是否加载完毕 + // 轮询css是否加载完毕 /* (function poll() { if(++timeout > config.timeout * 1000 / 100){ @@ -317,15 +319,15 @@ return that; }; - //css 内部加载器 + // css 内部加载器 Layui.prototype.addcss = function(firename, fn, cssname){ return layui.link(config.dir + 'css/' + firename, fn, cssname); }; - //存储模块的回调 + // 存储模块的回调 config.callback = {}; - //重新执行模块的工厂函数 + // 重新执行模块的工厂函数 Layui.prototype.factory = function(modName){ if(layui[modName]){ return typeof config.callback[modName] === 'function' @@ -334,7 +336,7 @@ } }; - //图片预加载 + // 图片预加载 Layui.prototype.img = function(url, callback, error) { var img = new Image(); img.src = url; @@ -351,7 +353,7 @@ }; }; - //全局配置 + // 全局配置 Layui.prototype.config = function(options){ options = options || {}; for(var key in options){ @@ -360,7 +362,7 @@ return this; }; - //记录全部模块 + // 记录全部模块 Layui.prototype.modules = function(){ var clone = {}; for(var o in modules){ @@ -369,11 +371,11 @@ return clone; }(); - //拓展模块 + // 拓展模块 Layui.prototype.extend = function(options){ var that = this; - //验证模块是否被占用 + // 验证模块是否被占用 options = options || {}; for(var o in options){ if(that[o] || that.modules[o]){ @@ -396,12 +398,12 @@ ,hash: (hash.match(/[^#](#.*$)/) || [])[1] || '' }; - if(!/^#\//.test(hash)) return data; //禁止非路由规范 + if(!/^#\//.test(hash)) return data; // 禁止非路由规范 hash = hash.replace(/^#\//, ''); data.href = '/' + hash; hash = hash.replace(/([^#])(#.*$)/, '$1').split('/') || []; - //提取 Hash 结构 + // 提取 Hash 结构 that.each(hash, function(index, item){ /^\w+=/.test(item) ? function(){ item = item.split('='); @@ -412,11 +414,11 @@ return data; }; - //URL 解析 + // URL 解析 Layui.prototype.url = function(href){ var that = this ,data = { - //提取 url 路径 + // 提取 url 路径 pathname: function(){ var pathname = href ? function(){ @@ -427,7 +429,7 @@ return pathname.replace(/^\//, '').split('/'); }() - //提取 url 参数 + // 提取 url 参数 ,search: function(){ var obj = {} ,search = (href @@ -436,12 +438,12 @@ return str.replace(/\#.+/, ''); }() : location.search - ).replace(/^\?+/, '').split('&'); //去除 ?，按 & 分割参数 + ).replace(/^\?+/, '').split('&'); // 去除 ?，按 & 分割参数 - //遍历分割后的参数 + // 遍历分割后的参数 that.each(search, function(index, item){ var _index = item.indexOf('=') - ,key = function(){ //提取 key + ,key = function(){ // 提取 key if(_index < 0){ return item.substr(0, item.length); } else if(_index === 0){ @@ -450,7 +452,7 @@ return item.substr(0, _index); } }(); - //提取 value + // 提取 value if(key){ obj[key] = _index > 0 ? item.substr(_index + 1) : null; } @@ -459,7 +461,7 @@ return obj; }() - //提取 Hash + // 提取 Hash ,hash: that.router(function(){ return href ? ((href.match(/#.+/) || [])[0] || '/') @@ -504,20 +506,20 @@ return this.data(table, settings, sessionStorage); } - //设备信息 + // 设备信息 Layui.prototype.device = function(key){ var agent = navigator.userAgent.toLowerCase() - //获取版本号 + // 获取版本号 ,getVersion = function(label){ var exp = new RegExp(label + '/([^\\s\\_\\-]+)'); label = (agent.match(exp)||[])[1]; return label || false; } - //返回结果集 + // 返回结果集 ,result = { - os: function(){ //底层操作系统 + os: function(){ // 底层操作系统 if(/windows/.test(agent)){ return 'windows'; } else if(/linux/.test(agent)){ @@ -528,20 +530,20 @@ return 'mac'; } }() - ,ie: function(){ //ie版本 + ,ie: function(){ // ie 版本 return (!!win.ActiveXObject || "ActiveXObject" in win) ? ( - (agent.match(/msie\s(\d+)/) || [])[1] || '11' //由于ie11并没有msie的标识 + (agent.match(/msie\s(\d+)/) || [])[1] || '11' // 由于 ie11 并没有 msie 的标识 ) : false; }() - ,weixin: getVersion('micromessenger') //是否微信 + ,weixin: getVersion('micromessenger') // 是否微信 }; - //任意的key + // 任意的 key if(key && !result[key]){ result[key] = getVersion(key); } - //移动设备 + // 移动设备 result.android = /android/.test(agent); result.ios = result.os === 'ios'; result.mobile = (result.android || result.ios) ? true : false; @@ -549,32 +551,32 @@ return result; }; - //提示 + // 提示 Layui.prototype.hint = function(){ return { error: error }; }; - //typeof 类型细分 -> string/number/boolean/undefined/null、object/array/function/… + // typeof 类型细分 -> string/number/boolean/undefined/null、object/array/function/… Layui.prototype._typeof = Layui.prototype.type = function(operand){ if(operand === null) return String(operand); - //细分引用类型 + // 细分引用类型 return (typeof operand === 'object' || typeof operand === 'function') ? function(){ - var type = Object.prototype.toString.call(operand).match(/\s(.+)\]$/) || [] //匹配类型字符 - ,classType = 'Function|Array|Date|RegExp|Object|Error|Symbol'; //常见类型字符 + var type = Object.prototype.toString.call(operand).match(/\s(.+)\]$/) || [] // 匹配类型字符 + ,classType = 'Function|Array|Date|RegExp|Object|Error|Symbol'; // 常见类型字符 type = type[1] || 'Object'; - //除匹配到的类型外，其他对象均返回 object + // 除匹配到的类型外，其他对象均返回 object return new RegExp('\\b('+ classType + ')\\b').test(type) ? type.toLowerCase() : 'object'; }() : typeof operand; }; - //对象是否具备数组结构（此处为兼容 jQuery 对象） + // 对象是否具备数组结构（此处为兼容 jQuery 对象） Layui.prototype._isArray = Layui.prototype.isArray = function(obj){ var that = this ,len @@ -582,24 +584,24 @@ if(!obj || (typeof obj !== 'object') || obj === win) return false; - len = 'length' in obj && obj.length; //兼容 ie + len = 'length' in obj && obj.length; // 兼容 ie return type === 'array' || len === 0 || ( - typeof len === 'number' && len > 0 && (len - 1) in obj //兼容 jQuery 对象 + typeof len === 'number' && len > 0 && (len - 1) in obj // 兼容 jQuery 对象 ); }; - //遍历 + // 遍历 Layui.prototype.each = function(obj, fn){ var key ,that = this - ,callFn = function(key, obj){ //回调 + ,callFn = function(key, obj){ // 回调 return fn.call(obj[key], key, obj[key]) }; if(typeof fn !== 'function') return that; obj = obj || []; - //优先处理数组结构 + // 优先处理数组结构 if(that.isArray(obj)){ for(key = 0; key < obj.length; key++){ if(callFn(key, obj)) break; @@ -623,7 +625,7 @@ // 若未传入 key，则直接返回原对象 if(that.type(arr) === 'object' && !key){ return clone; - } else if(typeof arr !== 'object'){ //若 arr 非对象 + } else if(typeof arr !== 'object'){ // 若 arr 非对象 return [clone]; } @@ -665,11 +667,11 @@ // 若为数字比较 if(isNum[0] && isNum[1]){ - if(v1 && (!v2 && v2 !== 0)){ //数字 vs 空 + if(v1 && (!v2 && v2 !== 0)){ // 数字 vs 空 return 1; - } else if((!v1 && v1 !== 0) && v2){ //空 vs 数字 + } else if((!v1 && v1 !== 0) && v2){ // 空 vs 数字 return -1; - } else { //数字 vs 数字 + } else { // 数字 vs 数字 return v1 - v2; } } @@ -691,9 +693,9 @@ } // 若为混合比较 - if(isNum[0] || !isNum[1]){ //数字 vs 非数字 + if(isNum[0] || !isNum[1]){ // 数字 vs 非数字 return -1; - } else if(!isNum[0] || isNum[1]) { //非数字 vs 数字 + } else if(!isNum[0] || isNum[1]) { // 非数字 vs 数字 return 1; } @@ -703,7 +705,7 @@ return clone; }; - //阻止事件冒泡 + // 阻止事件冒泡 Layui.prototype.stope = function(thisEvent){ thisEvent = thisEvent || win.event; try { thisEvent.stopPropagation() } catch(e){ @@ -711,10 +713,10 @@ } }; - //字符常理 + // 字符常理 var EV_REMOVE = 'LAYUI-EVENT-REMOVE'; - //自定义模块事件 + // 自定义模块事件 Layui.prototype.onevent = function(modName, events, callback){ if(typeof modName !== 'string' || typeof callback !== 'function') return this; @@ -722,25 +724,25 @@ return Layui.event(modName, events, null, callback); }; - //执行自定义模块事件 + // 执行自定义模块事件 Layui.prototype.event = Layui.event = function(modName, events, params, fn){ var that = this ,result = null - ,filter = (events || '').match(/\((.*)\)$/)||[] //提取事件过滤器字符结构，如：select(xxx) - ,eventName = (modName + '.'+ events).replace(filter[0], '') //获取事件名称，如：form.select - ,filterName = filter[1] || '' //获取过滤器名称,，如：xxx + ,filter = (events || '').match(/\((.*)\)$/)||[] // 提取事件过滤器字符结构，如：select(xxx) + ,eventName = (modName + '.'+ events).replace(filter[0], '') // 获取事件名称，如：form.select + ,filterName = filter[1] || '' // 获取过滤器名称,，如：xxx ,callback = function(_, item){ var res = item && item.call(that, params); res === false && result === null && (result = false); }; - //如果参数传入特定字符，则执行移除事件 + // 如果参数传入特定字符，则执行移除事件 if(params === EV_REMOVE){ delete (that.cache.event[eventName] || {})[filterName]; return that; } - //添加事件 + // 添加事件 if(fn){ config.event[eventName] = config.event[eventName] || {}; @@ -755,15 +757,15 @@ return this; } - //执行事件回调 + // 执行事件回调 layui.each(config.event[eventName], function(key, item){ - //执行当前模块的全部事件 + // 执行当前模块的全部事件 if(filterName === '{*}'){ layui.each(item, callback); return; } - //执行指定事件 + // 执行指定事件 key === '' && layui.each(item, callback); (filterName && key === filterName) && layui.each(item, callback); }); @@ -771,20 +773,20 @@ return result; }; - //新增模块事件 + // 新增模块事件 Layui.prototype.on = function(events, modName, callback){ var that = this; return that.onevent.call(that, modName, events, callback); } - //移除模块事件 + // 移除模块事件 Layui.prototype.off = function(events, modName){ var that = this; return that.event.call(that, modName, events, EV_REMOVE); }; - //exports layui + // exports layui win.layui = new Layui(); -}(window); //gulp build: layui-footer +}(window); // gulp build: layui-footer