平台前端框架使用手册

PS：组件分为三类（基础、功能、框架），注意依赖关系；参照下方顺序使用：
js:
<!-- 基础组件 -->
<script src="jquery-2.1.1.js"></script>
<script src="bootstrap.min.js"></script>
<script src="jquery.metisMenu.js"></script><!-- 多级菜单 首页index【main】必须 -->
<script src="layer.js"></script><!-- 弹窗 -->
<!-- 功能组件 -->
<script src="jquery.dataTables.min.js"></script>
<script src="jquery.validate.custom.min.js"></script>
。。。。。。引入你需要的组件

<!-- 框架组件 -->
<script src="jquery.hash.min.js"></script><!-- 首页index【main】必须 -->
<script src="i18n/zh-CN.js"></script><!-- 国际化语言资源包（/private/i18n/XXXX.json）  2017-8-28（新增） -->
<script src="subindex.js" ></script><!-- 框架公共方法库 -->
<script src="inspinia.js"></script><!-- 首页index【main】必须 -->

CSS:
<!-- 基础组件 -->
<link href="bootstrap.min.css" rel="stylesheet">
<link href="font-awesome.css" rel="stylesheet"> (从2017-5-10版本后，为可选样式)
<!-- 功能组件 -->
<link href="plugins/iCheck/custom.css" rel="stylesheet">
。。。。。。引入你需要的组件

<!-- 框架组件 -->
<link href="animate.css" rel="stylesheet"><!-- 可选 -->
<link href="iconfont.css" rel="stylesheet"><!-- 自定义图标字库 -->
<link href="style.css" rel="stylesheet">

		  		

/* 自 2017-8-28 起使用新国际化规则 @lianglei */
/* 国际化组件构成：1、语言资源包（i18n/zh-CN.js）; 
 * http://192.168.191.50:8083/private/i18n/zh-CN.js
 */
/* 系统错误提示信息使用方法：*/
/* 1. 获取提示信息API：*/
/**
 * 获取指定的消息内容
 * @param {String} key 消息key
 * @param {Array} params 可选，替换模板中{n}的位置，n为params数组下标从0开始
 * 备注：消息value值为 0 或 null\false等强制转换为空字符串输出；
 */
TEDU_MESSAGE.get(key, params); 

/* 备注: TEDU_MESSAGE.set()方法禁止使用 （2017-8-28） */
/* 例如：
 * 语言包资源："platform.plugin.validate.rangelength":"只能输入{0}至{1}个字符！"；
 * TEDU_MESSAGE.get('platform.plugin.validate.rangelength',[3,6]);
 * 输出："只能输入3至6个字符！"
 */

• [5.11.6] 2020-11-27

  1.【BUG】组件bootstrap-dropdown-on-hover-plugin，修正触发节点中含有子节点时，高概率失效的BUG；
  2.【更新】新增websocket协议的即时通讯组件；用于消息通知服务；
  3.【功能】新增帮助中心模块，可独立部署子系统；
  4.【更新】富文本编辑器新增对bootstrap-table基础样式，在编辑及预览状态下的兼容支持；
  5.【更新】修改富文本编辑器自定义占位符组件的识别结构为'${name}'格式，与各数据模板保持统一；

• [5.6.1] 2020-06-11

  1.【更新】因系统拆分需要，解决部分场景下跨系统调用交互跨域的问题，通过cumCheckPwin方法，自动将跨域嵌套的对象降级为self处理，弹窗系列方法已默认兼容；
  PS：parent.COM_TOOLS.alert(123) 需要更换为 cumCheckPwin(parent).COM_TOOLS.alert(123)；
  PS：parent => cumCheckPwin(parent);
  PS：top => cumCheckPwin(top);

• [5.5.1] 2020-05-27

  1.添加在线人数显示；

• [5.1.2] 2020-01-19

  1.【功能】数据表格datatable 添加自定义排序功能；提交到服务器的数据中新增sort字段，类型array; (@LL)
  形式：[{ colData: "column.data", colName: "column.name", dir: "asc/desc" }]；
  使用方法：后台按照form-checkbox方式接收处理数据

