跳到主要内容

ミニメッセージを表示をする

事前準備​

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
    • ドキュメント移行