常用 JS 类库 API、js.*、jeesite.js、页签操作

全局常用

  1. /**
  2.  * 输出日志
  3.  */
  4. log(msg);
  6. /**
  7.  * 输出错误日志
  8.  */
  9. error(msg);
  11. /**
  12.  * URL 编码
  13.  */
  14. js.encodeUrl(url);
  16. /**
  17.  * URL 解码
  18.  */
  19. js.decodeUrl(url);
  21. /**
  22.  * 得到 IE 版本，如果是IE返回：IE版本号，否则返回：false
  23.  * if (js.ie && js.ie <= 8){ alert('浏览器版本过低') }
  24.  */
  25. js.ie;
  27. /**
  28.  * 安全取值，复杂类型或嵌套类型时，取不到属性中的属性时不抛出异常
  29.  * js.val(jsonObj, 'user.office.name');
  30.  */
  31. js.val(jsonObj, attrName);
  33. /**
  34.  * 返回HashCode唯一值（默认忽略大小写）
  35.  * @param str 要获取的字符串HashCode值
  36.  * @param caseSensitive 是否大小写敏感（默认false）
  37.  * @usage js.hashCode(str);
  38.  */
  39. js.hashCode(str, caseSensitive);
  41. /**
  42.  * 异步加载文件，loadFile v1.0
  43.  * js.loadFile(file文件路径, callback成功回调, error失败回调)
  44.  * js.loadFile('js/test.js',function(){},function(data){});
  45.  * js.loadFile(['js/test.js','css/test.css'],function(){},function(data){});
  46.  */
  47. js.loadFile(file, callback, error);
  49. /**
  50.  * 打开一个Window窗体
  51.  */
  52. js.windowOpen(url, name, width, height);
  54. /**
  55.  * 关闭当前Window窗体
  56.  */
  57. js.windowClose();
  59. /**
  60.  * 给URL地址添加参数，如果原来有参数则用&前缀，如果没有则用?前缀
  61.  */
  62. js.addParam(url, params);
  64. /**
  65.  * 获取URL地址的参数
  66.  */
  67. js.getParam(paramName, url);
  69. /**
  70.  * 移除URL地址里的某个参数
  71.  */
  72. js.removeParam(paramName, url);
  74. /**
  75.  * 查看Object的内容，手机调试用
  76.  * @param obj
  77.  */
  78. js.alertObj(obj);

国际化、字典

  2. /**
  3.  * 获取国际化译文
  4.  */
  5. js.text(code, params);
  7. /**
  8.  * 获取字典标签
  9.  * js.getDictLabel(${@DictUtils.getDictListJson('sys_menu_type')}, val, '未知', true)
  10.  */
  11. js.getDictLabel(dictListJson, value, defaultValue, inCss);

加载框、弹窗

  2. /**
  3.  * 显示加载框
  4.  * @param message 加载框提示信息
  5.  * @param ignoreMessageIfExists 如果已经有加载框现在，则忽略message信息的设置
  6.  * @usage js.loading('正在保存...');
  7.  */
  8. js.loading(message, ignoreMessageIfExists);
  10. /**
  11.  * 关闭加载框
  12.  * @param timeout 关闭延迟时间
  13.  * @param forceClose 是否强制关闭
  14.  * @usage js.closeLoading(1000, true);
  15.  */
  16. js.closeLoading(timeout, forceClose);
  18. /**
  19.  * 得到layer对话框对象
  20.  * js.layer.msg();
  21.  */
  22. js.layer;
  24. /**
  25.  * 显示提示框
  26.  * @param message 提示消息
  27.  * @param title 提示标题
  28.  * @param type 提示类型（success、error、warning、info）
  29.  * @param timeout 自动关闭毫秒（默认4000毫秒）
  30.  */
  31. js.showMessage(message, title, type, timeout);
  33. /**
  34.  * 显示错误提示框
  35.  */
  36. js.showErrorMessage(responseText);
  38. /**
  39.  * 关闭提示框
  40.  */
  41. js.closeMessage();
  43. /**
  44.  * 提示对话框
  45.  * @param message 提示消息
  46.  * @param options 对话框选项
  47.  * @param closed 对话框关闭回调方法
  48.  * @usage js.alert('你好！', function(){})
  49.  * @usage js.alert('你好！', {icon: 2}, function(){})
  50.  */
  51. js.alert(message, options, closed);
  53. /**
  54.  * 确认对话框
  55.  * @param message 确认信息
  56.  * @param urlOrFun 确认后的跳转的地址，或调用的方法
  57.  * @param data 如果urlOrFun是地址，该参数是调用地址的参数信息
  58.  * @param callback 执行ajax的回调方法，如果为空，则直接通过location=urlOrFun跳转。
  59.  * @param dataType 返回数据类型（默认json）
  60.  * @param async 是否异步（默认true）
  61.  * @param loadingMessage 调用loading(loadingMessage)的提示信息。
  62.  * @usage js.confirm('确认删除吗？', '$ctx/biz/delete?id=123', function(data){alert('删除成功')}, 'json', true, '正在删除...');
  63.  * @usage js.confirm('确认删除吗？', '$ctx/biz/delete', {id: '123'}, function(data){alert('删除成功')}, 'json', true, '正在删除...');
  64.  * @usage js.confirm('确认删除吗？', function(data){alert('删除成功')});
  65.  */
  66. js.confirm(message, urlOrFun, data, callback, dataType, async, loadingMessage);