• [5.1.1] 2020-01-16

  1.【BUG】修正cusdaterangepicker组件，非input元素初始化时存在的各种异常；(@LL)
  2.【BUG】修正cusdaterangepicker组件，与dropdown混用时，点击左右按钮，导致dropdown关闭的问题；(@LL)

• [4.8.5] 2019-8-13

  1.【组件】升级ckeditor 树形结构组件（V4.9.2 -> 4.12.1），添加内部ajax控件、自动高度调节控件、block模块、表格拖拽控件；(@LL)
  2.【更新】扩展COM_TOOLS.fnTabPage，以支持iframe模式初始化；(@LL)

• [4.8.3] 2019-8-8

  1.【组件】升级jstree 树形结构组件（V3.3.3 -> 3.3.8），解决浏览器即将废除document.registerElement方法的风险；(@LL)

• [4.8.2] 2019-8-4

  1.【BUG】修正select2_init方法的已知BUG；(@LL)
  2.【更新】重构并修正select2 demo页面，合并数据字典组件模板(@LL)

• [4.7.3] 2019-7-30

  1.【组件】扩展select2组件支持本地数据源；(@LL)
  2.【组件】修改daterangepicker-双日历组件，使其支持在单日历且无时间框模式下，支持显示取消与确定按钮；(@LL)
  3.【功能】新增JSP页面代码生成器（包括表单页、列表页、详情页；如后台服务支持，可同时生成对应的建表语句和java类；）(@LL)
  4.【组件】升级daterangepicker-双日历组件（V3.0.3 -> V3.0.5），解决不可设置可选截止日期为当日的BUG；(@LL)

• [4.6.1] 2019-6-11

  1.【BUG】修正强制退出配置项因参数类型导致的BUG，改为字符串类型；(@LL)
  2.【BUG】修正国际化配置组件中，当key为纯数字时，产生的兼容性BUG；(@LL)

• [4.3.1] 2019-3-7

  1.【功能】针对jq-ajax添加全局监听器，如登录会话失效则跳转到登录页；（注：真对基于jquery的ajax有效，dataFilter 未被覆盖）(@LL)

• [4.1.4re05 --] 2019-1-30

  1.【功能】添加强制退出功能，支持设置累计使用时长与指定时间两种形式；(@LL)
  2.【模块】新增通讯录模块；(@LL)
  3.【功能面板】新增通讯录管理功能面板；
  4.【功能面板】新增应用及接口服务管理功能面板；
  5.【功能面板】新增邮件服务管理功能面板；
  6.【组件】新增附件上传组件（webuploader的多文件上传）；(@LL)
  7.【BUG】修正帮助手册大纲层级构造异常的BUG（2级及以上大纲层级回归时，层级计算错误）；(@LL)
  8.【功能面板】新增操作日志采集与查询功能面板；(@hjq)
  9.【组件】新增双日历组件（cusdaterangepicker）；(@CCJ)
  10.【BUG】修正嵌套（逻辑）弹窗获取父页面（物理）大小计算错误的兼容问题（parent.$(window).width() ==》 $(parent).width()）；(@LL)
  11.【组件】新增密码框组件；(@CCJ)
  12.【布局】新增flex布局；(@LL)

• [3.9.3] 2018-9-9

  1.【BUG】系统消息模块添加对下兼容补丁（后台接口数据格式有变更），并修复已知BUG；(@LL)
  2.【BUG】对优化后的首页标签导航代码添加对下兼容补丁；(@LL)
  3.【更新】优化自定义面板组件按钮区配置方式；提高容错兼容性；(@LL)

• [3.9.1] 2018-9-5

  1.【BUG】修复IE浏览器下部分因为ajax缓存造成的BUG，改为不使用缓存；涉及ajaxFn, select2, jstree, echart(@LL)

• [3.8.6] 2018-8-29

  1.【组件】新增jQuery插件cuspanel，使用方法：$(selector).cuspanel();使用说明,还没写呢，详见源码("comTools-公共方法库" => _CUSPANEL_)(@LL)
      a、包含展开\收起、刷新、全屏、关闭功能；
      b、支持自定义面板按钮(更换默认按钮图标，新增、删减按钮)；
      c、提供5种默认面板皮肤样式，并支持自定义面板高度；
      d、支持iframe模式；
  【模块】2.新增首页定制化功能(@LL) ==> 查看 demo
      a、支持面板个性化配置（选择皮肤主题、高度、边框、标题栏显隐）；
      b、支持可视化拖拽布局（基于BS栅格系统）；
  【更新】3.全新改版系统消息功能；(@LL)
  【BUG】4.优化平台首页标签页相关方法并修正已知BUG；(@XXW)

