onFocus()
使用方法
ブラウザのフォーカスが変更されるとコールされる関数を登録します。Salesforce コンソールでは、主タブまたはナビゲーションタブでユーザが移動すると、ブラウザのフォーカスが変更されます。詳細は、Salesforce オンラインヘルプの「Salesforce コンソール」を参照してください。
構文
1sforce.interaction.onFocus( listener:function );引数
| 名前 | 型 | 説明 |
|---|---|---|
| listener | function | ブラウザのフォーカスが変更されたときにコールされる JavaScript メソッド。 |
サンプルコード – JavaScript
1swfobject.registerObject("clippy.codeblock-1", "9");
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17<html>
18<head>
19 <script type="text/javascript" src="http://domain:port/support/api/25.0/interaction.js"></script>
20 <script type="text/javascript">
21 var callback = function (response) {
22 if (response.result) {
23 alert(response.result);
24 }
25 };
26 //Invokes API method
27 sforce.interaction.onFocus(callback);
28</script>
29</head>
30</body>
31</html>応答
このメソッドは非同期であるため、コールバックメソッドのオブジェクトで応答を返します。応答オブジェクトには次の項目が含まれます。
| 名前 | 型 | 説明 |
|---|---|---|
| result | string | フォーカスされているページの URL を JSON 文字列として返します。該当するオブジェクト ID、オブジェクト名、オブジェクト種別、および API バージョン 33.0 以降の場合はオブジェクトタブ名が含まれます。以下に例を示します。
ページがオブジェクトにフォーカスしていない場合、オブジェクト ID、オブジェクト名、およびオブジェクトは空になります。 API バージョン 31.0 以降では、個人取引先オブジェクトで API メソッドを呼び出すと次の追加情報を返します。
|
| error | string | API コールが正常に行われた場合、この変数は未定義です。API コールが失敗した場合、この変数はエラーメッセージを返します。 |