目前有以下API可供調用:
bShare.addEntry(entry);
用于設置分享的內容,包括標題、摘要、圖片等。用法可以參考自定義分享內容及圖片,一個頁面放置多個bShare按鈕。
bShare.share(event, shortName[, entryNum]);
分享內容到指定的平臺。
event | 對應的DOM事件,例如用戶的點擊事件對象。 |
shortName | 分享目標平臺的代碼,可以參考分享平臺代碼頁面。 |
entryNum | 指定分享的內容,對應addEntry的調用,即如果是0則對應第1次addEntry的調用,如果是1則對應第2次addEntry的調用,以此類推。只有頁面中有多個按鈕時需要指定。 |
bShare.more(event[, entryNum]);
打開分享大彈窗,類似點擊bShare上的“更多”按鈕的效果。參數的意義和share方法中的相同。
bShare.init();
加載并初始化bShare分享服務。默認是會在頁面內容加載完成后進行調用,也就是延遲加載。如果您想要提前加載bShare,也可以顯式調用它;或者您是在頁面加載完成后通過Ajax加載bShare的JS代碼,則必須顯式調用。
注意調用API的頁面中必須包含bShare的JS嵌入代碼,如果您不想顯示bShare預定義的按鈕,您可以將style參數設置為-1。
范例:
如果您非常了解HTML、CSS和JavaScript,并且想要完全按照自己的想法去設計分享圖標的顯示方式,沒問題!我們提供給您最大的自由發揮的空間,同時您又能很方便的使用bShare的分享功能。
平臺分享小圖標
用以下的代碼創建一個平臺分享小圖標:
<a title="飛信" onclick="javascript:bShare.share(event,'feixin',0);return false;">
<img src="http://static.bshare.cn/frame/images/logos/s4/feixin.gif" style="height:16px; width:16px;"/>
<span style="padding-left: 3px;">飛信</span></a>
您應該會注意到您可以設置自己的圖標和文字,您也可以使用CSS定義圖標的式樣。實際上,您唯一需要保留的就是在用戶進行分享行為時調用bShare.share(event,feixin,0)就可以了。當然,您也可以直接使用我們提供的圖標和樣式。
對我們所有的支持的平臺,只要用我們的平臺代碼替換示例中的紅色部分就可以了。
"更多..."按鈕
要添加bShare的"更多..."按鈕,您可以使用如下代碼:
<a title="更多平臺" onclick="javascript:bShare.more(event);return false;"/>
<img src="http://static.bshare.cn/frame/images/more.gif" style="height:16px; width:16px;"/>
<span style="padding-left: 3px;">更多平臺</span></a>
同樣的,您也可以使用您自己的圖片并控制它的式樣。您只需要在用戶點擊時調用bShare.more(event)就可以了。
范例
下面是一個會顯示飛信、新浪微博和更多按鈕的示例:
<div style="font-size:13px;">
<span style="font-weight:bold;vertical-align:middle;cursor:pointer;" onclick="javascript:bShare.more(event);return false;">分享到:</span>
<a title="分享到騰訊朋友" onclick="javascript:bShare.share(event,'qqxiaoyou',0);return false;" style="cursor:pointer;color:#2e3192;">
<img src="http://static.bshare.cn/frame/images/logos/s4/qqxiaoyou.gif" style="height:16px; width:16px; vertical-align:middle;"/>
<span style="padding-left:2px; vertical-align:middle;">騰訊朋友</span></a>
<a title="分享到新浪微博" onclick="javascript:bShare.share(event,'sinaminiblog',0);return false;" style="cursor:pointer;color:#2e3192;">
<img src="http://static.bshare.cn/frame/images/logos/s4/sinaminiblog.gif" style="height:16px; width:16px; vertical-align:middle;"/>
<span style="padding-left:2px; vertical-align:middle;">新浪微博</span></a>
<a title="更多平臺" onclick="javascript:bShare.more(event);return false;" style="cursor:pointer;color:#000;"/>
<img src="http://static.bshare.cn/frame/images/logos/s4/more.gif" style="height:16px; width:16px; vertical-align:middle;"/>
<span style="padding-left:2px; vertical-align:middle;">更多平臺</span></a>
</div>
<script type="text/javascript" charset="utf-8" src="http://static.bshare.cn/b/buttonLite.js#uuid=<你的UUID>&style=-1"></script>
最后,不要忘了在您的頁面上必須要加載上bShare的嵌入JavaScript代碼!
<script type="text/javascript" charset="utf-8" src="http://static.bshare.cn/b/buttonLite.js#uuid=<你的UUID>&style=-1"></script>
注意如果您不需要顯示bShare的默認按鈕,您可以將style設置為-1并且設置您的UUID。當然,您也可以同時顯示bShare的預定義式樣的按鈕。例如,你可以在文章頭部放一個帶分享計數的bShare分享按鈕,同時在底部放上您自己設計的分享圖標,這樣會有更好的分享和傳播效果哦。
現在,就去發揮您的想象力,試試看創建一個完全屬于您的按鈕式樣吧!