• [3.8.5] 2018-8-8

  1.【更新】layer组件修改，将原型绑定到实例化后的组件上，使外部可以调用内部原型方法（慎用）；(@LL)
  【更新】2.添加API:cumResizeWin,可根据内容自适应，调整窗口的大小及位置 （暂不适用于iframe层）【3.8.1+】(@LL)
  【更新】3.修改系统消息弹窗，新增强制模式；内容列表改为追加方式；添加消息列表页、详情页等；(@LL)
  【BUG】4.修正组织机构页面左右伸缩BUG；(@LL)

• 2018-5-20

  1.【BUG】修正select2_init 方法中多选初始化配置异常BUG，及启用拼音检索配置项拼写错误问题(ispinyi => ispinyin),已兼容处理；(@LL)
  2.添加公告方法getPosition（获取元素的大小及位置）、get_GUID（生成guid）(@LL)
  3.新增平台树形组件初始化方法jstree_init，支持数据源共享机制；(@LL)
  4.修改国际化模块针对key忽略大小写敏感；已对历史数据进行兼容处理；(@LL)
  5.新增自定义下拉框组件cus_dropdown；(@LL)
  5.新增树形下拉框组件cus_drop_jstree（支持数据源共享机制，与拼音检索）；(@LL)
  6.【BUG】修正部分场景下input 的defaultValueMsg不生效的问题；(@LL)

• 2018-3-30

  1.新增使用 webupload 进行二次封装的多文件上传（使用单独的js及css文件）；(@CCJ)
  2.单文件上传方法 COM_TOOLS._view.cusFileUpload 修改为DOM节点动态构造形式；(@CCJ)
  3.数据表格添加动态列显隐控件；(@LL)
  4.修改数据表格（dataTables.bootstrap.js）组件源码，新增2种跳页解析器；并新增3个分页插件（subindex.js）；【使用方法：opt=>other=>pagingType: 'simple_inputAndPages'】(@LL)
      a、simple_numbers_input 上一页和下一页两个按钮，加上页数按钮，加跳页按钮(不带总页数：page => go)
      b、simple_numbers_inputAndPages 上一页和下一页两个按钮，加上页数按钮，加跳页按钮(带总页数：page/pages => go)
      c、simple_inputAndPages 上一页和下一页两个按钮，加跳页按钮(带总页数：page/pages => go)

• 2018-3-22

  1.修正select2 IE11下拉菜单自动触发的BUG，修正菜单位置异常的BUG；(@LL)
  2.修正弹窗关闭方法，非嵌套使用时会报警告的问题；(@LL)
  3.修正select2组件，自定义api在部分组合使用时，不能自动触发的BUG；及部分场景下的样式兼容问题(@LL)
  4.变更组件级国际化信息key，与业务资源分离；（@LTY）
  5.添加自定义模块——国际化；(@LL)
  6.添加富文本编辑器（ckeditor）初始化api:docEditor，封装上传接口（应用配置文件）及默认参数；添加数据锚点插件；(@CCJ)
  7.添加文件上传UI组件；(@CCJ)
  8.添加延时信息框组件delayPopover；并修改帮助系统提示信息交互形式为delayPopover；(@LL)

• 2018-2-23

  1.修正日历组件（datatimepicker）重置起始时间无效的问题；(@LL)

• 2018-1-18

  1.新增外部设置平台默认配置信息（功能、组件）的方法；(@LL)
  2.修改数据表格错误信息提示方式为控制台输出，并新增该类型错误可能导致的原因；(@LL)

• 2017-12-12

  1.数字格式化插件jquery.number.js（修复BUG）；(@LL)
      a、修正 应用于非input元素且为负数时，负号丢失的问题；
      b、修正 Safari 浏览器 应用 $.number()时，千分位不能正确显示的问题；
      c、修正 应用 $([]).val('')，时输出 0.00，而不能输出预期值 '' 的问题；（该问题来源于github）

