Twitter for Websites (TfW)

Twitter for Websitesを利用することで、基本的なTwitterの機能を簡単にWebサイトに埋め込めます。

Web Intents

Tweet Intents

URL  
https://twitter.com/intent/tweet  
https://twitter.com/intent/retweet  
https://twitter.com/intent/favorite  

Tweet or Reply to a Tweet (ツイートに返信)

https://twitter.com/intent/tweet?in_reply_to=32579487338074112

Retweet a Tweet (リツイート)

Favorite a Tweet (ツイートをお気に入りに登録)

User Intents

Follow and Mini-Profile

https://twitter.com/intent/user?screen_name=NASA

ツイートボタン (Tweet Button)

ツイートボタンのコードは、Twitterボタン | Aboutで作成できます。それは次のようなものです。

<a href="https://twitter.com/share"
    class="twitter-share-button">Tweet</a>

<script>
!function( d, s, id )
{
    var js;
    var fjs = d.getElementsByTagName( s )[ 0 ];
    var p = /^http:/.test( d.location )? 'http' : 'https';

    if( !d.getElementById( id ) )
    {
        js = d.createElement( s );
        js.id = id;
        js.src = p + '://platform.twitter.com/widgets.js';

        fjs.parentNode.insertBefore( js, fjs );
    }
}( document, 'script', 'twitter-wjs' );
</script>

スクリプトの処理がやや難解となっていますが、つまりはドキュメントと同じプロトコルから、重複した読み込みを回避しつつTwitterのスクリプトを読み込んでいるだけです。簡単に記述するならば、

<a href="https://twitter.com/share" class="twitter-share-button">Tweet</a>
<script src="https://platform.twitter.com/widgets.js"></script>

とほぼ同義です。なおスクリプト冒頭の!function(...は、IIFEによる記述方法です。

オプション

a要素の属性で、表示内容をカスタマイズできます。

<a href="https://twitter.com/share"
    class="twitter-share-button"
    data-url="http://example.com"
    data-text="TITLE"
    data-size="large"
    data-count="none">
    Tweet</a>

Twitter / Twitterボタンのページでは、ツイートボタンのオプションの一部しか指定できません。指定可能なオプションの詳細はTweet Button | Twitter Developersにあります。

ツイート数の表示位置

2015/11/20以降、ツイートボタンにツイート数は表示できなくなります。持続的なプラットフォームのための難しい決断 | Twitter Blogs

公式APIの代替として、ツイート数付きのツイートボタンを提供するAPI、widgetoon.jsがあります。

data-count属性で指定します。

  • none … なし
  • horizontal … 右 (既定)
  • vertical … 上

Follow Button

Follow Button | Twitter Developers

Embedded Tweets

Embedded Tweets | Twitter Developers