【Blogger】ウィジェットの b:widget タグ一覧

Blogger テーマ（テンプレート）の HTML を編集している際、レイアウト画面を使用しなくてもウィジェット（ガジェット）を追加できるように、各ウィジェットの b:widget タグをまとめました。

アイキャッチ

b:widget タグの設置

テーマ編集上から Blogger ウィジェットを追加する場合、以下のように b:section タグ内に b:widget タグを挿入します。

<b:section id='main'>
  <b:widget id='Blog0' type='Blog'/>
</b:section>

b:widget を設置してテーマを保存すると、1 行だったタグが展開され、ウィジェットのデフォルトの b:widget-settings タグ（ない場合もある）と b:includable タグが出現します。

特にバージョン 2 のウィジェットの場合この b:includable タグの数がいたずらに多いので、カスタマイズする際は以下のツールを使って不要なタグの中身を空にしておくと作業がしやすいかもしれません。

b:widget タグの属性

b:widget タグに使用できる属性は以下の通りです。

属性説明
type必須ウィジェットの種類。変更不可。
id必須ウィジェットの ID。ウィジェット名と 1 から 999 の数字の組み合わせ。
title任意ウィジェットのタイトル。空の場合、デフォルトのタイトルが使用される。
locked任意レイアウト画面でのウィジェットのロック。「yes（true）」または「no（false）」を指定。
visible任意ウィジェットの表示・非表示。バージョン 3 のテーマかつバージョン 2 のウィジェットのみ「true」または「false」を指定可。
version任意ウィジェットのバージョン。指定しても消えることがある。
mobile任意モバイルからの表示。バージョン 1 のウィジェットのみ「yes」、「no」、「only」のいずれかを指定可。
cond任意ウィジェットの表示振り分けのための条件式。

各属性の詳しい説明は以下のページを参照してください。

よくあるエラーメッセージ

テーマ 編集上で b:widget タグを追加した際によく遭遇したエラーメッセージを 2 つ紹介します。実際のエラーメッセージでは、[widgetType] にはウィジェット名、[number] には 0 から 999 の数字が入ります。

More than one widget was found with id: <b>[widgetType][number]</b>. Widget IDs should be unique.

（和訳：id が [widgetType][number] のウィジェットが複数見つかりました。ウィジェット ID は唯一無二でなければなりません。）

b:widget の id 属性が、すでにテーマ上の存在するウィジェットと重複した際に表示されます。この場合、上の [number] にあたる部分を、同じ種類の他のウィジェットと被らない数字に変えればエラーを回避できます。

The new widget with id "<b>[widgetType][number]</b>" is invalid, as the limit for the widgets of type <b>[widgetType]</b> has been exceeded.

和訳）id が "[widgetType][number]" の新しいウィジェットは、[widgetType] タイプのウィジェットの制限を超えているため無効です。

これは、その種類のウィジェットの設置上限数を超えている場合に表示されます。例えば、ブログ アーカイブウィジェットは 1 つのブログにつき 2 つまでしか置けず、テーマに 3 つ目のブログ アーカイブウィジェットを置こうとすると上のようなエラーが起きます。次項に各ウィジェットの設置上限数を書いておくので参考にしてください。

（ところでテーマ編集のエラーメッセージ、<b> と </b> がタグのまま表示されてるのがめちゃくちゃ気になるんですが大丈夫なんでしょうかこれ？）

b:widget タグ一覧

ここからウィジェット（ガジェット）の b:widget タグを type のアルファベット順に掲載していきます。コードのコピーボタンを押し、テーマ編集上にペーストして保存すれば、レイアウト画面を使わずとも気軽にウィジェットの追加ができます。

なお、b:widget タグには必須属性である id と type しか付与していないので、その他の属性が必要な場合は前項の「b:widget の属性」を参照して適宜追加してください。また、id 名の数字は各ウィジェット共通で 0 にしてあります。前項の「よくあるエラーメッセージ」の 1 つ目のエラーが出た場合は数字部分を変更してください。

さらに、そのウィジェットの 1 つのブログに対する設置上限数と、b:widget-settings の項目の説明ページへのリンクを併記しています。「設置上限数：999」以外のウィジェットは筆者が実際にテーマにウィジェットを追加して調べたデータなので、ある程度信用できると思います。

AdSense

<b:widget id='AdSense0' type='AdSense'/>
  • 設置上限数：999
  • b:widget-settings の項目：なし

Attribution（帰属）

<b:widget id='Attribution0' type='Attribution'/>

ブログの投稿