• 2017-09-25

  1.合并subindex与tedu_language（移除对下兼容功能）;合并validate与自定义扩展组件； (@LL)
  2.修改datatimepicker组件源码，添加日期变更后自动触发表单验证功能；(@LL)
  3.修改自定义封装select2 =》 fn:select2_init方法，添加自动触发表单验证功能，并修改回调函数为队列形式；(@LL)

• 2017-09-14

  1.自定义封装datatable =》fn:DT_init（支持接口无权限时数据格式转换）及相关API； (@LL)
  2.自定义封装select2 =》 fn:select2_init 支持实时数据检索、ajax本地缓存数据、html数据初始化及相关API；(@LL)
  3.修改弹窗交互demo,统一交互方式为匿名回调函数方式；(@LL)
  4.新增自定义单选框、复选框组件icheck组件范例 (@LL)
  5.新增自定义下拉框（更多搜索条件下拉框demo）、优化高级搜索实现方法(@CCJ)
  6.升级layer弹窗组件（源码有定制修改）【修复在最新版 Chrome（61.0.3163.79）下遮罩层出现的奇异花屏现象】，3.0.1=》3.1.0版本，更新内容见官方说明http://fly.layui.com/jie/4827/；(@LL)
  7.layer弹窗组件新增左侧偏移量定位属性：cusOffsetLeft；默认0，如果是右侧定位，请使用负数；(@LL)

• 2017-08-31

  1.修改国际化组件规则 (@LL)2017-08-28
      a.引入新国际化资源包i18n/xxxx.json文件（必须）；
      b.修改tedu-languge.js、zdy-validate.js中相关方法；
      备注：如使用2017-8-28（+）版本的文件tedu-languge.js和zdy-validate.js；则必须引入i18n/xxxx.json文件；新、旧语言包共存状态下，优先使用新语言包资源，并可自动对下兼容为旧语言包key;未加载新国际化组件资源的项目禁止单独升级tedu-languge.js和zdy-validate.js文件
  2.所有demo页套用新国际化组件 (@LL)
  3.修改、扩充select2-demo；(@LL)

• 2017-05-24

  1.zdy-validate新增两个校验方法 (@CCJ)
      a.表单内至少N项被填写
      b.表单内至少N项被填写 或者 都不填写
  2.validate-demo里新增对应的实例 (@CCJ)

• 2017-05-18

  1.新增datatimepicker实例 (@CCJ)
      a.简单的可视化配置
      b.自动生成对应代码片段
  2.layer 添加按钮组自定义样式扩展 config.btnStyleArr['class1','class2']

• 2017-05-12

  1.添加CKeditor-DEMO例子 (@CCJ)
      a.包含两种不同初始化方法的演示实例
      b.多种初始化方式的详细说明
      c.配置项 config.js 说明
      d.基础API方法说明
      e.图片上传及返回信息说明
  2. 废弃 组件jquery-validate.bootstrap-tooltip.min.js（当存在两个以上远程验证，且第一次触发时存在错误提示信息闪退的BUG），已重写类似交互方法并加入到subindex.js中 (@LL)
  3. 从2017-5-10版本开始font-awesome.css文件为可选包 (@LX)
  4. 添加多级下拉菜单功能；(@CCJ)
  5. 废弃 bootstrap-hover-dropdown.min-ajax.js 复用 bootstrap-hover-dropdown.min.js；
  6. 修改subindex.js 与 subindex-ajax.js文件差异部分，准备弃用subindex-ajax.js；(@LL)
  7. 新增“数字显示插件”及“日期处理类库”范例；(@LL)
  8. 修改callParentWinCacheFn方法，用于支持直接回调匿名函数；(@LL)
  9. 在其它组件范例里新增下拉菜单示例 (@CCJ)

