スペースのトップ画面の表示後イベント
スペースのトップ画面が表示された後に発生するイベントです。
- 「スペースのポータルと複数にスレッドを使用する」が有効のスペースのみで発生します。
- ゲストスペースのトップ画面では発生しません。
- 表示対象に設定されているウィジェットがすべて描画されたあとに発生します。
- kintone.Promise オブジェクトを return すると、非同期処理の完了を待って次の処理を開始します。
イベントタイプ
| 環境 | イベントタイプ | イベントが発生するタイミング |
|---|---|---|
| PC 用 | space.portal.show | スペースのトップ画面が表示された時 |
| スマートフォン用 | mobile.space.portal.show | モバイルのスペースのトップ画面が表示された時 |
eventオブジェクトのプロパティ
| プロパティ名 | 型 | 説明 |
|---|---|---|
| spaceId | 文字列 | スペース ID |
eventオブジェクトで実行できる操作
非同期処理の完了を待って次の処理を行う
kintone.Promise オブジェクトを return することにより、非同期処理の完了を待ってから event オブジェクトで実行できる操作を実行できます。
同じイベントに複数のイベントハンドラが登録されているとき、エラーなどが発生して Thenable オブジェクトが棄却された場合には、後続のイベントハンドラの処理は実行されません。
記述方法は kintone における Promise の書き方の基本を参考にしてください。
サンプル
スペースのトップ画面が表示された時にアラートを表示します。
スペースのポータル表示後にイベントを発生させたいのですが、上記サンプルコードを記載する場所がわかりませんでした。
お手数ですがご教授いただけないでしょうか。
よろしくお願いいたします。
せき 様
kintone への JavaScript の適用方法については、チュートリアル https://developer.cybozu.io/hc/ja/articles/201755040 内の「作成したファイルをkintoneに取り込む」をご参照ください。
cybozu Development team
ご回答ありがとうございます。
スペースのポータル内にあるアプリへサンプルのJSを適応させても、処理が機能しないように見受けられるのですが、どこへJSを取り込めばよいのでしょうか。
せき 様
説明不足にて失礼いたしました。
「作成したファイルをkintoneに取り込む」に記載の以下の記事の案内に従って、アプリへの適用ではなく、kintone 全体へ適用ください。（kintone システム管理内のメニューです）
なお、当ドキュメントに記載のとおり、「スペースのポータルと複数にスレッドを使用する」が有効のスペースのみで発生しますのでご注意ください。
cybozu Development team
kintone 全体へ適用することで解決できました。ありがとうございました。