View Source

JavaScript値が有効、つまり予想された値である場合のウェブレット・プロパティは、単一引用符でくくられた、インラインJavaScriptを受け取ることができます。JavaScriptのフォーマットはユーザー自身の責任で行います。

全てのインラインJavaScriptはセミコロン(;)で終わらせる必要があります。例えば、'alert("hello world");'のようになります。JavaScriptを単一引用符で囲まなくてはいけないため（これはバックグラウンドで行われます）、プログラム中で単一引用符を使用できません。使用する必要がある場合は、外部のJavaScriptファイルの中にファンクションを作成し、インライン・コードからこれを呼び出すという方法があります。

JavaScriptを必要とするプロパティの多くは、イベントに応じて実行されるか、何らかのアクションを実行するために先行して実行されます。例えば、std_buttonウェブレットのpresubmit_jsプロパティは、フォームがサーバーに送られる直前に実行されます。これにより、いくつかプロセスを追加したり、イベント/アクションをキャンセルすることができます。イベント/アクションをキャンセルするには、"return false;"を使用します。

例えば次のようになります。

if ( confirmWithUser() == false) return false;

(confirmWithUserは外部のJavaScriptファイルに定義されたファンクションです。)

JavaScript 注意事項:

インラインJavaScriptでreturnやreturn trueを使用しないでください。これはLANSAのJavaScriptの実行を停止するというreturn falseと同様の効果がありますが、ブラウザがデフォルト値のイベント処理を実行するのは停止しません。これにより、予期せぬ動作が引き起こされる可能性があります。
{ and } の文字は、XSLT内で特別な意味があり、JavaScriptプロパティでは使用できません。使用すると、奇妙な動作を引き起こします。この文字を必要とする複雑なJavaScriptを書く必要がある場合は、JavaScriptファンクションを別途作成し、プロパティからこれを呼び出すようにしてください。
以前のバージョンのドキュメントでは、JavaScriptをダブル・バックスラッシュ(//)で終わらせて、デフォルト値の処理をキャンセルするよう説明されていました。このテクニックはreturnを使用するのと同じ効果があり、使用すべきではありません。