• 2017-05-09

  1. 添加数据表格DT 分页组件（pager.simple_numbers_no_totalpage：不显示总页数）; (@LL)
  2. 新增全局组件对象CUS_PLUGINS，用于定义组件方法；(@LL)
  3. 修改数据表格配置及初始化信息，并删除自适应行数方法（未使用，不具备价值），新增行背景颜色；(@LL)
  4. 公共方法库中，新增数组去重（arrayUniqueFn）、数组去重插入（arrayUniquePushFn）方法；(@LL)
  5. 公共方法库，新增自定义验证类-自定义特殊字符验证（specialChars）（@CCJ）
  6. 修改demo图标（awesome --> glyphicons 及 iconfont） 准备弃用awesome(@LX)
  　> fa fa-search --> glyphicon glyphicon-search　　> fa fa-plus --> glyphicon glyphicon-plus　　> fa fa-pencil --> glyphicon glyphicon-pencil
  　> fa fa-trash --> glyphicon glyphicon-trash　　　> fa fa-road --> glyphicon glyphicon-road　　> fa fa-cog --> glyphicon glyphicon-cog
  　> fa fa-calendar --> glyphicon glyphicon-calendar　　> fa fa-check --> glyphicon glyphicon-ok　　> fa fa-download --> glyphicon glyphicon-download-alt
  　> fa fa-minus --> glyphicon glyphicon-minus　　> fa fa-info --> tedufont tedu-icon72　　　　> fa fa-file-text-o --> tedufont tedu-icon85
  　> fa fa-file-code-o --> tedufont tedu-icon81　　> fa fa-list-ul --> glyphicon glyphicon-th-list

• 2017-04-25

  1. 添加加载中遮罩层 COM_TOOLS.loadingShade.open()||close(); (@LL)
  2. 新增新手引导DEMO；示例：ajax-demo/index.html(@LL)
  3. 新增详情信息气泡窗口，并支持内部图片缩放；(@LL)
  4. 修正cus-popover方法与已知的第三方基于原生popover组件的已知的兼容问题；(@LL)
  5. 修正弹窗后焦点还保留在原触发按钮元素的问题（使新窗口iframe获得焦点），以解决回车、空格键会再次触发弹窗事件的问题；(@LL)
  6. 优化fnInitInputHelpVal（）【input[text]框默认提示信息；placeholder】方法在某些已知场景下会多次初始化值得问题；(@LL)
  7. 重写原“DT_sumInps”方法（生产环境未正式使用），并更名为 DT_getInputSum；(@LL)
  8. 新增DT_getSelectRowsSourceData方法，用于DT获取指定行的底层数据；(@LL)
  9. 新增DT_getColumnSum方法，用于DT获取指定列的汇总和(@LL)

• 2017-03-21

  1.添加echarts图表DEMO，及数据结构转换方法：COM_TOOLS.eChartsTools.initOpt；详见手册相关单元(@LL)
  2.添加echarts图表更新数据方法：COM_TOOLS.eChartsTools.updateData；详见手册相关单元(@LL)
  3.新增echarts图表iframe嵌入方式DEMO（可外部配置，自适应大小）；(@LL)
  4.修改ueditor部分已知BUG；(@LL)

• 2017-03-07

  1.subindex.js/-ajax.js 修改 cumGetParentWinGlobel()/cumGetParentBodyGlobel() 方法以支持童程crm特殊情况；(@ccj)
  2.datatable-demo 行内计算实例修改（新增不选中行时，可实现表格内自动计算）,DT_sumInps方法添加新的传参；(@ccj)
  3.升级第三方组件datatimepicker.js，并扩展框架初始化配置信息，修复兼容BUG，新增“清除”按钮；（@LL）
  4.扩展提示信息与表单验证信息模型；
  5.修改select2全局初始化配置，及相关样式；增强兼容性；

• 2017-02-23

  1.弹窗组件中新增“callback（回调函数对象列表）”属性，及callParentWinCacheFn()与setCacheFnForChildWin方法；用于实现子弹窗（模板类）回调父窗口中的相关方法 ；(@LL)

• 2017-02-17

  1.新增webuploader组件DEMO页 (@CCJ)
      a.选择文件并上传实例
      b.选择文件自动上传实例
      c.表单内的选择文件自动上传，并包含隐藏域
  2.新增select2语言自动初始化配置，修改demo (@LL)

• 2017-02-10

  1.新增datatable行内编辑，传参table/name(arr);注：需在columns中维护一个name字段。(@CCJ)
  2.新增datatable实现input转td并保存数据，传参table/name(arr)/param；注：需在columns中维护一个name字段，param默认true，false时只获取数据，不转化td。(@CCJ)
  3.新增datatable选中行间的计算,传参table/name(arr)/id；注：需在columns中维护一个name字段，id为要显示结果的DOM元素ID。(@CCJ)
  4.新增JS加法运算方法，用于纠正浮点运算错误。(@CCJ)

