JavaScript イベント

フォーム、サブフォーム、ページ、フィールド、アクション、ボタン、アクションホットスポットなどの Domino オブジェクトには、JavaScript イベントハンドラが用意されています。プログラムペインで、コードをこれらのイベントハンドラに付加できます。イベントをサポートするブラウザと、一部制限がありますが Notes クライアントで、イベントの発生時にコードが実行されます。

JavaScript イベント一覧

次の表には Domino Designer の JavaScript イベントハンドラを記載しています。「ブラウザのみ」はイベントハンドラがサポートされるブラウザでのみ機能することを示します。「ブラウザと Notes」はイベントハンドラがサポートされるブラウザと Notes クライアントで機能することを示します。

Event	フォーム、サブフォーム、ページ	フィールド	アクション、ボタン、ホットスポット
JSHeader	ブラウザと Notes	フォーム、サブフォーム、ページに JSHeader を使用します。
onBlur	なし	ブラウザと Notes	ブラウザのみ
onChange	なし	ブラウザと Notes	なし
onClick	ブラウザのみ	ブラウザのみ	ブラウザと Notes
onDblClick	ブラウザのみ	ブラウザのみ	ブラウザのみ
onFocus	なし	ブラウザと Notes	ブラウザのみ
onHelp	ブラウザと Notes	なし	ブラウザのみ
onKeyDown	ブラウザのみ	ブラウザのみ	ブラウザのみ
onKeyPress	ブラウザのみ	ブラウザのみ	ブラウザのみ
onKeyUp	ブラウザのみ	ブラウザのみ	ブラウザのみ
onLoad	ブラウザと Notes	なし	なし
onMouseDown	ブラウザのみ	ブラウザのみ	ブラウザのみ
onMouseMove	ブラウザのみ	ブラウザのみ	ブラウザのみ
onMouseOut	ブラウザのみ	ブラウザのみ	ブラウザのみ
onMouseOver	ブラウザのみ	ブラウザのみ	ブラウザのみ
onMouseUp	ブラウザのみ	ブラウザのみ	ブラウザのみ
onReset	ブラウザのみ、フォームのみ	なし	なし
onSelect	なし	ブラウザのみ	なし
onSubmit	ブラウザと Notes	なし	なし
onUnload	ブラウザと Notes	なし	なし

ブラウザと Notes クライアントで機能するイベント

ブラウザと Notes クライアントの両方で機能しなければならないコードは次のイベントに限定してください。

文書の事前処理と事後処理には、onLoad、onUnload、onSubmit を使用します。
フィールドにカーソルが入るときと出るときの処理には、onFocus、onBlur、onChange を使用します。
アクション、ボタン、アクションホットスポットには onClick を使用します。

JSHeader イベント

JSHeader は、関数やグローバル変数宣言のように、オブジェクトのすべてのイベントがアクセスできるコードをロードする特別なイベントハンドラです。このコードは Domino の生成した HTML の <HEAD> タグに挿入します。

onSubmit イベント

onSubmit イベントは、FileSave @コマンドが実行されるときにブラウザと Notes クライアントで発生します。ブラウザでは、onSubmit イベントから false を返すことで保存処理を中止できます。

Notes クライアントで JavaScript を有効にする

Notes クライアントで JavaScript を実行するには、[ファイル] - [プリファレンス] - [ユーザー] の [追加のオプション] を選択した後 [JavaScript を有効にする] を選ぶ必要があります。セキュリティを拡張または制限するには、[ファイル] - [セキュリティ] - [ユーザーセキュリティ] を選択した後、[実行制御] で [JavaScript] を選択する必要があります。