ミニメッセージを表示をする
事前準備
OpenSocialではユーザーに簡単なダイアログのようにメッセージを表示する機能が提供されています。この機能を利用するには Gadget XMLで Require 要素で minimessage feature の使用を宣言する必要があります。
<?xml version="1.0" encoding="UTF-8"?>
<Module>
<ModulePrefs title="Hello, world!">
<Require feature="minimessage" />
...
閉じるボタンを持つミニメッセージの表示
ユーザーが閉じることができるボタンを持つミニメッセージの表示例は以下のようになります。
var msg = new gadgets.MiniMessage();
msg.createDismissibleMessage("ハイスコアを更新しました", function() {
// ...
});
- new gadgets.MiniMessage() でMessage オブジェクトを生成します。
- createDismissibleMessage() にメッセージを引数にして呼ぶとメッセージが表示されます。
- 第2引数にコールバック関数を指定していたらユーザーが閉じるボタンを押したときに呼ばれます。
指定時間に消去されるミニメッセージの表示
指定時間で閉じるミニメッセージの表示例は以下のようになります。
var msg = new gadgets.MiniMesage();
msg.createTimerMessage("ハイスコアを更新しました", 5, funciton() {
// ...
});
- new gadgets.MiniMessage() でMessage オブジェクトを生成します。
- createTimerMessage() にメッセージと閉じるまでの秒数を指定して呼ぶとメッセージが表示されます。
- 第3引数にコールバック関数を指定していたらメッセージが閉じるときに呼ばれます。
静的なミニメッセージの表示
プログラムによって閉じるミニメッセージの表示例は以下のようになります。
var msg = new gadgets.MiniMessage();
var m = msg.createStaticMessage("ハイスコアを更新しました");
m.onclick = function() {
msg.dismissMessage(m);
}
- new gadgets.MiniMessage() でMessage オブジェクトを生成します。
- createStaticMessage() にメッセージを指定して呼ぶとメッセージが表示されます。
- 返り値の DOM 要素の onclick を利用してメッセージがクリックされたら dismissMessage() メソッドを呼んでメッセージを消去します。
更新履歴
- 2013/03/15
- ドキュメント移行