后台JS函数
本篇主要介绍后台内置的js函数，注意：所有内置的js函数都包含在cscms对象中
集成工具：jQuery、Layui
为方便用户快捷上手开发，我们在程序中集成了jQuery和Layui；jQuery是一款快速、简洁的JavaScript框架，可适应各种场景的需要；Layui是一款丰富的前端框架，具有优秀的web弹层组件
对于jQuery：直接使用jQuery的语法即可
对于Layui：我们在cscms对象中加载了element、form、upload、laydate、layer、layedit这6个模块,若使用某模块时，则用cscm.模块名来调用即可;以下仅为部分功能展示，更多功能可参考layui的官方文档
函数示例
- //具备layui的所有功能，仅调用略有不同
- //举例：msg弹出提示
- cscms.layer.msg('这是cscms的弹出提示');
- cscms.layer.msg('这是cscms的成功时的弹出提示',{icon:2});
- cscms.layer.msg('这是cscms的失败时的弹出提示',{icon:2});
- //举例：alert确认框
- cscms.layer.alert('内容');
- //举例：confirm询问框
- cscms.layer.confirm('您是如何看待前端开发？', {
- btn: ['重要','奇葩'] //按钮
- }, function(){
- layer.msg('的确很重要', {icon: 1});
- }, function(){
- layer.msg('也可以这样', {
- time: 20000, //20s后自动关闭
- btn: ['明白了', '知道了']
- });
- });
初始化后执行：cscms.mode(func)
该函数用来在layui模块初始化完成后执行相关操作，初始化操作是在页面的底部进行的，并且初始化需要等待几毫秒；若在页面的中间或者上面使用layer的功能，需要等待初始化完成后才能执行，一般情况下是不需要该操作的，仅在页面加载完成前或页面加载完成时立即执行的layui相关的操作才会需要该函数
| 参数 | 属性值 | 备注 |
|---|---|---|
| func | 需要执行的操作 | 把操作代码当作字符串传入 |
| title | 窗口标题 | 弹出新窗口的标题，即提示用户该窗口是做什么的 |
函数示例
- //页面加载为完成时执行cscms.layer.msg('弹出提示')的操作
- cscms.mode("cscms.layer.msg('弹出提示')");
下拉框页面跳转：cscms.goto_page(url)
该函数用于下拉框的页面跳转，下拉框select的id必须设置为goto_page；然后只需在跳转按钮上设置onclick="cscms.goto_page('www.xxx.com/test/index?page=')"即可，url和页面是拼接关系
弹出窗口：cscms.get_open(url,title,w,h)
该函数用来在屏幕中央弹出一个新窗口
| 参数 | 属性值 | 备注 |
|---|---|---|
| url | 窗口链接地址 | 准备在窗口中展示内容的URL地址 |
| title | 窗口标题 | 弹出新窗口的标题，即提示用户该窗口是做什么的 |
| w | 窗口宽度 | 弹出窗口的宽度，单位px |
| h | 窗口高度 | 弹出窗口的高度，单位px |
函数示例
- //用小窗口打开cscms官网
- cscms.get_open('www.chshcms.com','CSCMS v4.x官网','500px','300px');
全选反选函数：cscms.select_all()
该函数用于复选框的全选和反选，只需在复选框的input上增加class="xuan"，然后在全选反选的按钮上设置onclick="cscms.select_all()"即可
单项删除：cscms.del_one(url,id)
该函数用来删除某条数据，并在成功后移除该数据行，假设要删除id=1024的数据则，该数据行的id为row_1024；如删除id=1024的数据，则只需在删除按钮上设置onclick="cscms.del_one('www.xxx.com/index.php/del',1024)"
| 参数 | 属性值 | 备注 |
|---|---|---|
| url | 执行删除的url | 如：音乐板块为/index.php/dance/admin/dance/del |
| id | 数据id | 该数据行的id |
单选状态切换：cscms.show_hide(cls,name)
该函数用于切换显示状态的，即当单选结果变化时，切换与其相关的元素的状态；比如：有两个单选按钮，网站开启和网站关闭，一个input输入框作为关闭网站时的提示信息；那么点击网站开启，隐藏input；点击网站关闭，显示input；这时就可使用该函数实现
| 参数 | 属性值 | 备注 |
|---|---|---|
| cls | 元素的class | 凡是需要显示或者隐藏的元素都需加上该clss |
| name | 单选框的name | 同组单选框的name属性值 |
文件上传：cscms.getUpload(url,id,elem,accept,sign)
该上传函数没有上传进度展示，主要用于偏小的文件上传，比如会员logo、图片等
| 参数 | 属性值 | 备注 |
|---|---|---|
| url | 处理上传文件url | 指定上传的URL，完整路径 |
| id | 元素id | 点击响应上传的元素的id,如点击button按钮进行上传，则id即为button的id；可留空，默认pic |
| elem | 返回值保存元素的id | 上传成功后，返回文件的路径url，若让url在一个input中显示，则即为该input元素的id；可留空，默认pics |
| accept | 指定文件格式 | 多个格式用|分割，如图片格式：jpg|jpeg|bmp|gif，可留空，默认为图片 |
| sign | 返回值保存方式 | 0：直接覆盖，1：末尾追加，可留空，默认0 |
函数示例
- <form action="www.xxx.com/picdata/save">
- <input id="pic" value="" />
- <button id="pics">上传图片</button>
- <script type="text/javascript">
- cscms.mode("cscms.getUpload('www.xxx.com/upload/save','pic','pics','jpg|gif|png',0)");
- </script>
- </form>
链接访问函数：cscms.go_url(url)
该函数为链接访问函数，返回json数据，error=0为成功，其他则为失败，格式参见getjson函数；当返回值data对象中 data.info.url 存在时则跳转到 data.info.url；否则弹出提示 data.info.msg
| 参数 | 属性值 | 备注 |
|---|---|---|
| url | 访问链接地址 |
提交选中项：cscms.sel_submit(url,cid)
该函数用于提交选中的项，注意：相应复选框的input上应有class="xuan"，提交方法为post，提交参数id为数组，cid参数表示是否提交分类id，默认为空不提交
| 参数 | 属性值 | 备注 |
|---|---|---|
| url | 接收数据的 | |
| cid | 提交分类参数 | 默认为空，不提交分类参数，当值不等于0不为空时表示提交分类参数，参数名为cid，参数值由$('#zhuan option:selected') .val()获取，多用于分类转移的操作 |
询问提交：cscms.go_confirm(url,title,sign)
该函数访问链接之前会弹出一个询问框，若确定则继续访问，若取消则停止访问
| 参数 | 属性值 | 备注 |
|---|---|---|
| url | 接收数据的 | |
| title | 提示语句 | 展示给用户，让用户选择确定还是取消 |
| sign | 0，1，2 | 0：确定后用cscms.go_url(url)提交；1：确定后用cscms.sel_submit(url)提交；2：确定后用cscms.sel_submit(url,sign)提交 |
选中生成：cscms.go_html(url)
该函数用于将选中数据项生成静态html，需在复选框的input上增加class="xuan"
| 参数 | 属性值 | 备注 |
|---|---|---|
| url | 链接地址 | 生成静态文件的地址 |
星级推荐：cscms.get_tj(url,td_,id,sid)
该函数用于对数据设置推荐级别
| 参数 | 属性值 | 备注 |
|---|---|---|
| url | 推荐处理地址 | |
| td_ | 父元素id参数 | 一般可设置父元素的id属性为'tj_'拼接数据id，则参数td_即可为'tj_' |
| id | 数据项的id | |
| sid | 推荐星数 | 0：不推荐；1：推荐1星；2：推荐2星；3：推荐3星；4：推荐4星；5：推荐5星 |
批量修改：cscms.pl_edit(url,title,w,h)
该函数用于显示批量修改界面，复选框input需有class="xuan"属性
| 参数 | 属性值 |
|---|---|
| url | 批量处理地址 |
| title | 修改框的标题 |
| w | 弹出修改框的宽度 |
| h | 弹出修改框的高度 |
日期时间：cscms.getTime(elem,type)
该函数用于选择日期时间，只需要给input设置一个id即可，然后在<script></script>中绑定该id即可
| 参数 | 属性值 | 备注 |
|---|---|---|
| elem | 日期input的id | 需要选择时间的input的id值 |
| type | 日期的类型 | date:短日期如2017-01-01 ；datetime：长日期如：2017-01-01 00:00:00,可留空，默认为date短时间 |
函数示例
- <input id="mydate" value="" />
- <script>
- cscms.mode("cscms.getTime('mydate','datetime')");
- </script>