第406行: | 第406行: | ||
http://jssdk.sinaapp.com/demo/layer/selector.html | http://jssdk.sinaapp.com/demo/layer/selector.html | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
2014年7月16日 (三) 19:12的版本
JS SDK
JS SDK for OAuth2.0是线上JS SDK的升级版本(V1版JS SDK),它较之前版本有较大改变:
- 1、它去掉了部署在第三方的xd.html跨域文件,使开发者开发使用更加简单方便;
- 2、Appkey的传递方式由原来的json方式改变为通过参数传递方式;
- 3、为兼容之前JSSDK,该版JSSDK的命名空间由原来的WB改变为WB2;
- 4、该版本将Js widget内置其中,用户无需再去单独引用JS和CSS,只需调用相应的js widget方法即可;
- 5、支持通过版本号调用js widget,以便不同开发者不同的需要;
下面我们来一起体验一下这些特性。你也可以浏览微博JS SDK的官方支持站,查看更加细致的文档。
开发指南
如果你没有AppKey请先在开放平台网站点击网站接入添加新网站,申请入口。
为了保证你的应用或网站的安全,在使用Weibo JS SDK时,需要你在应用信息页面为该应用选定绑定域名功能,并绑定你的域名,我们将以此域名来判定Weibo JS SDK API请求来源的合法性,不合法的请求将被拒绝。
绑定域名的操作可以在应用创建页面及编辑页面完成。选择“绑定域名”,填入域名提交即可。
在您页面的HTML标签中增加XML命名空间。
在页面顶端加入如下代码
<script src=" http://tjs.sjs.sinajs.cn/open/api/js/wb.js?appkey=3168919025" type="text/javascript" charset="utf-8"></script>
JS SDK公开方法及说明
WB2.login(callback)
函数说明
微博登录认证功能。
参数说明
callback: 可选,登录后执行的回调函数。
返回值
无
示例
WB2.login(function(){ //callback function });
WB2.logout(callback)
函数说明
退出微博登录功能。
参数说明
callback: 可选,退出登录后执行的回调函数。
返回值
无
示例
WB2.logout(function(){ //callback function });
WB2.checkLogin()
函数说明
检查是否已经登录,已登录返回true,未登录返回false。
参数说明
无。
返回值
true:已登录; false:未登录。
示例
WB2.checkLogin();
WB2.anyWhere(callback)
函数说明
第三方与微博API进行数据交互及调用内置widget的入口函数。
参数说明
callback:必选回调函数,需指定一个形参W。
可以通过形参直接调用 widget 或者 parseCMD 直接读取开放平台API接口。
具体的调用方式见下文对 parseCMD 及 widget 调用的说明。
示例
WB2.anyWhere(function(W){ W.parseCMD("/statuses/friends.json", function(sResult, bStatus){ alert(sResult); },{ method: 'post' }); });
parseCMD(sUri, oCallBack, oArgs, oOpts)
函数说明
第三方与开放平台API接口进行数据请求的函数,必须在WB2.anyWhere中通过W对象调用。
参数说明
sUri:必选,传递给API的命令URI。
oCallBack:必选,API返回数据后的回调函数。
oArgs:可选还是必选,根据API的定义,传递给API的参数对象。
oOpts:可选,请求API的时候的类型,默认是 POST 方式。
示例
WB2.anyWhere(function(W){ // 获取评论列表 W.parseCMD("/statuses/comments.json", function(sResult, bStatus){ if(bStatus == true) { alert(sResult); } },{ userid : 12345678 },{ method: 'post' }); });
JS widget说明及示例
微博连接按钮
widget说明
第三方与微博进行连接的按钮,可实现登录与退出功能。
参数说明
id:连接按钮元素ID,必填。
type:连接按钮样式,是登录前的按钮样式[1-7]和登录后的样式[1-5]的组合,可选,默认为"3,2"。
callback:回调函数对象,参数说明如下,
login: 登录后执行的回调函数,其参数为用户信息json对象;
logout: 退出登录后执行的回调函数;
示例
Html:<div id="wb_connect_btn"></div> Script: WB2.anyWhere(function(W){ W.widget.connectButton({ id: "wb_connect_btn", type: '3,2', callback : { login:function(o){ alert(o.screen_name) }, logout:function(){ alert('logout'); } } }); });
示例: http://jssdk.sinaapp.com/demo/button/loginButton.php
微博关注按钮
widget说明
可实现用户之间的关注功能。
参数说明
id:绑定的标签的ID,必填。
nick_name:用户昵称,必填。
示例
Html: <span id="wb_follow_btn"></span> Script: WB2.anyWhere(function(W){ W.widget.followButton({ 'id': "wb_follow_btn" //关注按钮容器ID 'nick_name': '姚晨' //用户昵称 }); });
示例:
http://jssdk.sinaapp.com/demo/button/followButtonTag.html
微博名片
widget说明
显示用户名片,包括昵称、头像、关注数量、粉丝数量、微博数量、最新微博以及关注按钮功能等,支持单独处理及批量处理两种方式。
参数说明
id:要显示名片的元素ID,必填。
tag:要处理的标签名称,如'a', 'span'等,默认为'a',即只对a标签进行处理(其他标签不做处理),选填。
search:是否为批量处理名片的标识, 为true时会自动识别指定标签里“@+昵称”,并进行批量替换,增加名片事件,为false时仅为单独定义。默认为false。
示例
Html: 单独定义: <span id="card" href=" http://weibo.com " wb_screen_name="微博名称" >微博名称</span> <a id="wb_uid" wb_user_id="1052981072" href="http://www.woiweb.net" >woiweb</a> 批量定义: <div id="search"> <a wb_screen_name="flashsoft" href="http://weibo.com">flashsoft</a> @woiweb </div> <div id="weibo_uid_area"> <a href="http://www.woiweb.net" wb_user_id="1052981072">woiweb</a> <span wb_user_id="1639733600">金山</span> </div> Script: WB2.anyWhere(function(W){ W.widget.hoverCard({ id: "card" }); W.widget.hoverCard({ id: "search", search: true }); W.widget.hoverCard({ id: "wb_uid" }); W.widget.hoverCard({ id: "weibo_uid_area", tag: "span", search: true }); });
示例: http://jssdk.sinaapp.com/demo/layer/card.html
微博发布器
widget说明
弹出微博发布器,发布微博。
参数说明
id : 绑定的标签的ID,必填。
button_type : 按钮样式red/gray,默认为red
button_size : big/middle/small,默认为middle
button_text : 自定义button文字,默认为“发布到微博”
default_text : 文本框内容,默认为空
default_image : 预置图片地址,默认为空
toolbar : 工具栏[表情, 图片, 话题],默认为'face,image,topic',可增删工具栏模块和更换按钮位置
示例
Html: <a href="javascript:;" id="publish" >发表微博</a> Script: WB2.anyWhere(function(W){ W.widget.publish({ 'id' : 'publish' }); });
示例:
http://jssdk.sinaapp.com/demo/layer/publish.html
微博好友选择器
widget说明
好友选择器,包括相互关注、我的粉丝、我关注的人三个标签,标签可配,支持联想输入功能,可快速选择所需好友,选择后点击确定即可得到已选择的好友的信息。
参数说明
id: 绑定的标签的ID,必填。
callback: 选择完成点击确定后执行的回调函数,参数为选择好友信息的数组对象。
limit: 限制选择好友数量,默认为-1,不限制选择数量。
tab: 好友选择器标签配置,可选。
list: 显示的标签及顺序,[1:相互关注, 2:我的粉丝, 3:我关注的人],可以根据需要选择各种组合,还可定制顺序,如[1], [3,2]。
index: 默认展开的标签,默认为第一个标签。
Html: <input id="but" type="button" value=" 显示选择器 " /> Script: //回调函数,返回选择结果 function cbk(data){ //do something. } WB2.anyWhere(function(W){ W.widget.selector({ 'id' : "but", //必选 'callback' : cbk }); });
示例:
http://jssdk.sinaapp.com/demo/layer/selector.html