前台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.get_host()
该函数的返回值为当前网站的域名
函数示例
- var domain = cscms.get_host();
- console.log(domain);
弹出窗口: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.scroll(id)
该函数用于滚动到页面的指定位置,如:评论的输入框id为cscms_pl_content,则使用cscms.scroll('cscms_pl_content')就可以把页面滚动到输入框的位置,若给顶部和底部设置id,也同样可以滚动到顶部或底部
参数 | 属性值 | 备注 |
---|---|---|
id | 滚动到指定位置 | 需要为一个元素设置id,然后调用 cscms.sroll(id) 即可滚动到该位置 |
异步加载js:cscms.inc_js(path)
该函数用于异步加载js,参数path为该js的绝对路径
参数 | 属性值 |
---|---|
path | js的绝对路径 |
初始化后执行:cscms.mode(func)
该函数用来在layui模块初始化完成后执行相关操作,初始化操作是在页面的底部进行的,并且初始化需要等待几毫秒;若在页面的中间或者上面使用layer的功能,需要等待初始化完成后才能执行,一般情况下是不需要该操作的,仅在页面加载完成前或页面加载完成时立即执行的layui相关的操作才会需要该函数
参数 | 属性值 | 备注 |
---|---|---|
func | 需要执行的操作 | 把操作代码当作字符串传入 |
title | 窗口标题 | 弹出新窗口的标题,即提示用户该窗口是做什么的 |
函数示例
- //页面加载为完成时执行cscms.layer.msg('弹出提示')的操作
- cscms.mode("cscms.layer.msg('弹出提示')");
文件上传一: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.get_upurl(dir,fid,type,tsid)
该上传函数会展示一个弹框,宽高自适应,手机宽为屏幕90%、高为350px;电脑宽为500px、高350px;且具有进度条显示,可用于需要进度条的上传方式
参数 | 属性值 | 备注 |
---|---|---|
dir | 板块标识 | 上传文件的板块标识,如音乐板块dance |
fid | 返回值保存元素的id | 上传成功后,返回文件的路径url,若让url在一个input中显示,则即为该input元素的id |
type | 指定文件格式 | 多个格式用|分割,如图片格式:jpg|jpeg|bmp|gif;可留空,默认为图片 |
tsid | 提示性语句id | 如上传完成后想在<span id="up_msg"></span>中提示,则tisd的值为up_msg,可留空 |
函数示例
- <form action="www.xxx.com/picdata/save">
- <input id="pic" value="" />
- <span id="up_msg">等待上传...</span>
- <button onclick="cscms.get_upurl('dance','pic','jpg|png|gif|bmp|jpeg','up_msg')">上传图片</button>
- </form>
日期时间: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>