common.js相关方法调用介绍(v5.0)
    2021-12-15
  
描述

  common.js是MLECMS官方提供的前端 JavaScript 库,极大地简化了 JavaScript 编程。

前期工作

  引入common.js文件   

1、设置cookie

调用方法
  
mle.setcookie()

相关参数

  共有2个必填参数,3个可选参数:
   1、Cookie 变量名,必填
   2、Cookie 变量值,必填
   3、Cookie 保存周期(秒),缺省值为浏览器进程
   4、作用路径,缺省值为"/"
   5、作用域,缺省值为当前域名

2、获取cookie

调用方法
  
mle.getcookie()

相关参数

  共有1个必填参数:
   1、Cookie 变量名
   2、按比例调整图像大小:
   获取源图片大小,按比例缩小至指定大小,保证图片缩小不变形。该方法无需Jq支持。注意必须加一个外围容器指定同当前图片大小,并隐藏超出部分。img标签中须定义 width 和 height,此方法会自动获取该值

调用方法

  
mle.img_auto_size()

相关参数

  共有1个必填参数:
   1、DOM Image对象

调用实例
  

4、会员登录

  不需要验证码验证,如需要验证码可加到JS判断。该方法基于Jquery实现,请先引入Jquery.js。

调用方法
  
mle.login()

相关参数

  共有2个必填参数:
   1、登录用户名文本域ID
   2、登录密码文本域ID

结果回调

  请求成功执行一个名为 "ajax_login_result(result)" 的函数,函数中的变量 result 表示执行结果: 返回一个一维数组时表示登录成功
   0:用户不存在,或者被删除
   -1:密码错误
   -2:等待用户邮件验证
   -3:等待管理员手工验证审核
   -4:帐号被管理员禁止登录
   -5:登录失败,未知错误

调用实例
  





5、Ajax顶帖[评论支持操作]

  该方法基于Jquery实现,请先引入Jquery.js。

调用方法
  
mle.support()

相关参数

  共有2个必填参数:
   1、评论ID,支持的评论ID
   2、当前 onclick 事件对象,本函数中无用,ajax_support_result 中使用,将 t 传入 ajax_support_result 函数中处理显示顶帖成功后的动作

结果回调

  请求成功执行一个名为 "ajax_support_result(result)" 的函数,函数中的变量 result 表示执行结果:
   0写入出错
   1顶帖成功
   -1顶帖过于频繁,已顶过

调用实例
  


顶[0]

6、判断数组中是否包含某个元素

调用方法
  
mle.in_array()

相关参数

  共有2个必填参数:
   1、要搜索的值,不支持数组、对象
   2、需要搜索的数组

调用实例

  判断a数组里是否存在1   
var a = [0,1,2,3,4,5]
if(mle.in_array(1,a)){
    alert('存在');
}else{
    alert('不存在');
}

7、检查一个变量是否为空

  ""、0、"0"、NULL、FALSE、array()、var $var; 以及没有任何属性的对象都将被认为是空

调用方法
  
mle.empty()

相关参数

  共有1个必填参数:
   1、待检查的变量

调用实例

  1、判断a数组是否为空(空的)   
var a = []
if(mle.empty(a)){
    alert('空的');
}else{
    alert('非空');
}

  2、判断a对象是否为空(非空)   
var a = {}
if(mle.empty(a)){
    alert('空的');
}else{
    alert('非空');
}

8、检测是否是一个数字

调用方法
  
mle.is_numeric()

相关参数

  共有1个必填参数:
   1、待检查的变量

9、数字整形,不是数字或小于0的数字则返回 0

调用方法
  
mle.numeric()

相关参数

  共有1个必填参数:
   1、待转型的变量

10、生成随机整数

调用方法
  
mle.rand()

相关参数

  共有2个必填参数:
   1、随机整数的最小值
   2、随机整数的最大值

11、js原生封装ajax(GET)

调用方法
  
mle.ajax.get()

相关参数

  共有1个必填参数,2个可选参数:
   1、规定发送请求的url,必填
   2、自定义回调方法
   3、是否开启异步请求,true开启 false关闭

调用实例
  
mle.ajax.get('test.kyger.com/app.php?id=1',function(){
    alert('请求成功');
})

12、js原生封装ajax(POST)

调用方法
  
mle.ajax.post()

相关参数

  共有1个必填参数,3个可选参数:
   1、规定发送请求的url,必填
   2、POST数据
   3、自定义回调方法
   4、是否开启异步请求,true开启 false关闭

调用实例
  
var data = {
    "name": "广东凯格",
    "icon": "inc/images/logo.png"
}
mle.ajax.post('test.kyger.com/app.php?id=1',data,function(){
    alert('请求成功');
})

13、框架页

  该方法适用于快速调起框架页,如果有特别需求请到layer.js官网查询更多用法。
  该方法基于Layer实现,请先引入layer.js。

前期准备
  

调用方法
  
mle.iframe()

相关参数

  共有2个必填参数,2个可选参数:
   1、规定框架页标题
   2、规定发送请求的url,必填
   3、框架页的宽,传递字符串,带上单位
   4、框架页的高,传递字符串,带上单位

调用实例
  
mle.iframe('凯格官网','http://www.kyger.com.cn',‘400px’,'800px')