31.17 レガシーJavaScript API

ページのレンダリング時にOracle Application ExpressによってロードされるJavaScriptの合計サイズを削減する作業が開始されました。各ページで提供されなくなったJavaScript機能は、徐々にレガシーJavaScriptファイルに移動され、/i/libraries/apex/legacy.jsで確認できます。

アプリケーションの開発時に、開発者は、レガシーJavaScript機能を含めるかどうかを選択できます。これは、アプリケーションの「共有コンポーネント」の下にある「ユーザー・インタフェース属性」ページで、「レガシーJavaScriptを含める」プロパティを使用して行うことができます。

既存のアプリケーションは、下位互換性を確保するために、このオプションを有効にして移行されます。レガシー・ファイルを含めないようにするには、レガシー・ファイルにリスト表示されているファンクションを確認し、アプリケーションおよび関連するJavaScriptファイルがこれらのファイルを参照していないかを検索する必要があります。これらの機能への参照が見つからなかった場合は、レガシー・ファイルを含めずに、より小さいライブラリの利益を得ることができます。

新しいアプリケーションの開発時は、Desktopユーザー・インタフェース・タイプを使用するすべてのアプリケーションに、デフォルトでレガシー・ファイルが含まれます。「jQuery Mobileスマートフォン」ユーザー・インタフェース・タイプを使用する新しいアプリケーションに、このファイルは含まれません。

このレガシーJavaScriptへの依存性を減らすため、新しいアプリケーションの開発と既存のアプリケーションの開発の両方で、legacy.jsにあるファンクションの使用を継続しないことをお薦めします。

31.17.1 $v_PopupReturn [非推奨]

親ウィンドウ(pThat)内のアイテムの値を(pValue)に設定してから、ポップアップ・ウィンドウを閉じます。

注意:

この関数は非推奨です。この場合は、次を使用します。

apex.navigation.popup

既存のアプリケーションでは、レガシーJavaScriptファイル(legacy.js)が含まれるため、古い機能を引き続き使用できます。このファイルを含めるかどうかの制御方法の詳細は、Oracle Application Expressアプリケーション・ビルダー・ユーザーズ・ガイドのデータベース・アプリケーションに関する説明を参照してください。

パラメータ

pValue (string)
pThat (DOM node | string ID)

戻り値

なし。

31.17.2 $v_IsEmpty [非推奨]

フォーム要素が空かどうかでtrueまたはfalseを戻します(空白、タブ、フォーム・フィードなどの空白文字は、空とみなされます)。アイテムで指定された任意のNULL値も考慮されます。

注意:

この関数は非推奨です。この場合は、次を使用します。

isEmpty

パラメータ

pThis (DOM Node | String)

戻り値

[true | false]

31.17.3 submitEnter [非推奨]

テキスト・フィールドで[Enter]が押されたときにページを送信し、リクエスト値をDOMノード(pNd)のIDに設定します。

例: onkeypress="submitEnter(this,event)"

注意:

この関数は非推奨です。この場合は、次を使用します。

apex.submit( { submitIfEnter : event })

submitIfEnter pOptionsプロパティの使用方法の詳細は、apex.submitを参照してください。既存のアプリケーションでは、レガシーJavaScriptファイル(legacy.js)が含まれるため、古いファンクションを引き続き使用できます。このファイルを含めるかどうかの制御方法の詳細は、Oracle Application Expressアプリケーション・ビルダー・ユーザーズ・ガイドのデータベース・アプリケーションに関する説明を参照してください。

パラメータ

pNd (DOM node | String | Array)

戻り値

なし。

31.17.4 setReturn [非推奨]

ポップアップからのアイテムの移入に使用できるように、DOMアイテムをグローバル変数returnInput(p_R)およびreturnDisplay(p_D)に設定します。

注意:

このファンクションは非推奨であり、値が非常に制限されるため、かわりの値はありません。

パラメータ

p_R
p_D

戻り値

なし。

31.17.5 GetCookie [非推奨]

Cookie名(pName)の値を戻します。

注意:

この関数は非推奨です。この場合は、次を使用します。

apex.storage.getCookie

パラメータ

pName (String)

戻り値

なし。

31.17.6 SetCookie [非推奨]

Cookie (pName)を指定の値(pValue)に設定します。

注意:

この関数は非推奨です。この場合は、次を使用します。

apex.storage.setCookie

パラメータ

pName (String)
pValue (String)

戻り値

なし。