腾讯微博 JS-SDK接入
官方文档:
1.接口初始化
加载openjs源代码。
<script type="text/javascript" src="http://mat1.gtimg.com/app/openjs/openjs.js"></script>
初始化
T.init({
appkey: 123456 //执行初始化,appkey为123456
});
描述
Object T.init(Object initObject)
T.int执行初始化。
参数
initObject 必选,初始化参数选项。更多可配置参数,请参考initObject
返回
T
2.获取数据API接口
描述
1
2 |
<span style= ‘font-family: "courier new", courier;‘ >Object T.api(String apiName [,Object apiParams [,String dataType [,String type]]]) </span> |
参数: apiName 必选,API接口名称。
A.apiParams 可选,该接口对应的JSON格式的参数表。
B.dataType 可选,json或xml,默认为json。
C.type 可选,GET或POST,默认为GET。
返回 : DeferredObject
T.api("/status/public_timeline",null,"json","GET")
.success(function (response) {
//调用成功
alert("成功")
})
.error(function (code, message){
//调用失败
alert(message)
});
3. task 任务组。(FB平台上面没有看到这类功能接口)
描述:
Object T.task(DeferredObject action [,DeferredObject action[,DeferredObject action [,...]]])
T.task可创建任务组,可用来同时完成多项任务,如调用腾讯微博API接口或其它返回DeferredObject的接口。
参数 : action 必选,DeferredObject延时对象。
返回: DeferredObject
T.task(
T.api("/statuses/home_timeline"), // 这是第一个任务
T.api("/statuses/public_timeline") // 这是第二个任务
//... 可以在这里创建多个任务
)
.success(function (homeData,publicData) {// 两项任务均成功,数据依次回调
//标明两个任务均成功
alert("成功");
})
.error(function (code, message){// 有任务发生了失败
//任务中有失败的情况
alert(message);
})
.complete(function () { // 两个任务均有结果,不管其为成功还是失败
//
alert("任务执行完毕");
});
4.重要事件
1)tokenReady
描述
Object T.tokenReady(Function handler)
T.tokenReady 保证用户登录状态确定后执行。
如用户登录态已准备好,则直接执行回调函数,否则等待至用户登录态准备好后触发。 参阅事件和openjs支持的六种事件。
T.tokenReady( function () { //登录态已准备好 var loginStatus = this.loginStatus(); if (loginStatus.access_token) { alert("access_token = " + loginStatus.access_token); } });
2)documentReady
描述
Object T.documentReady(Function handler)
T.documentReady 保证DOM可操作后执行。
如DOM已可操作,则直接执行handler。否则等待至DOM可操作再执行handler,与jQuery.ready方法等同。
T.documentReady( function () { alert(“DOM is ready”); });
3)ready
描述
Object T.ready(Function handler)
T.ready保证回调函数在用户登录态和DOM均可操作后执行。
如用户登录态和DOM都已可操作,则直接执行handler。否则等待至条件满足后执行。(T.ready相当于documentReady并且tokenReady)。
T.ready( function () { alert(“everything is ready”); });
7.辅助接口
1)localStorage对象
- localStorage提供跨浏览器的数据本地存储支持,兼容绝大多数主流浏览器,方便应用存储离线数据到用户的浏览器端,以增强客户端体验。
T.localStorage.save
描述
Object T.localStorage.save(String key, Mixed value [,Number expires])
T.localStorage.save存储键值到浏览器本地存储空间中。
参数
key 必选,键名。
value 必选,键值。 expires 可选,数据过期时间,以天为单位。默认为7天。
返回
value {Mixed} 保存在本地存储空间中的值(可以据此判断存储是否成功)。
T.localStorage.save("foo", "bar");
T.localStorage.get
描述
Object T.localStorage.get(String key [,Mixed defaultValue])
T.localStorage.get根据键名取出键值。
参数
key 必选,键名。
defaultValue 可选,若键值不存在的返回值。
返回
value {Mixed} 保存在本地存储空间中的值。
T.localStorage.get("foo", "bar"); // 若foo对应的键值不存在,则返回bar
T.localStorage.remove
描述
Object T.localStorage.remove(String key)
T.localStorage.remove删除本地存储,释放本地存储空间。
参数
key 必选,键名。
返回
true或false,表示删除是否成功
T.localStorage.remove("foo");
6.openjs.js 还带了类似jQuery 的插件功能,基本上包含常用的方法。按个人习惯可以选择使用。
郑重声明:本站内容如果来自互联网及其他传播媒体,其版权均属原媒体及文章作者所有。转载目的在于传递更多信息及用于网络分享,并不代表本站赞同其观点和对其真实性负责,也不构成任何其他建议。