サイトのトップへ戻る

Twitter 開発者 ドキュメント日本語訳




ツイートボタンのパラメーターリファレンス

A Tweet Button supports pre-populating share text, hashtags, and a Twitter account reference. Associate related Twitter accounts to drive followers.



ツイートコンテンツパラメータ

in_reply_to 任意

(もし当てはまれば)あなたのアカウントのツイートのような、親ツイートのステータスIDの文字列。

サンプル値: 471716611724812288

text 任意

ツイート書き込みボックスに強調されて事前に埋め込まれるテキスト。

サンプル値: custom share text

url 任意

ツイートに含まれるURL。

サンプル値: https://dev.twitter.com/web/tweet-button

hashtags 任意

デフォルトのツイート文に追加されるハッシュタグのコンマ区切り一覧。

サンプル値: example,demo

via 任意

Twitter ユーザー名に、ツイート元の属性を付与します。

@usernameさんからという形式で Tweet 文に追加表示されます。この Twitter アカウントは、フォロー推奨アカウントの一覧に表示されます。

サンプル値: twitterdev



ボタン表示パラメータ

表示するボタンのサイズ、ツイートカウントの表示、ボタンの配置、その他色々をカスタマイズします。

These visual parameters do not apply to Web Intents, which are styled separately by implementing sites.

size 任意

largeを設定し場合は、大きめのバージョンのボタンを表示します。 iframeの場合はlを設定します。

サンプル値: large

align 任意

ボタンを生成されたiframeのleft もしくはrightに配置します。

既定動作: ツイートボタンは、ウィジットの言語に合わせた最適な位置オプションを選択します。

サンプル値: right

count 任意

noneを設定した場合、指定したURLを含むツイートの数は表示されません。

verticalを設定した場合は、指定したURLを含むツイートの数はボタンの上に表示されます。

サンプル値: none

counturl 任意

集めたツイートカウントを表示するため、明示的に canonical URI を定義します。

サンプル値: https://dev.twitter.com/

lang 任意

サポートされている Twitter 言語コード 。

指定した言語でテキストコンポーネントを読み込みます。

サンプル値: es

dnt 任意

trueを設定した場合、ツイートとそれが埋め込まれたページは、 お勧めアカウントを含むTwitterのターゲティングに影響を与えません。

サンプル値: true



HTML data-* 例

<a class="twitter-share-button"
  href="https://twitter.com/share" 
  data-size="large"
  data-url="https://dev.twitter.com/web/tweet-button"
  data-count-url="https://dev.twitter.com/web/tweet-button"
  data-via="twitterdev"
  data-related="twitterapi,twitter"
  data-hashtags="example,demo"
  data-text="custom share text">
Tweet
</a>

Iframe 例

<iframe
  src="https://platform.twitter.com/widgets/tweet_button.html?size=l&url=https%3A%2F%2Fdev.twitter.com%2Fweb%2Ftweet-button&via=twitterdev&related=twitterapi%2Ctwitter&text=custom%20share%20text&hashtags=example%2Cdemo"
  width="140"
  height="28"
  title="Twitter Tweet Button"
  style="border: 0; overflow: hidden;">
</iframe>

JavaScript factory 例

twttr.widgets.createShareButton(
  "https:\/\/dev.twitter.com\/web\/tweet-button",
  document.getElementById("tweet-container"),
  {
    size: "large",
    via: "twitterdev",
    related: "twitterapi,twitter",
    text: "custom share text",
    hashtags: "example,demo"
  }
);

ウェブインテント例

ツイート

<a href="https://twitter.com/share?
  url=https%3A%2F%2Fdev.twitter.com%2Fweb%2Ftweet-button&
  via=twitterdev&
  related=twitterapi%2Ctwitter&
  hashtags=example%2Cdemo&
  text=custom%20share%20text">
Tweet
</a>