サイトのトップへ戻る

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

ページ読み込み後に埋め込み型コンテンツを初期化する

ウェブサイト用 Twitter を組み込む場合、大抵は設定のドキュメントに記載されている推奨の埋め込みコードを使用するでしょう。 しかし、Twitterのウィジット JavaScriptがボタンやウィジットに変換するHTML エレメントを見つけるために行うページDOMのスキャンを、どのようにしてどのタイミングで実施するかを最適化したいと思うことでしょう。

コンテンツをページに動的に挿入している場合 (読み込みに時間がかかるコンテンツやpushState 技術を使って記事間をナビゲートしているなど)、 ボタンとウィジットを新規に設置するためには、twttr.widgets.load()関数を使用してTwitterのウィジット JavaScript スキャンをリクエストする必要があります。

twttr.widgets.load()

引数を設定せずに呼び出した場合、 widgets-js は初期化されていないウィジットを探すためにdocument.bodyの DOM ツリー全てを検索します。 パフォーマンスを良くするために、HTMLElement オブジェクトかHTMLElementオブジェクト配列のどちらかを渡して、検索をこれらエレメントの子要素のみ制限します。

一つのエレメント内でウィジットを初期化する例:

twttr.widgets.load(
  document.getElementById("container")
);

エレメントの配列内でウィジットを初期化する例:

twttr.widgets.load(
  document.getElementsByClassName("containers")
);