<b:widget id='Blog0' type='Blog'/>

ブログ アーカイブ

<b:widget id='BlogArchive0' type='BlogArchive'/>

ロゴ

<b:widget id='BloggerButton0' type='BloggerButton'/>

ブログリスト

<b:widget id='BlogList0' type='BlogList'/>

ブログ検索

<b:widget id='BlogSearch0' type='BlogSearch'/>
  • 設置上限数：999
  • b:widget-settings の項目：なし

連絡フォーム

<b:widget id='ContactForm0' type='ContactForm'/>
  • 設置上限数：2
  • b:widget-settings の項目：なし

注目の投稿

<b:widget id='FeaturedPost0' type='FeaturedPost'/>

フィード

<b:widget id='Feed0' type='Feed'/>

フォロワー

<b:widget id='Followers0' type='Followers'/>
  • 設置上限数：2
  • b:widget-settings の項目：存在するがおそらく変更しても無意味？

ページヘッダー

<b:widget id='Header0' type='Header'/>

HTML/JavaScript

<b:widget id='HTML0' type='HTML'/>

イメージ（画像）

<b:widget id='Image0' type='Image'/>

ラベル

<b:widget id='Label0' type='Label'/>

リンクリスト

<b:widget id='LinkList0' type='LinkList'/>

ページ

<b:widget id='PageList0' type='PageList'/>

人気の投稿

<b:widget id='PopularPosts0' type='PopularPosts'/>

基本情報（プロフィール）

<b:widget id='Profile0' type='Profile'/>

不正行為を報告

<b:widget id='ReportAbuse0' type='ReportAbuse'/>
  • 設置上限数：1
  • b:widget-settings の項目：なし

ブログの統計情報

<b:widget id='Stats0' type='Stats'/>

リンク登録（登録用リンク）

<b:widget id='Subscribe0' type='Subscribe'/>
  • 設置上限数：999
  • b:widget-settings の項目：なし

テキスト

<b:widget id='Text0' type='Text'/>

リスト

<b:widget id='TextList0' type='TextList'/>

翻訳

<b:widget id='Translate0' type='Translate'/>

ウィキペディア

<b:widget id='Wikipedia0' type='Wikipedia'/>
  • 設置上限数：1
  • b:widget-settings の項目：なし

すべての b:widget タグを一括で追加

Blogger ウィジェット全 26 種を一括で追加するコードがこちら。テスト用ブログでの使用を推奨します。

<b:widget id='AdSense0' type='AdSense'/>
<b:widget id='Attribution0' type='Attribution'/>
<b:widget id='Blog0' type='Blog'/>
<b:widget id='BlogArchive0' type='BlogArchive'/>
<b:widget id='BloggerButton0' type='BloggerButton'/>
<b:widget id='BlogList0' type='BlogList'/>
<b:widget id='BlogSearch0' type='BlogSearch'/>
<b:widget id='ContactForm0' type='ContactForm'/>
<b:widget id='FeaturedPost0' type='FeaturedPost'/>
<b:widget id='Feed0' type='Feed'/>
<b:widget id='Followers0' type='Followers'/>
<b:widget id='Header0' type='Header'/>
<b:widget id='HTML0' type='HTML'/>
<b:widget id='Image0' type='Image'/>
<b:widget id='Label0' type='Label'/>
<b:widget id='LinkList0' type='LinkList'/>
<b:widget id='PageList0' type='PageList'/>
<b:widget id='PopularPosts0' type='PopularPosts'/>
<b:widget id='Profile0' type='Profile'/>
<b:widget id='ReportAbuse0' type='ReportAbuse'/>
<b:widget id='Stats0' type='Stats'/>
<b:widget id='Subscribe0' type='Subscribe'/>
<b:widget id='Text0' type='Text'/>
<b:widget id='TextList0' type='TextList'/>
<b:widget id='Translate0' type='Translate'/>
<b:widget id='Wikipedia0' type='Wikipedia'/>

あとがき

レイアウト画面を使用せずにウィジェット（ガジェット）を追加できるよう、各ウィジェットの b:widget タグをまとめました。

テーマの html タグに b:js='false' を追加すると、Blogger の標準 JavaScript が無効になりブログの表示速度が若干速くなりますが、それと引き換えにレイアウト画面が使えなくなります。そんなときでもウィジェットの追加ができたらいいなと思い、こんなまとめを作ってみました。

ちなみに標準 JS の影響を抑えつつレイアウト画面を動かす方法もあります。以下の記事を参考にしてみてください。

編集
ホーム