命名空间为
a
p
i
,
所
有
方
法
如
下
(
摘
自
官
网
h
t
t
p
s
:
/
/
d
o
c
s
.
a
p
i
c
l
o
u
d
.
c
o
m
/
F
r
o
n
t
−
e
n
d
−
F
r
a
m
e
w
o
r
k
/
f
r
a
m
e
w
o
r
k
−
d
e
v
−
g
u
i
d
e
)
;
1
、
api,所有方法如下(摘自官网https://docs.apicloud.com/Front-end-Framework/framework-dev-guide); 1、
api,所有方法如下(摘自官网https://docs.apicloud.com/Front−end−Framework/framework−dev−guide);1、api.trim(’ abc 123 ‘) // =>“abc 123” 去除前后空格
2、
a
p
i
.
t
r
i
m
A
l
l
(
"
a
b
c
123
"
)
/
/
=
>
"
a
b
c
123
"
去
除
所
有
空
格
字
符
串
3
、
api.trimAll(" abc 123 ") // =>"abc123" 去除所有空格字符串 3、
api.trimAll("abc123")//=>"abc123"去除所有空格字符串3、api.isArray(obj) //=>boolean 判断是否为数组
4、
a
p
i
.
a
d
d
E
v
t
(
e
l
,
n
a
m
e
,
f
n
)
e
l
为
d
o
m
元
素
,
n
a
m
e
为
事
件
名
称
(
‘
c
l
i
c
k
’
)
,
f
n
回
调
函
数
,
为
元
素
绑
定
事
件
5
、
api.addEvt(el,name,fn) el为dom元素,name为事件名称(‘click’),fn回调函数, 为元素绑定事件 5、
api.addEvt(el,name,fn)el为dom元素,name为事件名称(‘click’),fn回调函数,为元素绑定事件5、api.rmEvt(el,name,fn) ,参数同上,为元素移除绑定事件
6、
a
p
i
.
o
n
e
(
e
l
,
n
a
m
e
,
f
n
)
,
参
数
同
上
,
为
元
素
绑
定
事
件
,
只
执
行
一
次
7
、
api.one(el,name,fn),参数同上,为元素绑定事件,只执行一次 7、
api.one(el,name,fn),参数同上,为元素绑定事件,只执行一次7、api.dom(el,selector),返回dom元素,当包含el参数时,从el节点开始查找,若无el元素,则从document开始查找;如$api.dom(’.username’) //
a
p
i
.
d
o
m
(
′
.
l
i
s
t
[
t
y
p
e
=
"
t
e
x
t
"
]
′
)
;
8
、
api.dom('.list[type="text"]'); 8、
api.dom(′.list[type="text"]′);8、api.domAll(el,selector),参数使用同7,选择所有的匹配元素 如
a
p
i
.
d
o
m
A
l
l
(
′
.
c
l
a
s
s
′
)
;
api.domAll('.class');
api.domAll(′.class′);api.domAll(’.list:fist-child’);
9、
a
p
i
.
b
y
I
d
(
′
s
t
i
n
g
I
D
′
)
;
根
据
i
d
获
取
d
o
m
元
素
;
10
、
api.byId('stingID');根据id获取dom元素; 10、
api.byId(′stingID′);根据id获取dom元素;10、api.first(el,selector) 获取选择dom元素的第一个子元素;有两个参数时返回dom元素下的第一个css选择器的元素,如
a
p
i
.
f
i
r
s
t
(
e
l
,
′
l
i
′
)
则
返
回
e
l
下
的
第
一
个
l
i
;
如
只
有
一
个
参
数
e
l
,
则
返
回
e
l
下
的
第
一
个
子
元
素
;
11
、
api.first(el,'li')则返回el下的第一个li;如只有一个参数el,则返回el下的第一个子元素; 11、
api.first(el,′li′)则返回el下的第一个li;如只有一个参数el,则返回el下的第一个子元素;11、api.last(el,elector) 获取选择dom元素的最后一个子元素,用法同10;
12、
a
p
i
.
e
q
(
e
l
,
i
n
d
e
x
)
,
选
择
d
o
m
元
素
的
第
i
n
d
e
x
个
子
元
素
;
13
、
api.eq(el,index),选择dom元素的第index个子元素; 13、
api.eq(el,index),选择dom元素的第index个子元素;13、api.not(el,selector),返回比匹配选择器的所有子元素;例如
a
p
i
.
n
o
t
(
e
l
,
′
.
a
c
t
i
v
e
′
)
;
14
、
api.not(el,'.active'); 14、
api.not(el,′.active′);14、api.prev(el),选择相邻的前一个元素;
15、
a
p
i
.
n
e
x
t
(
e
l
)
,
选
择
相
邻
的
下
个
d
o
m
元
素
16
、
api.next(el),选择相邻的下个dom元素 16、
api.next(el),选择相邻的下个dom元素16、api.contains(parentEL,targetEL),返回boolean,判断一个元素是否包含目标元素;
17、
a
p
i
.
c
l
o
s
e
s
t
(
e
l
,
s
e
l
e
c
t
o
r
)
,
根
据
选
择
器
匹
配
最
近
的
父
元
素
;
api.closest(el,selector),根据选择器匹配最近的父元素;
api.closest(el,selector),根据选择器匹配最近的父元素;api.closest(el, ‘.parent’);
18、
a
p
i
.
r
e
m
o
v
e
(
e
l
)
,
移
除
d
o
m
元
素
;
19
、
api.remove(el),移除dom元素; 19、
api.remove(el),移除dom元素;19、api.attr() 获取或设置元素属性;
设置 $api.attr(el,‘key’,‘val’) 获取
a
p
i
.
a
t
t
r
(
e
l
,
′
k
e
y
′
)
;
20
、
api.attr(el,'key'); 20、
api.attr(el,′key′);20、api.removeAttr(el,‘属性名’) 移除dom元素的属性
21、
a
p
i
.
h
a
s
C
l
s
(
e
l
,
′
c
l
a
s
s
n
a
m
e
′
)
,
返
回
b
o
o
l
e
a
n
判
断
d
o
m
元
素
是
否
含
有
某
个
c
l
a
s
s
N
a
m
e
22
、
api.hasCls(el,'classname'),返回boolean 判断dom元素是否含有某个className 22、
api.hasCls(el,′classname′),返回boolean判断dom元素是否含有某个className22、api.addCls(el,‘classname’),为dom元素添加className;
23、
a
p
i
.
r
e
m
o
v
e
C
l
s
(
e
l
,
′
c
l
a
s
s
n
a
m
e
′
)
,
为
d
o
m
元
素
移
除
c
l
a
s
s
;
23
、
api.removeCls(el,'classname'),为dom元素移除class; 23、
api.removeCls(el,′classname′),为dom元素移除class;23、api.toggleCls(el,‘classname’),为dom元素切换指定class;
24、
a
p
i
.
v
a
l
(
e
l
,
v
a
l
)
,
获
取
或
设
置
常
用
f
o
r
m
表
单
元
素
的
v
a
l
u
e
值
;
获
取
.
v
a
l
(
e
l
)
;
设
置
(
e
l
,
v
a
l
)
;
25
、
api.val(el,val),获取或设置常用form表单元素的value值;获取.val(el); 设置(el,val); 25、
api.val(el,val),获取或设置常用form表单元素的value值;获取.val(el);设置(el,val);25、api.prepend(el,html);在dom元素内部,首个子元素前插入html字符串;
a
p
i
.
p
r
e
p
e
n
d
(
e
l
,
′
<
l
i
>
h
e
l
l
o
<
/
l
i
>
′
)
;
26
、
api.prepend(el,'<li>hello</li>'); 26、
api.prepend(el,′<li>hello</li>′);26、api.append(el,html);在dom元素内部,最后一个子元素后插入html字符串;
a
p
i
.
a
p
p
e
n
d
(
e
l
,
′
<
l
i
>
h
e
l
l
o
<
/
l
i
>
′
)
;
27
、
api.append(el,'<li>hello</li>'); 27、
api.append(el,′<li>hello</li>′);27、api.before(el,html);在dom元素前面插入html字符串;
a
p
i
.
b
e
f
o
r
e
(
e
l
,
′
<
h
1
>
w
o
r
l
d
<
/
h
1
>
′
)
;
28
、
api.before(el,'<h1>world</h1>'); 28、
api.before(el,′<h1>world</h1>′);28、api.after(el,html);在dom元素之后插入html字符串;
a
p
i
.
b
e
f
o
r
e
(
e
l
,
′
<
h
1
>
w
o
r
l
d
<
/
h
1
>
′
)
;
29
、
api.before(el,'<h1>world</h1>'); 29、
api.before(el,′<h1>world</h1>′);29、api.html(el,html); 获取或设置dom元素的innerHTML;
获取 .html(el); 设置 .html(el,‘
world
’);30、 p a i . t e x t ( e l , t e x t ) , 获 取 或 设 置 元 素 的 文 本 内 容 ; 31 、 pai.text(el,text),获取或设置元素的文本内容; 31、 pai.text(el,text),获取或设置元素的文本内容;31、api.offset(el),获取元素在页面中的位置与宽高(此为距离页面左侧及顶端的位置,并非距离窗口的位置)
var offset = $api.offset(el);
var left = offset.l;
var top = offset.t;
var width = offset.w;
var height = offset.h;
32、
a
p
i
.
c
s
s
(
e
l
,
c
s
s
)
;
设
置
所
传
入
的
d
o
m
元
素
的
样
式
,
可
传
入
多
条
样
式
;
api.css(el,css);设置所传入的dom元素的样式,可传入多条样式;
api.css(el,css);设置所传入的dom元素的样式,可传入多条样式;api(el,‘width:80px;border:1px solid red;’);
33、
a
p
i
.
c
s
s
V
a
l
(
e
l
,
p
r
o
p
)
;
获
取
制
定
d
o
m
元
素
的
制
定
属
性
的
完
整
的
值
,
如
800
p
x
;
api.cssVal(el,prop);获取制定dom元素的制定属性的完整的值,如800px;
api.cssVal(el,prop);获取制定dom元素的制定属性的完整的值,如800px;api.cssVal(el,‘width’);
34、
a
p
i
.
j
s
o
n
T
o
S
t
r
(
j
s
o
n
)
将
标
准
的
j
s
o
n
对
象
转
换
成
字
符
串
格
式
;
35
、
api.jsonToStr(json) 将标准的json对象转换成字符串格式; 35、
api.jsonToStr(json)将标准的json对象转换成字符串格式;35、api.strToJson(str) 将json字符串转换成json对象;
36、
a
p
i
.
s
e
t
S
t
o
r
a
g
e
(
k
e
y
,
v
a
l
u
e
)
;
设
置
l
o
c
a
l
S
t
o
r
a
g
e
数
据
;
api.setStorage(key,value); 设置 localStorage 数据;
api.setStorage(key,value);设置localStorage数据;api.setStorage(‘name’,‘tom’);
37、
a
p
i
.
g
e
t
S
t
o
r
a
g
e
(
k
e
y
)
,
获
取
l
o
c
a
l
S
t
o
r
a
g
e
内
容
使
用
;
必
须
配
合
api.getStorage(key),获取localStorage内容使用;必须配合
api.getStorage(key),获取localStorage内容使用;必须配合api.setStorage()配套使用;
a
p
i
.
g
e
t
S
t
o
r
a
g
e
(
′
n
a
m
e
′
)
;
38
、
api.getStorage('name'); 38、
api.getStorage(′name′);38、api.rmStorage(key);清除与localStorage中与键名对应的值;
39、$api.clearStorage() 清除所有的localStorage的数据;慎用;
a
p
i
.
c
l
e
a
r
S
t
o
r
a
g
e
(
)
;
40
、
api.clearStorage(); 40、
api.clearStorage();40、api.fixStatusBar(el);适配IOS7.0+、Android4.4+系统状态栏,为传入的dom元素增加适当的上内边距,鼻渊header与状态栏重合;
备注:自动识别iOS7+,避免应用与状态栏重叠,无法跟config.xml里面的 一起使用。
var header = document.querySelector('#header');
$api.fixStatusBar(header);
41、$api.toast(title,text,time);延时提示框;
title:类型string 标题,可选参数; text :类型string,内容,可选参数; time :类型number ,提示框存在时间,单位毫秒,默认值500,
$api.toast('你好啊');
$api.toast(2000);
$api.toast(‘你好啊’,2000);
$api.toast('你好啊','延时提示框');
$api.toast('演示',‘延时提示框’,1000);
42、$api.get(url,fnSuc,datatype); $api.ajax()方法的get方式简写
$api.get('http://www.pm25.in/api/querys/pm2_5.json?city=beijing&token=5j1znBVAsnSf5xQyNQyq',function(ret){
alert(ret);
},'text');
43、$api.post(url,data,fnSuc,dataType); $api.ajax()方法的post方式简写
$api.post('http://192.168.1.233:4321/getString',{
body: 'String'
},function(ret){
alert(ret);
},'text');