bShare API

当您开始使用bShare的任何API时,您就已经默认同意了我们 隐私条款中关于API使用相关内容.
 
 
 
 
bShare客户端API
 

简介

bShare客户端API使bShare用户可以灵活的控制bShare按钮的式样和行为。所有bShare用户都可以使用bShare客户端API。

bShare的JS代码参数

首先,为了在页面上加入bShare分享按钮,您必须嵌入bShare的JS代码。

<a class="bshareDiv" href="http://www.bshare.me/share">分享按钮</a>
<script language="javascript" type="text/javascript" src="http://static.bshare.me/b/button.js"></script>

bShare提供了很多的选项,您只需要把选项加入到嵌入代码中JS文件的末尾,如下例。注意和普通web链接里参数指定方式不同的是,参数和URL使用"#"分割而不是"?",而参数之间则一样使用"&"分割。例如:

<a class="bshareDiv" href="http://www.bshare.me/share">分享按钮</a>
<script language="javascript" type="text/javascript" src="http://static.bshare.me/b/button.js#lang=en&ssc=false"></script>

以下是bShare嵌入JS代码支持的选项。

uuid
站长的UUID(Publisher UUID)。如果要追踪分享数据则必须提供此选项,在bShare后台添加网站即可得到UUID。
style
按钮式样,可以为0(文字),1(默认),2(列式),3(浮动),4(浮动图片),5(三角),10(苗条型),11(胖犁型)。
fs
浮动式样,1上,2下,3左,4右,0为静态显示。式样2支持静态及上下浮动,式样3、4支持左右浮动,式样5上下左右都可以,其他式样的按钮都不能浮动。
bgcolor
背景颜色,可以是CSS中color属性支持的任意值。当style为2时,可以设置为none,则按钮为透明且没有边框。
textcolor
文字颜色,可以是CSS中color属性支持的任意值。
bp
按钮上直接显示的平台,以英文逗号分隔的 平台代码。对于普通按钮和浮动按钮,这些平台显示在鼠标移过时弹出的小窗口中;对于列表式,则直接显示在列表中。
ssc
是否显示分享计数,true或者false,默认是true,浮动按钮不支持显示分享计数。
sn
是否显示分享平台名称,true或者false,默认是false。只对列式按钮起作用。
text
显示的文字内容,默认是"分享"或者"分享到"(针对不同的式样),用于文本按钮、列式按钮等式样中。
lang
语言,可以是简体中文(zh),英文(en),或繁體中文(zh_TW)
img
用于自定义按钮图片,参数为图片的URL(已编码)。使用时必须将style设置为999,并同时指定h和w参数,分别为按钮图片的高度和宽度,以px(像素)为单位。
pop
定义分享窗口的弹出方式,为0时不弹出小窗口,点击按钮直接弹出完整的bShare分享窗口;为1则鼠标移动到按钮时向上弹出小窗口,为2时向下弹出小窗口。
popbgc
弹出小窗口的顶部和底部的背景颜色,可以是CSS中color属性支持的任意值。
poptxtc
弹出小窗口的顶部和底部的文字颜色,可以是CSS中color属性支持的任意值。
inline
Makes the button an inline element. There will be no line break after the button. This is false by default; to enable set this value to "true".
beta
Set this value to "true" to test out the beta version of our newly designed popup!
popjs
Set this parameter to the full URL of the javascript file that will display the button popup. If you do not know what you are doing, please do not use this parameter.

bShare JS API

除了上面列出的JS参数,bShare还提供了以下的JavaScript函数帮助站长定义分享的内容和方式。

bShare.addEntry({
   title: "分享的标题,默认为当前页面标题",
   url: "分享的链接,必须和当前页面同属于一个域名。默认为当前页面URL",
   summary: "分享的文本摘要,默认为BSHARE_TEXT标识的内容或者用户高亮的内容",
   content: "分享的HTML全文,默认为BSHARE_HTML标志的内容或者bShare自动抓取的内容",
   pic: "如果要允许用户分享图片,此参数指定分享图片的链接,目前支持新浪微博,搜狐微博,网易微博,人人网, 嘀咕,Follow5,腾讯微博和做啥。"
})

注意调用此函数前必须已导入bShare的JavaScript嵌入代码,否则会出错。

http://www.bshare.me/api?request_locale=zh

猜你喜欢

转载自qianxunniao.iteye.com/blog/1773751
API
今日推荐