タブを表示をする
事前準備
OpenSocialではユーザーにタブダイアログでメッセージを表示する機能が提供されています。この機能を利用するには Gadget XMLで Require 要素で tabs feature の使用を宣言する必要があります。
<?xml version="1.0" encoding="UTF-8"?>
<Module>
<ModulePrefs title="Hello, world!">
<Require feature="tabs" />
...
タブの作成
まずタブを表示するコンテンツを用意します。コンテンツにはTabSetにあたる要素が最低1個、Tabにあたる要素が1個以上必要です。
<div id="tabs" />
<div id="tab1">This is tab 1.</div>
<div id="tab2">This is tab 2.</div>
<div id="tab3">This is tab 3.</div>
これらのコンテンツをタブとして扱うサンプルは以下のようになります。
var tabs = new gadgets.TabSet(__MODULE_ID__, null, document.getElementById("tabs"));
tabs.addTab("Tab 1", {
contentContainer: document.getElementById("tab1"),
callback: function() {
// ...
}
});
tabs.addTab("Tab 2", {
contentContainer: document.getElementById("tab2"),
callback: function() {
// ...
}
});
tabs.addTab("Tab 3", {
contentContainer: document.getElementById("tab3"),
callback: function() {
// ...
}
});
- タブセットにあたるDOM要素のIDを指定して gadgets.TabSet() コンストラクタで TabSet オブジェクトを生成します。
- addTab() メソッドでタブセットにタブを追加します。指定可能なパラメータは次の通りです。
- contentContainer: タブのコンテンツとなるDOM要素です。省略時には新たにDOM要素が追加されます。
- callback: このタブが選択されるときに呼ばれるコールバック関数です。
- tooltip: このタブにマウスオーバーされたときに表示されるツールチップの文字列です。
- index: このタブの挿入位置です。省略時には末尾に追加されます。
選択されているタブを取得してコールバック関数を明示的に呼ぶには以下のようにします。
var selected = tabs.getSelectedTab();
var callback = selected.getCallback
callback.call();
更新履歴
- 2013/03/15
- ドキュメント移行