• 2017-02-03

  1. 修改弹窗组件 layer.js 新增配置信息："helpBtn":false, /* 帮助按（ ？） 按钮 -url地址或锚链接; false:不启用 */；(@LL)
  2. subindex[-ajax].js； 新增自定义提示信息，使用方法 将需要添加提示信息的元素 class中 加入”js-helpmsg“，然后设置 data-helpmsg="msgkey"； msgkey = TEDU_MESSAGE[key];（@LL）
  3. subindex[-ajax].js； 新增帮助按钮事件（页面元素类）,使用规则与弹窗帮助一致； .js-helpbtn data-helpbtn="#dom2"；(@LL)

• 2017-01-23

  1. 修改jquery-validate.bootstrap-tooltip.min.js 配置信息['container','template'],用于支持自定义样式区分，以及组件可能的定位兼容问题;(@LL)
  2. 修改 styie[-ajax].css tooltip自定义样式；用于解决，和select2、validate等组件共同使用时，可能产生的样式问题；（@LL）
  3. subindex[-ajax].js 新增“ajax 加载tab标签页”公共方法，支持强制reload标签内容扩展属性，全局开始、结束回调方法，以及各标签结束回调方法；（@LL）
  4. 修正subindex-ajax.js 中左右布局滑动动画，导致的部分组件监听丢失、渲染兼容BUG；（@LL）
  5. subindex[-ajax].js 新增COM_TOOLS.requireJsFn(['需要加载的组件数组'],['所需加载组件所依赖的组件数组'],function(){ //TODO; });方法，用于ajaxLoad方式加载的页面如果有新的组件被同时引入时，动态加载所需JS并执行,并完成所加载组件的默认配置信息初始化；（@LL）

• 2017-01-09

  1. 新增中文语言统一扩展变量 TEDU_LANGUAGE,使用COM_TOOLS['_language']='zh-CN'统一配置(包含dataTable,validate,datetimepicker,select2); 新增datetimepicker全局默认缺省配置;(@CCJ)
  2. 修改subindex[-ajax].js新增contentPATH='/'配置属性，项目包名、路径；（@LL）
  3. 修改tedu-languge.js文件，添加“错误提示信息”对象 TEDU_MESSAGE； 使用方法 COM_TOOLS.alert(TEDU_MESSAGE.get('noGetPermission')); 只修改红色字体；详见该文件；（@LL）
  4. 新增按钮鉴权管理方法与本地会话级数据存储方法；（@LL）

• 2017-01-05 @LL

  1. 新增jquery-number组件,用于格式化数字； input实时录入格式化； 数字回显格式化 $(select).number(true,2); $.number(123456,2)，参见datatable-demo#1;
  2. 新增jstree data[jsonObj\listMap]、ajax节点异步等数据源格式及DEMO；
  3. 修改subindex[-ajax].js中datatable-option => scrollX: true, //默认显示水平滚动条；

• 2016-12-29 @LL

  1. 修改 subindex[-ajax].js 添加datatable（右侧列表）自适应行数，其它页面必须指定行数；
  2. 修改 layer.js end 回调方法，添加 额外 自定义配置属性：other:{"noTriEnd":true}；从而控制点击右上角的X关闭弹出时（cancel）不执行end回调方法；
  3. 修改 dataTables.select.min.js ，添加对模拟复选框添加过滤，解决有文字选中状态下，不能点击选中行的问题
  4. 修改style[-ajax].css文件，新增、修改datatable模拟复选框样式；
  5. 修改修改datatable-demo 复选框（input-checkbox）为模拟复选框(className)；
  6. 修改组件 layer.close(index,noTriEnd_); ADD::[cumCloseWin(index,noTriEnd_)]方法, 新增状态noTriEnd_ 是否阻止触发END回调方法；true；

• 2016-12-21 @LL

  创建：
  更新 datapicker—— CSS/js(配置属性)、 subindex[-ajax].js、 style[-ajax].css
  新建/更新 ajax-demo/ 中demopage（参照platform,线上不包含此目录）