cmp.util 类

工具类

方法

after

after
(
  • target
  • html
)

定义于 doc\doc\cmp_doc_all\cmp-core-doc.js:1138

在指定的元素的后面添加html字符串

参数:

名称类型标识描述
target HtmlObject 必选

//指定的html元素

html String 必选

//html字符串(请注意需要传html格式的字符串)

示例:

//html
<div id="parent">
    <div id="target"></div>
</div>
//js调用
<script>
    var target = document.getElementById("target");
    var htmlString = "<div class='cmp-class' style="color:red">被after进行的html</div>"
    cmp.after(target,htmlString)
</script>

//得到的html如下：
<div id="parent">
    <div id="target"></div>
    <div class='cmp-class' style="color:red">被after进行的html</div>
</div>

append

append
(
  • parent
  • html
)

定义于 doc\doc\cmp_doc_all\cmp-core-doc.js:1087

添加可直接append html字符串的方法

参数:

名称类型标识描述
parent HtmlObject 必选

//父容器

html String 必选

//html字符串(请注意需要传html格式的字符串)

示例:

//html
<div id="parent"></div><!--父容器-->
//js调用
<script>
    var parent = document.getElementById("parent");
    var htmlString = "<div class='cmp-class' style="color:red">被append进行的html</div>"
    cmp.append(parent,htmlString)
</script>

//得到的html如下:
<div id="parent">
    <div class='cmp-class' style="color:red">被append进行的html</div>
</div>

before

before
(
  • target
  • html
)

定义于 doc\doc\cmp_doc_all\cmp-core-doc.js:1111

在指定的元素的前面添加 html字符串

参数:

名称类型标识描述
target HtmlObject 必选

//指定的html元素

html String 必选

//html字符串(请注意需要传html格式的字符串)

示例:

//html
<div id="parent">
    <div id="target"></div>
</div>
//js调用
<script>
    var target = document.getElementById("target");
    var htmlString = "<div class='cmp-class' style="color:red">被before进行的html</div>"
    cmp.before(target,htmlString)
</script>

//得到的html如下：
<div id="parent">
    <div class='cmp-class' style="color:red">被before进行的html</div>
    <div id="target"></div>
</div>

buildUUID

buildUUID
(
  • [len]
)
String

定义于 doc\doc\cmp_doc_all\cmp-core-doc.js:1058

uuid 生成器

参数:

名称类型标识描述
[len] Number 可选

自定义生成的uuid的长度（可以不定义）

返回值:

[String]

uuid

示例:

<script>
    var uuid =  cmp.buildUUID()
</script>

closeM3App

closeM3App ()

定义于 doc\doc\cmp_doc_all\cmp-core-doc.js:1210

关闭M3 app，用于Android客户端双击返回按钮提示关闭M3 app

示例:

<script>
    cmp.ready(function(){
         cmp.backbutton();  //劫持Android返回按钮事件
         cmp.backbutton.push(cmp.closeM3App);  //返回按钮堆栈push关闭M3的函数
    });
</script>

extend

extend
(
  • object1;被合并的对象
  • object2:合并的对象
)
Object

定义于 doc\doc\cmp_doc_all\cmp-core-doc.js:1043

对象合并工具，生成一个新对象

参数:

名称类型标识描述
object1;被合并的对象 Object 必选
object2:合并的对象 Object 必选

返回值:

[Object]

返回一个合并后的新对象

示例:

<script>
    cmp.extend({key1:null,key2:"key2default"},{key1:"key1Value",key2:"key2newValue"}) //合并的值为{key1:"key1Value",key2:"key2Value"}
</script>

getLeft

getLeft
(
  • target
)
Number

定义于 doc\doc\cmp_doc_all\cmp-core-doc.js:1180

获取指定元素的绝对left值

参数:

名称类型标识描述
target HtmlObject 必选

//指定的html元素

返回值:

[Number]

返回元素处于页面中的绝对left值

示例:

<script>
    var target = document.getElementById("target");
    var left = cmp.getLeft(target)//40
</script>

getTop

getTop
(
  • target
)
Number

定义于 doc\doc\cmp_doc_all\cmp-core-doc.js:1165

获取指定元素的绝对top值

参数:

名称类型标识描述
target HtmlObject 必选

//指定的html元素

返回值:

[Number]

返回元素处于页面中的绝对top值

示例:

<script>
    var target = document.getElementById("target");
    var top =  cmp.getTop(target)//30
</script>

parents

parents
(
  • target
  • attr
)

定义于 doc\doc\cmp_doc_all\cmp-core-doc.js:1195

查询指定元素的所有父元素

参数:

名称类型标识描述
target HtmlObject 必选

指定的html元素

attr String 必选

过滤属性，如果定义了attr参数，则查询指定元素的父元素中有该属性的父元素

示例:

<script>
    var target = document.getElementById("target");
    cmp.parents(target,"binded") //获取所有有binded属性的父元素
</script>

time

time
(
  • ms
  • withDate
)
String

定义于 doc\doc\cmp_doc_all\cmp-core-doc.js:1072

将timestamps 转为 yyyy-MM-dd hh:mm格式(此方法兼容了时区导致的时间不与中国时间同步的问题)

参数:

名称类型标识描述
ms Number 必选

毫秒值(1970年至今的毫秒数)

withDate Boolean 必选

是否包含日期 不传默认不包含日期

返回值:

[String]

日期格式的字符串，如2016-08-31 8:10:10

示例:

<script>
     var formatTime = cmp.time(182738127,true);//2017-03-11
</script>
Top