JS 模板

  2. /**
  3.  * 根据js模板生成代码，使用laytpl引擎
  4.  * @param id 模板ID
  5.  * @param data 模板数据（可选）
  6.  * @param callback 如果填写，则为异步渲染
  7.  * @usage 
  8.  *         模板格式： <sc ript id="dempTpl" type="text/template">//<!--
  9.  *                      这里写模块内容...
  10.  *                 //--></sc ript>
  11.  *         调用方法： js.template('dempTpl', data);
  12.  *         模版语法：
  13.  *             输出一个普通字段，不转义html：   { { d.field } }
  14.  *             输出一个普通字段，并转义html：   { {= d.field } }
  15.  *             JavaScript脚本： { {# JavaScript statement } }
  16.  */
  17. js.template(id, data, callback);

Ajax 表单

  2. /**
  3.  * AJAX 提交
  4.  * js.ajaxSubmit('/sys/user/save', {param: 1}, function(data){})
  5.  */
  6. js.ajaxSubmit(url, data, callback, dataType, async, message);
  8. /**
  9.  * AJAX 提交表单（支持文件上传）
  10.  * js.ajaxSubmitForm($(form), function(data){})
  11.  */
  12. js.ajaxSubmitForm(formJqueryObj, callback, dataType, async, message);

字符串操作

  2. /**
  3.  * String两边去空格
  4.  */
  5. js.trim(str);
  7. /**
  8.  * String的startWith（正则表达式方式）
  9.  */
  10. js.startWith(str, start);
  12. /**
  13.  * String的startWith（slice方式）
  14.  */
  15. js.startsWith(str, prefix);
  17. /**
  18.  * String的endWith（正则表达式方式）
  19.  */
  20. js.endWith(str, end);
  22. /**
  23.  * String的endWith（indexOf方式）
  24.  */
  25. js.endsWith(str, suffix);
  27. /**
  28.  * 截取字符串，区别汉字和英文
  29.  */
  30. js.abbr(name, maxLength);

数值类型操作

  2. /**
  3.  * 格式化数值
  4.  * @param num 待格式化的树
  5.  * @param cent 保留小数位数
  6.  * @param isThousand 是否进行千分位格式化
  7.  */
  8. js.formatNumber(num, cent, isThousand);
  10. /**
  11.  * 金额格式化（千位符，小数四舍五入）金额每隔三位加一个逗号
  12.  * @param s 要格式化的数值
  13.  * @param n 小数位数
  14.  */
  15. js.formatMoney(s, n);
  17. /**
  18.  * 数值前补零
  19.  */
  20. js.numberPad(num, n);

日期类型操作

  2. /**
  3.  * 日期格式化
  4.  * @param date 日期 new Date()
  5.  * @param f 格式化字符串 yyyy-MM-dd HH:mm:ss
  6.  */
  7. js.formatDate(date, f);
  9. /**
  10.  * 字符串转为日期
  11.  * @param date
  12.  */
  13. js.parseDate(date);
  15. /**
  16.  * 日期加减
  17.  * @param date
  18.  * @param dadd 天数
  19.  */
  20. js.addDate(date, dadd);
  22. /**
  23.  * 快速选择日期方法
  24.  * @param type 1今日，2本周，3本月，4本季度，5上月
  25.  * @param beginDateId 开始日期控件的ID
  26.  * @param endDateId     结束日期控件的ID
  27.  */
  28. js.quickSelectDate(type, beginDateId, endDateId);

Cookie 操作

  2. /**
  3.  * cookie 操作
  4.  * @param name Cookie名称
  5.  * @param value Cookie值，填写表示设置，不填写表示获取
  6.  * @parma options:{expires:7} 如果是数字，则expires单位为天。
  7.  */
  8. js.cookie(name, value, options);

TabPage 页签

  2. /**
  3.  * 得到TabPage对象
  4.  */
  5. js.tabPage;
  7. /**
  8.  * 初始化TAB页面
  9.  * @param id
  10.  */
  11. js.initTabPage(id, options);
  13. /**
  14.  * 添加TAB页面（ class="addTabPage" ）
  15.  * @param $this         点击的对象
  16.  * @param title         提示标题
  17.  * @param url             访问的路径
  18.  * @param closeable         是否有关闭按钮，关闭页面回调方法：function onTablePageClose(tabId, title){}
  19.  * @param refresh         打开后是否刷新重新加载
  20.  */
  21. js.addTabPage($this, title, url, closeable, refresh);
  23. /**
  24.  * 获取当前TAB页面
  25.  * @param currentTabCallback 获取之后回调方法，传入当前tab页面的contentWindow，例如：function(contentWindow){}
  26.  */
  27. js.getCurrentTabPage(currentTabCallback);
  29. /**
  30.  * 获取当前页面的上一个TAB页面，并激活上级页面
  31.  * @param preTabCallback 获取之后回调方法，传入上一个tab页面的contentWindow，例如：function(contentWindow){}
  32.  * @param isCloseCurrentTab 是否关闭当前页签
  33.  */
  34. js.getPrevTabPage(preTabCallback, isCloseCurrentTab);
  36. /**
  37.  * 关闭当前TAB页面，并激活上级页面
  38.  * @param preTabCallback 关闭前的回调方法，传入上一个tab页面的contentWindow，例如：function(contentWindow){}
  39.  */
  40. js.closeCurrentTabPage(preTabCallback);