| Oracle® Application Express APIリファレンス リリース4.2 for Oracle Database 12c B71340-03 |
|
 前 |
 次 |
このセクションでは、Oracle Application Expressに付属する、すべてのページで使用可能なJavaScriptのファンクションおよびオブジェクトについて説明します。これらのファンクションおよびオブジェクトを使用することで、クライアント側の機能(ページ要素の表示/非表示、XML HTTP Asynchronous JavaScriptおよびXML (AJAX)リクエストの作成など)を提供できます。
|
注意: レガシーJavaScript。ページのレンダリング時にApplication ExpressによってロードされるJavaScriptの合計サイズを削減する作業が開始されました。各ページで提供されなくなったJavaScript機能は、徐々にレガシーJavaScriptファイルに移動され、/i/libraries/apex/legacy.jsで確認できます。
アプリケーションの開発時に、開発者は、レガシーJavaScript機能を含めるかどうかを選択できます。これは、アプリケーションの「共有コンポーネント」の下にある「ユーザー・インタフェース属性」ページで、「レガシーJavaScriptを含める」プロパティを使用して行うことができます。 既存のアプリケーションは、下位互換性を確保するために、このオプションを有効にして移行されます。レガシー・ファイルを含めないようにするには、レガシー・ファイルにリスト表示されているファンクションを確認し、アプリケーションおよび関連するJavaScriptファイルがこれらのファイルを参照していないかを検索する必要があります。これらの機能への参照が見つからなかった場合は、レガシー・ファイルを含めずに、より小さいライブラリの利益を得ることができます。 新しいアプリケーションの開発時は、 このレガシーJavaScriptへの依存性を減らすため、新しいアプリケーションの開発と既存のアプリケーションの開発の両方で、legacy.jsにある機能の使用を継続しないことをお薦めします。 |
トピック:
apexネームスペースは、グローバル変数と非常によく使用されるファンクションをApplication Expressに格納します。
この項では、このネームスペースのグローバル変数について説明しています。
現在のページ・コンテキストを格納するApplication Express変数。現在のページ・コンテキストは、そのページがデスクトップか、jQuery Mobileページかによって異なります。デスクトップの場合は、文書レベルに設定されます。jQuery Mobileの場合、ページは実際にはブラウザのDOMのDIV要素として表され、複数ページのDIVをブラウザのDOMに同時にロードできるので、これは現在のページを表すDIV要素に設定されます。
これを使用してjQueryセレクタのコンテキストを設定し、セレクタが正しいページのコンテキスト内で確実に実行されるようにします。
次に例を示します。
jQuery( ".my_class", apex.gPageContext$ );
これは、現在のページ・コンテキストで、CSSクラスがmy_classのすべての要素を選択します。
apex.confirmファンクションは、確認を表示し、ユーザーの選択に応じてページを送信するか、ページの送信をキャンセルします。このファンクションには、次の2つのシグネチャがあります。
トピック:
確認にメッセージ(pMessage)を表示し、ユーザーの選択に応じてページ設定リクエスト値(pRequest)を送信するか、またはページ送信を取り消します。
パラメータ
pMessage (string) pRequest (string)
例
この例では、確認ダイアログ・ボックスに「Delete Department」というテキストが表示されます。ユーザーが削除を選択すると、REQUESTの値が'DELETE'の現在のページが送信されます。
apex.confirm('Delete Department', 'DELETE');
メッセージ(pMessage)を表示する確認画面を表示し、ユーザーの選択に基づいて、pOptionsによって指定したリクエスト値を設定するページを送信するか、またはページの送信をキャンセルします。
パラメータ
pMessage (string) pOptions (Object) where pOptions can contain the following properties: submitIfEnter - If you only want to confirm when the ENTER key has been pressed, call apex.confirm in the event callback and pass the event object as this parameter. request - The request value to set (defaults to null) set - Object conatining name/value pairs of items to be set on the page prior to submission(defaults to null). showWait - Flag to control if a 'Wait Indicator' icon is displayed, which can be useful when running long page operations (Defaults to false).
戻り値
Boolean - submitIfEnterオプションが指定されている場合、ブール値を戻します。[Enter]キーが押されていればtrue、[Enter]キーが押されていなければfalseを戻します。submitIfEnterが指定されていない場合、戻り値はありません。
例
この例では、「Save Department?」というテキストの確認メッセージが表示されます。ユーザーが保存を選択すると、REQUEST値がSAVEのページが送信され、2つのページ・アイテム値が設定されます(P1_DEPTNOが10、P1_EMPNOが5433)。
apex.confirm("Save Department?", {
request:"SAVE",
set:{"P1_DEPTNO":10, "P1_EMPNO":5433}
});
apex.submitファンクションは、現在のページを送信します。このファンクションには、次の2つのシグネチャがあります。
トピック:
このファンクションは、pOptionsで指定したオプションを使用してページを送信します。
パラメータ
pOptions (Object) where pOptions can contain the following properties: submitIfEnter - If you only want to submit when the ENTER key has been pressed, call apex.submit in the event callback and pass the event object as this parameter. request - The request value to set (defaults to null) set - Object conatining name/value pairs of items to be set on the page prior to submission(defaults to null). showWait - Flag to control if a 'Wait Indicator' icon is displayed, which can be useful when running long page operations (Defaults to false).
戻り値
Boolean - submitIfEnterオプションが指定されている場合、ブール値を戻します。[Enter]キーが押されていればtrue、[Enter]キーが押されていなければfalseを戻します。submitIfEnterが指定されていない場合、戻り値はありません。
例
この例では、REQUESTの値が'DELETE'のページを送信します。2つのページ・アイテム値P1_DEPTNOが10、P1_EMPNOが5433に設定されています。送信中は、待機アイコンがユーザーへのインジケータとして表示されます。
apex.submit({
request:"DELETE",
set:{"P1_DEPTNO":10, "P1_EMPNO":5433});
このネームスペースは、Oracle Application Expressのすべての動的アクション・ファンクションを保持します。
このファンクションは動的アクションの実行を再開します。動的アクションの実行は、アクションの「結果を待機」属性がチェックされていれば一時停止できます。「結果を待機」はAjaxベース動的アクションと使用されるように設計された動的アクション・プラグインの標準属性です。プラグインがこの属性を示すと、プラグインJavaScriptコードの関連場所でこのファンクションを呼び出すことで、実行を再開する必要があります。そうしないと、アクションが動的アクションの実行をブレークします。
パラメータ
pCallback (ファンクション) - this.resumeCallbackプロパティから使用可能なコールバック・ファンクションを参照する、必須パラメータです。
pErrorOccurred (ブール) - エラーが発生したかどうかをフレームワークに示す、必須パラメータです。エラーが発生し、アクションの「エラー時に実行停止」属性がチェックされている場合、動的アクションの実行は停止します。
戻り値
なし
例1
エラーが発生していない(たとえば、Ajaxベース・アクションの正常なコールバックから)ことを示すアクションの実行を再開します。
apex.da.resume( lResumeCallback, false );
例2
エラーが発生した(たとえば、Ajaxベース・アクションのエラーのコールバックから)ことを示すアクションの実行を再開します。アクションの状態
「エラー時に実行停止」属性がチェックされている場合、動的アクションの実行は停止します。
apex.da.resume( lResumeCallback, true );
apex.eventネームスペースは、Oracle Application Expressのすべてのイベント関連ファンクションを格納します。
トピック:
jQueryセレクタ、jQueryオブジェクトまたはDOMノードを指定すると、指定したpEventがトリガーされます。pEventは、「クリック」や「変更」のようなブラウザ・イベントですが、「スライド変更」のようなカスタム・イベントでもあります。このファクションは、動的アクション・フレームワークによって処理されるイベントをトリガーする場合にのみ使用する必要があります。そうしないと、アプリケーションにインストールされたプラグインによって登録されたカスタム・イベントや動的アクションですでに公開されているイベントが危険にさらされる可能性があります。
戻り値
Boolean
パラメータ
pSelector (jQuery selector | jQuery object | DOM Node) pEvent (String) pData (Object)
これはAPEXページ・アイテムのネームスペースです。このネームスペースには、すべての単一アイテムのファンクションが保持されています。このようなファンクションは、これらがAPEX生成のページ・アイテムであることを前提としています。
トピック:
apex.item APIによって、Application Expressのアイテム関連機能に単一のインタフェースが提供されます。このAPIでApplication Expressアイテム・オブジェクトを戻し、そのアイテムをアイテム関連のファンクションおよびプロパティにアクセスするために使用できます。
プラグイン開発者は、apex.widget.initPageItemをオーバーライドで呼び出すことによって、apex.itemネームスペースに定義された動作の多くをオーバーライドできます。詳細は、apex.widget.initPageItem( pName, pOptions)のドキュメントを参照してください。
戻り値
表23-1「apex.item( pNd )の戻り値」は、このファンクションの戻り値を示しています。
表23-1 apex.item( pNd )の戻り値
| タイプ | 説明 |
|---|---|
|
(オブジェクト) |
Application Expressのアイテム・オブジェクトを戻し、このオブジェクトが、アイテム固有のファンクションへのアクセスに使用されます。たとえば、 |
パラメータ
表23-2「apex.item( pNd )のパラメータ」は、このファンクションに利用可能なパラメータを示しています。
表23-2 apex.item( pNd )のパラメータ
| 名前 | タイプ | オプション/必須 | デフォルト | 説明 |
|---|---|---|---|---|
|
|
(DOMノード|文字列) |
必須 |
Application Expressのアイテム名またはDOMノード。 |
例
これは、それ自体では使用されず、前述のAPIで説明されているように、アイテム固有のファンクションおよびプロパティにアクセスするために使用されます。
複数の値をサポートするApplication Expressアイテムに値を追加します。
戻り値
なし。
パラメータ
表23-3「apex.item( pNd ).addValue( pValue )のパラメータ」は、このファンクションに利用可能なパラメータを示しています。
例
この例では、P1_ITEMと呼ばれるページ・アイテムにおいて、現在選択された値に値100が追加されます。
apex.item( "P1_ITEM" ).addValue('100') ;
アイテム・タイプを考慮してApplication Expressのアイテム値を無効にし、編集不可にします。
戻り値
なし。
パラメータ
なし。
例
この例では、P1_ITEMと呼ばれるページ・アイテムは無効化され、編集不可となります。
apex.item( "P1_ITEM" ).disable() ;
アイテム・タイプを考慮してApplication Expressのアイテム値を有効化し、編集可能にします。
戻り値
なし。
パラメータ
なし。
例
この例では、P1_ITEMと呼ばれるページ・アイテムは有効化され、編集可能となります。
apex.item( "P1_ITEM" ).enable() ;
現在のアイテム・タイプを考慮して、ページにおけるApplication Expressのアイテムの現行値を戻します。これはセッション・ステートからアイテムの現行値を戻すのではなく(同じである可能性もありますが)、現在のページ上にある値を戻します。
アイテム値を戻す.getValue(). $v( pNd )に関連するファンクションは2つあり、この形式でアイテム値は送信されます。これは単一の値か、またはアイテムが複数の値をサポートする場合は、: (コロン)で区切られた値リストとなります。$v2( pNd )ファンクションもあり、これは.getValue()へのショートカットで、単一の値または値の配列のいずれかを戻します。
戻り値
表23-4「apex.item( pNd ).getValue()の戻り値」は、このファンクションの戻り値を示しています。
表23-4 apex.item( pNd ).getValue()の戻り値
| 名前 | 説明 |
|---|---|
|
(文字列|配列) |
単一の文字列値か、アイテムが複数の値をサポートする場合(たとえば「選択リスト」の「複数選択を許可」属性を「はい」または「シャトル」・ネイティブ・アイテム・タイプに設定)は、文字列値の配列のいずれかを戻します。 |
パラメータ
なし。
例
この例では、P1_ITEMと呼ばれるページ・アイテムの現行値は、アラートで表示されます。
alert( "P1_ITEM value = " + apex.item( "P1_ITEM" ).getValue() );
アイテム・タイプを考慮して、Application Expressのアイテム値を非表示にします。.hide()ファンクションを使用するときは、次を理解することが重要です。
非表示となっているアイテムが、表のレイアウトを使用しているページ(このページが、「グリッド・レイアウト・タイプ」が「HTML表」に設定されているページ・テンプレートを参照している)でレンダリングされ、非表示にするためのコールで表の行全体の非表示を指定すると(pHideRow = TRUE)、このアイテムに関連するすべてがこの行に含まれると見なされ、行全体が非表示になります。
非表示となっているアイテムが、表のレイアウトを使用しているページでレンダリングされ、非表示にするためのコールで表の行全体の非表示を指定しないと(pHideRow = FALSE、または指定しない)、ファンクションは、アイテムのIDがFOR属性に一致する場合に、そのアイテムのラベルを非表示にしようとします。
非表示となっているアイテムが、グリッド・レイアウトを使用しているページ(このページが「グリッド・レイアウト・タイプ」が「固定列数」または「可変列数」に設定されているページ・テンプレートを参照している)でレンダリングされ、このアイテムが既知のIDのある「フィールド・コンテナ」要素を含む「ラベル」・テンプレートを参照している場合(「フィールド・コンテナ」→「「ラベルの前」とアイテム」属性にid="#CURRENT_ITEM_CONTAINER_ID#"のHTML要素が含まれる場合)、このアイテムに関連するすべてが「フィールド・コンテナ」に含まれると見なされ、非表示になります。
戻り値
なし。
パラメータ
表23-5「apex.item( pDN ).hide( pHideRow )のパラメータ」は、このファンクションに利用可能なパラメータを示しています。
表23-5 apex.item( pDN ).hide( pHideRow )のパラメータ
| 名前 | タイプ | オプション/必須 | デフォルト | 説明 |
|---|---|---|---|---|
|
|
(文字列|配列) |
オプション |
FALSE |
TRUEの場合、表の同じ行(TR)が非表示となります。アイテムが表のレイアウトを使用しているページにある場合(ページが「グリッド・レイアウト・タイプ」が「HTML表」に設定されているページ・テンプレートを参照している場合)にのみ、適用可能です。 |
例
この例では、P1_ITEMと呼ばれるページ・アイテムは非表示になります。P1_ITEMがグリッド・レイアウトを使用しているページ上にあり、そのアイテムが、「フィールド・コンテナ」要素と既知のIDが含まれる「ラベル」・テンプレートを参照している場合(詳細については前述のとおり)、このコンテナ要素は非表示になります。その他の場合は、アイテムおよび対応するラベルは非表示になります。
apex.item( "P1_ITEM" ).hide();
この例では、P1_ITEMと呼ばれるページ・アイテムが含まれる表行全体(TR)は、非表示になります(pHideRow = TRUEのため)。表の行全体の非表示は、表のレイアウトを使用するページ上でのみ使用してください。P1_ITEMがグリッド・レイアウトを使用しているページ上にある場合、pHideRow = TRUEの引き渡しが機能せず、表の行が誤って非表示になり、ページ・レイアウトに悪影響が生じます。
apex.item( "P1_ITEM" ).hide(TRUE);
Application Expressのアイテムが空かどうかでtrueまたはfalseを戻し、空白、タブ、フォーム・フィードなどの空白文字は、空とみなされます。これは、アイテム・タイプが「LOV」を使用し、「NULL戻り値」が「LOV」で定義されているかどうかについても考慮します。この場合、「NULL戻り値」は、アイテムが空である場合にアサートするために使用されます。この場合、戻されるDOMノードは、pNdの最も近い祖先で、pToTagのノード名を持ち、オプションでクラスが一致するものになります。また、pNdが見つからない場合、またはpToTag祖先が存在しない場合にも、falseを戻します。
戻り値
表23-6「apex.item( pNd ).isEmpty()のパラメータ」は、このファンクションの戻り値を示しています。
表23-6 apex.item( pNd ).isEmpty()のパラメータ
| タイプ | 説明 |
|---|---|
|
(ブール) |
Application Expressのアイテムが空かどうかでtrueまたはfalseを戻します。 |
パラメータ
なし。
例
この例では、P1_ITEMと呼ばれるページ・アイテムがnullかどうかを.isEmpty()へのコールによって確認し、nullの場合はアラートが表示されます。
if( apex.item( "P1_ITEM" ).isEmpty() ) {
alert( "P1_ITEM empty!" );
}
特定のアイテムがどのようにフォーカスを受け取るように設計されているかを考慮し、ユーザーのフォーカスをApplication Expressのアイテムに移動します。
戻り値
なし。
パラメータ
なし。
例
この例では、ユーザーのフォーカスはP1_ITEMと呼ばれるページ・アイテムに設定されています。
apex.item( "P1_ITEM" ).setFocus();
特定のアイテムがどのようにスタイル設定されるように設計されているかを考慮し、Application Expressのアイテムにスタイルを設定します。
戻り値
なし。
パラメータ
表23-7「apex.item( pNd ).setStyle( pPropertyName, pPropertyValue )のパラメータ」は、このファンクションに利用可能なパラメータを示しています。
表23-7 apex.item( pNd ).setStyle( pPropertyName, pPropertyValue )のパラメータ
| 名前 | タイプ | オプション/必須 | デフォルト | 説明 |
|---|---|---|---|---|
|
|
(CSSプロパティ名) |
必須 |
設定されるCSSプロパティ名。 |
|
|
|
(CSSプロパティ値) |
必須 |
CSSプロパティを設定するために使用される値。 |
例
この例では、CSSプロパティのcolorが、P1_ITEMと呼ばれるページ・アイテムに対してredに設定されています。
apex.item( "P1_ITEM" ).setStyle( "color", "red" );
アイテム・タイプを考慮して、Application Expressのアイテム値を設定します。このファンクションは、ページ上のApplication Expressアイテムの現行値を設定し、アイテムのセッション・ステートにおける現行値は設定しません。これによってコール元は、必要に応じて、設定されるアイテムにchangeイベントを抑止することもできます。
.setValue()へのショートカットについては、$s( pNd, pValue, pDisplayValue, pSuppressChangeEvent )ファンクションに関する説明を参照してください。
戻り値
なし。
パラメータ
表23-8「apex.item (pNd ).setValue( pValue, pDisplayValue, pSuppressChangeEvent)のパラメータ」は、このファンクションに利用可能なパラメータを示しています。
表23-8 apex.item (pNd ).setValue( pValue, pDisplayValue, pSuppressChangeEvent)のパラメータ
| 名前 | タイプ | オプション/必須 | デフォルト | 説明 |
|---|---|---|---|---|
|
|
(文字列|配列) |
必須 |
設定される値。複数の値をサポートするアイテムの場合(例: Shuttle)、1つ文字列値配列を渡すことで、複数の値を一度に設定できます。 |
|
|
|
(文字列) |
オプション |
戻り値が異なる場合に、ページ・アイテムの表示値を設定するために使用されるオプションのパラメータ。たとえば、アイテム・タイプ「ポップアップLOV」の「入力フィールド」属性が「入力不可、表示値の表示と戻り値の格納」の場合、この値で「入力フィールド」が設定されます。このアイテムの非表示の戻り値フィールドを設定するには、pValueの値を使用します。 |
|
|
|
(ブール) |
オプション |
FALSE |
設定されているアイテムがchangeイベントによってトリガーされないようにするには、TRUEを渡します。 |
例
この例では、P1_ITEMと呼ばれるページ・アイテムの値は、10に設定されます。pSuppressChangeEventが渡されていないため、デフォルトの動作である、P1_ITEMをトリガーするchangeイベントが発生します。
apex.item( "P1_ITEM" ).setValue( "10" );
この例でP1_ITEMは、「入力フィールド」属性が「入力不可、表示値の表示と戻り値の格納」となっている「ポップアップLOV」のページ・アイテムであり、「入力フィールド」に設定されます。P1_ITEMの表示値は"SALES"に設定され、非表示の戻り値が10に設定されます。pSuppressChangeEventパラメータにtrueが渡されているため、P1_ITEMに関してchangeイベントはトリガーされません。
apex.item( "P1_ITEM" ).setValue( "10", "SALES", true );
アイテム・タイプを考慮して、Application Expressのアイテム値を表示します。.show()ファンクションを使用するときは、次を理解することが重要です。
表示となっているアイテムが、表のレイアウトを使用しているページ(このページが、「グリッド・レイアウト・タイプ」が「HTML表」に設定されているページ・テンプレートを参照している)でレンダリングされ、表示にするためのコールで表の行全体の表示を指定すると(pShowRow = TRUE)、このアイテムに関連するすべてがこの行に含まれると見なされ、行全体が表示になります。
表示となっているアイテムが、表のレイアウトを使用しているページでレンダリングされ、表示にするためのコールで表の行全体の表示を指定しないと(pShowRow = FALSE、または指定しない)、ファンクションは、アイテムのIDがFOR属性に一致する場合に、そのアイテムのラベルを表示にしようとします。
表示となっているアイテムが、グリッド・レイアウトを使用しているページ(このページが「グリッド・レイアウト・タイプ」が「固定列数」または「可変列数」に設定されているページ・テンプレートを参照している)でレンダリングされ、このアイテムが既知のIDのある「フィールド・コンテナ」要素を含む「ラベル」・テンプレートを参照している場合(「フィールド・コンテナ」→「「ラベルの前」とアイテム」属性にid="#CURRENT_ITEM_CONTAINER_ID#"のHTML要素が含まれる場合)、このアイテムに関連するすべてが「フィールド・コンテナ」に含まれると見なされ、表示になります。
戻り値
なし。
パラメータ
表23-9「apex.item ( pNd ).show( pShowRow )のパラメータ」は、このファンクションのパラメータを示しています。
表23-9 apex.item ( pNd ).show( pShowRow )のパラメータ
| 名前 | タイプ | オプション/必須 | デフォルト | 説明 |
|---|---|---|---|---|
|
|
(文字列|配列) |
オプション |
FALSE |
TRUEの場合、表の同じ行(TR)が表示となります。アイテムが表のレイアウトを使用しているページにある場合(ページが「グリッド・レイアウト・タイプ」が「HTML表」に設定されているページ・テンプレートを参照している場合)にのみ、適用可能です。 |
例
この例では、P1_ITEMと呼ばれるページ・アイテムが表示されます。P1_ITEMがグリッド・レイアウトを使用しているページ上にあり、そのアイテムが、「フィールド・コンテナ」要素と既知のIDが含まれる「ラベル」・テンプレートを参照している場合(詳細については前述のとおり)、このコンテナ要素は表示されます。その他の場合には、アイテムおよび対応するラベルが表示されます。
apex.item( "P1_ITEM" ).show();
この例では、P1_ITEMと呼ばれるページ・アイテムが含まれる表行全体(TR)が表示されます(pShowRow = TRUEのため)。表の行全体の表示は、表のレイアウトを使用するページ上でのみ使用してください。P1_ITEMがグリッド・レイアウトを使用しているページ上にある場合、pShowRow = TRUEの引き渡しが機能せず、表の行が誤って表示され、ページ・レイアウトに悪影響が生じます。
apex.item( "P1_ITEM" ).show(TRUE);
apex.navigationネームスペースは、Oracle Application Expressのポップアップおよびリダイレクト関連ファンクションを格納します。
トピック:
apex.serverネームスペースは、Oracle Application Expressのサーバー部分と通信するためのすべてのAJAX機能を格納します。
トピック:
このファンクションは、プラグインに定義されたPL/SQL AJAXファンクションをコールします。このファンクションは、jQuery.ajaxファンクションのラッパーであり、Application Expressに固有の追加機能に加えて、jQueryファンクションで提供されるすべての設定をサポートします。
パラメータ
表23-10 apex.server.plugin(pAjaxIdentifier,pData,pOptions)のパラメータ
| パラメータ | タイプ | オプション/必須 | 説明 |
|---|---|---|---|
|
|
(文字列) |
必須 |
PL/SQLパッケージ |
|
|
｛オブジェクト｝ |
オプション |
AJAXリクエストとともに送信される追加の値を送信するためにオプションで使用可能なオブジェクト。タイプにjQueryセレクタ、jQueryオブジェクト、DOMオブジェクトまたはアイテム名の配列を選択できる特別な属性 |
|
|
｛オブジェクト｝ |
オプション |
AJAXによって使用される追加のオプションを設定するためにオプションで使用可能なオブジェクト。 これは、次に示すApplication Expressに固有のオプションの属性をサポートします。
function( pLoadingIndicator ) {
return pLoadingIndicator.prependTo ( apex.jQuery( "td.shuttleControl", gShuttle ))
}
参照: 使用可能な他のすべての属性については、 |
戻り値
例
apex.server.pluginへのこのコールによって、スカラー値x01がtest (apex_application.g_x01を使用してPL/SQLからアクセス可能)に設定され、セッション・ステートにページ・アイテムのP1_DEPTNOおよびP1_EMPNOの値が(jQueryセレクタ構文を使用して)設定されます。apexbeforerefreshイベントおよびapexafterrefreshイベントを起動する要素として、P1_MY_LISTアイテムが使用されます。P1_MY_LISTは、横にロード・インジケータが表示される要素として使用されます。成功のコールバックはスタブ・アウトされ、コールが正常に戻された際に起動される独自のコードを開発者が追加するために使用されます。
成功のコールバックに対するpDataパラメータには、コールから送信されるすべてのレスポンスが含まれます。
apex.server.plugin ( lAjaxIdentifier, {
x01: "test",
pageItems: "#P1_DEPTNO,#P1_EMPNO"
}, {
refreshObject: "#P1_MY_LIST",
loadingIndicator: "#P1_MY_LIST",
success: function( pData ) { ... do something here ... }
} );
このファンクションは、プラグインに定義されたPL/SQL AJAXファンクションに対してGETリクエストを発行するためのURLを戻します。
パラメータ
表23-12 apex.server.pluginUrl( pAjaxIdentifier, pData)のパラメータ
| 名前 | タイプ | オプション/必須 | デフォルト | 説明 |
|---|---|---|---|---|
|
|
(文字列) |
必須 |
PL/SQLパッケージ |
|
|
|
｛オブジェクト｝ |
オプション |
URLに含む追加の値を設定するためにオプションで使用可能なオブジェクト。タイプにjQueryセレクタ、jQueryオブジェクト、DOMオブジェクトまたはアイテム名の配列を選択できる特別な属性 |
戻り値
例
apex.server.pluginUrlへのこのコールによって、プラグインに定義されたPL/SQL AJAXファンクションに対してGETリクエストを発行するためのURLが戻され、スカラー値x01がtest (apex_application.g_x01を使用してPL/SQLからアクセス可能)に設定され、セッション・ステートにページ・アイテムのP1_DEPTNOおよびP1_EMPNOの値が(jQueryセレクタ構文を使用して)設定されます。
var lUrl;
lUrl = apex.server.pluginUrl ( pAjaxIdentifier, {
x01: "test",
pageItems: "#P1_DEPTNO,#P1_EMPNO" } );
このファンクションは、ページ・レベルまたはアプリケーション・レベルで定義されたPL/SQLのオンデマンド・プロセスをコールします。このファンクションは、jQuery.ajaxファンクションのラッパーであり、Application Expressの追加機能を提供するとともに、jQueryファンクションで提供されるすべての設定をサポートします。
パラメータ
表23-14 apex.server.processパラメータ
| 名前 | タイプ | オプション/必須 | デフォルト | 説明 |
|---|---|---|---|---|
|
|
(文字列) |
必須 |
PL/SQLパッケージ |
|
|
|
｛オブジェクト｝ |
オプション |
AJAXリクエストとともに送信される追加の値を送信するためにオプションで使用可能なオブジェクト。タイプにjQueryセレクタ、jQueryオブジェクト、DOMオブジェクトまたはアイテム名の配列を選択できる特別な属性 |
|
|
|
｛オブジェクト｝ |
オプション |
AJAXによって使用される追加のオプションを設定するためにオプションで使用可能なオブジェクト。 次に示す、Application Express固有のオプションの属性をサポートします。
function( pLoadingIndicator ) {
return lLoadingIndicator.prependTo ( apex.jQuery(
"td.shuttleControl", gShuttle ))
}
参照: 使用可能な他のすべての属性については、 このオブジェクトの詳細は、jQueryドキュメントを参照してください。 |
戻り値
例
apex.server.processへのこのコールによって、MY_PROCESSというオンデマンド・プロセスがコールされ、スカラー値x01がtest (apex_application.g_x01を使用してPL/SQLからアクセス可能)に設定され、セッション・ステートにページ・アイテムのP1_DEPTNOおよびP1_EMPNOの値が(jQueryセレクタ構文を使用して)設定されます。成功のコールバックはスタブ・アウトされ、コールが正常に戻された際に起動される独自のコードを開発者が追加するために使用されます。
注意: 成功のコールバックに対するpDataパラメータには、コールから送信されるすべてのレスポンスが含まれます。
apex.server.process ( "MY_PROCESS", {
x01: "test",
pageItems: "#P1_DEPTNO,#P1_EMPNO"
}, {
success: function( pData ) { ... do something here ... }
} );
apex.widgetネームスペースは、Oracle Application Expressのすべてのウィジェット関連の汎用ファンクションを格納します。
トピック:
Application Expressのページ・アイテム名やDOMノードを指定すると、異なるコールバックおよびプロパティをページ・アイテムに登録できます。これは、プラグイン・アイテム・タイプに、Application Expressのクライアント側機能に関する組込みページ・アイテムをシームレスに統合するために必要です。
プラグインの実装の詳細は、『Oracle Application Expressアプリケーション・ビルダー・ユーザーズ・ガイド』のプラグインの実装に関する説明を参照してください。
オラクル社によって作成された例については、OTNのプラグイン・リポジトリを参照してください。
http://apex.oracle.com/plugins
戻り値
なし。
パラメータ
表23-16「apex.widget.initPageItem( pName, pOptions )のパラメータ」は、このファンクションで利用可能なパラメータを示しています。
表23-16 apex.widget.initPageItem( pName, pOptions )のパラメータ
| 名前 | タイプ | オプション/必須 | デフォルト | 説明 |
|---|---|---|---|---|
|
|
(DOMノード|文字列) |
必須 |
Application Expressのページ・アイテム名またはDOMノード。 |
|
|
|
(オブジェクト) |
必須(個別のプロパティはオプション) |
コールバックおよび一部のアイテム固有値を指定するための、多くのプロパティをサポートします。これらのプロパティを指定することで、特定のプロパティに対してApplication Expressのデフォルト動作をオーバーライドできます。
|
表23-17 pOptionsパラメータのプロパティ
| 名前 | 説明 |
|---|---|
|
|
アイテム値を取得するためのファンクションを指定します(これによって、デフォルトのページ・アイテムの処理がオーバーライドされます)。アイテムが値を正しく戻すようにするということは、たとえばアイテムでWhen条件を評価するための「動的アクション」、またはアイテムの値を取得するためにJavaScriptファンクション$vをコールする場合などに、Application Expressのクライアント側機能に関する特定のアイテムが動作しているということです。 このファンクションを定義する方法の詳細は、「apex.item( pNd ).getValue()」を参照してください。 注意: Application Expressのそのアイテムのデフォルト処理が動作しているかどうかを最初にチェックする必要があります(動作している場合はこれを指定する必要がありません)。アイテム値が正確に戻されているかどうかを確認するために、 |
|
|
アイテム値を設定するためのファンクションを指定します(これによって、ページ・アイテムのデフォルトの処理がオーバーライドされます)。アイテムが値を正しく設定できるようにするということは、たとえば「動的アクション」の「値の設定」アクションを使用してアイテム値を設定する場合や、JavaScriptファンクション$sをコールしてアイテムの値を設定する場合などに、Application Expressのクライアント側機能に関する特定のアイテムが動作しているということです。 注意: このファンクションが定義されている場合でも、デフォルト処理によって常に このファンクションを定義する方法の詳細は、「apex.item( pNd ).setValue(pValue, pDisplayValue, pSuppressChangeEvent)」を参照してください。 注意: Application Expressのそのアイテムのデフォルト処理が動作しているかどうかを最初にチェックする必要があります(動作している場合はこれを指定する必要がありません)。アイテム値が正確に設定されているかどうかを確認するために、 |
|
|
アイテムを有効化するためのファンクションを指定します(これによって、デフォルトのページ・アイテムの処理がオーバーライドされます)。これは、有効化も必要な複合要素からアイテムが構成されている場合、または再利用しようとする独自の有効化メソッドをすでに保有しているウィジェットにアイテムが基づいている場合などに、役立つ可能性があります。アイテムを正しく有効化できるようにするということは、たとえばアイテムを有効化するために「動的アクション」の「有効化」アクションを使用する場合に、Application Expressのクライアント側機能に関する特定のアイテムが動作していることになります 注意: このファンクションが定義されている場合でも、デフォルト処理によって常に このファンクションを定義する方法の詳細は、「apex.item( pNd ).enable()」を参照してください。 注意: Application Expressのそのアイテムのデフォルト処理が動作しているかどうかを最初にチェックする必要があります(動作している場合はこれを指定する必要がありません)。アイテムが正しく有効化されているかどうかを確認するために、 |
|
|
アイテムを無効化するためのファンクションを指定します(これによって、デフォルトのページ・アイテムの処理がオーバーライドされます)。これは、無効化も必要な複合要素からアイテムが構成されている場合、または再利用しようとする独自の無効化メソッドをすでに保有しているウィジェットにアイテムが基づいている場合などに、役立つ可能性があります。アイテムを正しく無効化できるようにするということは、たとえばアイテムを無効化するために「動的アクション」の「無効化」アクションを使用する場合に、Application Expressのクライアント側機能関連の特定のアイテムが動作していることになります。 注意: このファンクションが定義されている場合でも、デフォルト処理によって常に このファンクションを定義する方法の詳細は、「apex.item( pNd ).disable()」を参照してください。 注意: Application Expressのそのアイテムのデフォルト処理が動作しているかどうかを最初にチェックする必要があります(動作している場合はこれを指定する必要がありません)。アイテムが正しく無効化されているかどうかを確認するために、 |
|
|
アイテムを表示するためのファンクションを指定します(これによって、デフォルトのページ・アイテムの処理がオーバーライドされます)。これは、表示も必要な複合要素からアイテムが構成されている場合、または再利用しようとする独自の表示メソッドをすでに保有しているウィジェットにアイテムが基づいている場合などに、役立ちます。アイテムを正しく表示できるようにするということは、たとえば「動的アクション」の「表示」アクションを使用する場合に、Application Expressのクライアント側機能に関する特定のアイテムが動作してアイテムを表示するということです。 このファンクションを定義する方法の詳細は、「apex.item( pNd ).show( pShowRow )」を参照してください。 注意: Application Expressのそのアイテムのデフォルト処理が動作しているかどうかを最初にチェックする必要があります(動作している場合はこれを指定する必要がありません)。アイテムが正しく表示されているかどうかを確認するために、 |
|
|
アイテムを非表示にするためのファンクションを指定します(これによって、デフォルトのページ・アイテムの処理がオーバーライドされます)。これは、非表示も必要な複合要素からアイテムが構成されている場合、または再利用しようとする独自の非表示メソッドをすでに保有しているウィジェットにアイテムが基づいている場合などに、役立つ可能性があります。アイテムを正しく非表示にできるようにするということは、たとえば「動的アクション」の「非表示」アクションを使用する場合に、Application Expressのクライアント側機能に関する特定のアイテムが動作してアイテムを非表示にするということです。 このファンクションを定義する方法の詳細は、「apex.item( pNd ).hide( pHideRow)」を参照してください。 注意: Application Expressのそのアイテムのデフォルト処理が動作しているかどうかを最初にチェックする必要があります(動作している場合はこれを指定する必要がありません)。アイテムが正しく非表示になっているかどうかを確認するために、 |
|
|
アイテムが複数の値をサポートする場合、アイテムに値を追加するためのファンクションを指定します。現在、これに依存するApplication Expressのクライアント側の機能はありません。デフォルトのページ・アイテム処理もありません。 注意: このファンクションが定義されている場合でも、デフォルト処理によって常に このファンクションを定義する方法の詳細は、「apex.item( pNd ).addValue( pValue )」を参照してください。 |
|
|
アイテムがnullかどうかの判断に使用される値を指定します。これは、アイテムが「LOV」の定義をサポートする場合、開発者がアイテムの「NULL戻り値」を定義できる場合、およびアイテムがnullまたは空の場合にアサートするため、これをデフォルトのアイテム処理で認識する必要がある場合に使用されます。これは、次の手順に従って行います。
|
|
|
アイテムがフォーカスを正しく設定できるようにするということは、たとえば「動的アクション」の このAPIの詳細は、「apex.item( pNd ).setFocus()」を参照してください。 注意: Application Expressのそのアイテムのデフォルト処理が動作しているかどうかを最初にチェックする必要があります(動作している場合はこれを指定する必要がありません)。このページでページ属性 |
|
|
注意: このプロパティが定義されている場合でも、デフォルト処理によって常に このAPIの詳細は、 注意: Application Expressのそのアイテムのデフォルト処理が動作しているかどうかを最初にチェックする必要があります(動作している場合はこれを指定する必要がありません)。アイテムがスタイルを正確に設定しているかどうかを確認するために、 |
|
|
アイテムが変更された後で、呼び出されるファンクションを指定します。これは、たとえばjQuery Mobileなどの一部のフレームワークでウィジェットの変更の有無が通知される必要があるときに(例: 値が設定されたり、これらがネイティブ制御と拡張制御の両方を同期するために無効化されたなど)役立ちます。これを行うためのフックが、このコールバックによって提供されます。 |
|
|
アイテムの一部のページのリフレッシュ中に、アイテムのロード・インジケータが表示される方法を標準化するファンクションを指定します。このファンクションは、最初のパラメータとして これはたとえば、アイテムが |
例
次の例では、利用可能なすべてのコールバックおよびプロパティが渡されたapex.widget.initPageItemへのコールを示しています。
apex.widget.initPageItem( "P100_COMPANY_NAME", {
getValue: function() {
var lValue;
// code to determine lValue based on the item type.
return lValue;
},
setValue: function( pValue, pDisplayValue ) {
// code that sets pValue and pDisplayValue (if required), for the item type
},
enable: function() {
// code that enables the item type
},
disable: function() {
// code that disables the item type
},
show: function() {
// code that shows the item type
},
hide: function() {
// code that hides the item type
},
addValue: function( pValue ) {
// code that adds pValue to the values already in the item type
},
nullValue: "<null return value for the item>",
setFocusTo: $( "<some jQuery selector>" ),
setStyleTo: $( "<some jQuery selector>" ),
afterModify: function(){
// code to always fire after the item has been modified (value set, enabled, etc.)
},
loadingIndicator: function( pLoadingIndicator$ ){
// code to add the loading indicator in the best place for the item
return pLoadingIndicator$;
}
});
この項には、Oracle Application Expressのその他すべての非ネームスペースのAPIが含まれています(非常によく使用されるファンクションへのショートカットを含む)。
トピック:
DOMノードまたは文字列ID (pNd)を指定すると、このファンクションは、その要素がページ上に存在する場合はDOMノードを戻し、存在しない場合はfalseを戻します。
戻り値
(DOM Node | false)
パラメータ
pNd (DOM Node | string ID)
DOMノードまたは文字列ID (pNd)を指定すると、このファンクションは、Application Expressアイテムがポストされた場合と同じ形式で、その値を戻します。
パラメータ
pNd (DOM Node | string ID)
DOMノードまたは文字列ID(pNd)を指定すると、このファンクションは、Application Expressアイテムの値を文字列または配列として戻します。ページ・アイテムに、シャトル、チェックボックス、複数選択リストなど、複数の値が含まれる場合は配列が戻され、そうでない場合は文字列が戻されます。
戻り値
(string|array)
パラメータ
pNd (DOM Node | string ID)
DOMノードまたは文字列ID(pNd)を指定すると、このファンクションは、そのApplication Expressアイテムの型を考慮に入れて、値を設定します。pDisplayValueはオプションです。「入力フィールド」属性が「入力不可、表示値の表示と戻り値の格納」である、「ポップアップLOV」タイプのページ・アイテムに使用する場合、「入力フィールド」を設定します。pValueの値は非表示の戻り値フィールドに格納されます。pSuppressChangeEventパラメータの指定は任意です。FALSEを渡した場合、またはこのパラメータ値を渡さない場合は、変更イベントが生成され、設定されているアイテムを実行します。変更イベントによって設定されているアイテムが実行されるのを防ぐには、TRUEを渡します。
パラメータ
pNd (DOM Node | string ID) pValue (String | Array) pDisplayValue(String) pSuppressChangeEvent(Boolean)
DOMノード、文字列IDまたは配列(pNd)を指定すると、このファンクションは、pNdが配列でも、要素が1つしかなく、その要素の値が戻される場合には単一値を戻し、それ以外の場合は配列を戻します。1つまたは複数のDOMノードに対応可能なDOMベースの機能を作成する場合に使用されます。
戻り値
Array (DOM Node | string ID | Array)
パラメータ
Array or first value
指定されたDOMノード、文字列IDまたは配列(pNd)に対して、このファンクションは配列を戻します。1つまたは複数のDOMノードに対応可能なDOMベースの機能を作成する場合に使用されます。
戻り値
pNd (DOM Node | string ID | Array)
パラメータ
Array
pTestが空またはfalseの場合はpDefaultを戻し、それ以外の場合はpTestを戻します。
戻り値
(string | Array)
パラメータ
pTest (String | Array) pDefault (String | Array)
DOMノードまたはDOMノード配列(pNd)の特定のスタイル・プロパティ(pStyle)を指定の値(pString)に設定します。
戻り値
(DOM node | DOM Array)
パラメータ
pNd (DOM node | string ID | DOM node Array ) pStyle (String) pString (String)
1つのDOMノードまたは配列のDOMノード(pNd)を非表示にします。非表示にされているApplication Expressアイテムのタイプも考慮されます。
戻り値
(DOM node | Array)
パラメータ
pNd (DOM node | string ID | DOM node Array )
1つのDOMノードまたは配列のDOMノード(pNd)を表示します。非表示にされているApplication Expressアイテムのタイプも考慮されます。
戻り値
(DOM node | Array)
パラメータ
pNd (DOM node | string ID | DOM node Array )
1つのDOMノードまたは配列のDOMノード(pNd)を切り替えます。
戻り値
(DOM node | Array)
パラメータ
pNd (DOM node | string ID | Array)
1つのDOMノードまたは配列のDOMノードを削除します。
戻り値
(DOM Node | Array)
パラメータ
pNd (DOM node | string ID | DOM node Array)
1つのDOMノードまたは配列のDOMノード(pNd)の値(pValue)を設定します。
戻り値
Not applicable.
パラメータ
pNd (DOM node | string ID | DOM node Array) pValue (String)
このファンクションは、DOMノード(pNd)から開始して、ノード名のタグ(pToTag)が検出されるまでDOMツリーの上位の方にカスケードします。オプションのpToClassが指定されている場合、祖先ノードはpToTagと同じノード名を持ち、pToClassと同じクラスである必要があります。
戻り値
(DOM Node | false)
パラメータ
pNd (DOM Node | string ID) String (pToTag) String (pToClass )
DOMノードまたはDOMノードの配列を指定すると、このファンクションは、そのDOMノードまたはDOMノードの配列を含む行全体を表示するか、非表示にするか、または切り替えます。これは、ページ・アイテムを使用する場合に最も役立ちます。このファンクションは、含まれるtr要素を明示的に検索するため、表のレイアウトでのみ機能します。
戻り値
Not applicable.
パラメータ
pNd (DOM Node | string ID | Dom node Array) pFunc ['TOGGLE','SHOW','HIDE'] (String )
ページ・アイテム名を指定すると、このファンクションは、そのアイテムを保持している行全体を非表示にします。ほとんどの場合、これはアイテムおよびそのラベルです。このファンクションは、含まれるtr要素を明示的に検索するため、表のレイアウトでのみ機能します。
戻り値
Not applicable.
パラメータ
pNd (DOM Node | string ID | DON node Array)
ページ・アイテム名を指定すると、このファンクションは、そのアイテムを保持している行全体を表示します。ほとんどの場合、これはアイテムおよびそのラベルです。このファンクションは、含まれるtr要素を明示的に検索するため、表のレイアウトでのみ機能します。
戻り値
Not applicable.
パラメータ
pNd (DOM node | string ID | DOM note Array)
ページ・アイテム名(pNd)を指定すると、このファンクションは、そのアイテムを保持している行全体を切り替えます。ほとんどの場合、これはアイテムおよびそのラベルです。このファンクションは、含まれるtr要素を明示的に検索するため、表のレイアウトでのみ機能します。
戻り値
Not applicable.
パラメータ
pNd (DOM node | string ID | DOM node ray)
pNdArrayから参照されているすべてのDOMノードを非表示にし、pNdで参照されているDOMノードを表示します。これは、pNdがpNdArrayのノードでもある場合に最も役立ちます。
戻り値
(DOM node | DOM Array)
パラメータ
pNd (DOM node | string ID | DOM node Array) pNdArray (DOM node | String | Array)
指定されたDOMノード(pNd)の兄弟DOMノードをすべて表示します。
戻り値
(DOM node)
パラメータ
pNd (DOM node | string ID )
1つのDOMノードまたは配列のDOMノードを1つのクラス名に設定します。
戻り値
Not applicable.
パラメータ
pNd (DOM node | string ID | DOM node Array) pClass (String)
ノード(pNd)のすべての兄弟DOMノードのクラス(pClass)を設定します。pNdClassがNULLでない場合、pNdはpNdClassに設定されます。
戻り値
(DOM node | false)
パラメータ
pNd (DOM Nnde | string ID) pClass (String) pThisClass (String)
指定されたクラス名(pClass)に基づいて、DOMノードの配列を戻します。pNdパラメータが提示されている場合、戻される要素はすべてそのDOMノードの子になります。pTagパラメータも指定すると、戻り値が絞り込まれて、そのタグ・タイプのノードのみが戻されます。
戻り値
(Array)
パラメータ
pClass (String) pNd (DOM node | string ID) pTag (String)
DOMノード(pNd)の子で、特定のクラス(pClass)およびタグ(pTag)を持つDOMノードをすべて表示します。
戻り値
Not applicable.
パラメータ
pNd (DOM node | string ID) pClass (String) pTag (String)
DOMノード(pNd)の子のDOMノードをすべて表示します。
戻り値
Not applicable.
パラメータ
pNd (DOM node | string ID)
DOMノード(pNd)の子のDOMノードをすべて非表示にします。
戻り値
Not applicable.
パラメータ
pNd (DOM node | string ID)
1つのアイテムまたは配列のアイテムを、(pTest)に基づいて無効または有効にします。
戻り値
Not applicable.
パラメータ
pNd (DOM node | string ID | DOM node array) a (true | false)
1つのアイテムまたは配列のアイテムが空かどうかをチェックし、空のすべてのアイテムについてそのクラスをpClassFailに設定します。空でないすべてのアイテムについては、クラスをpClassに設定します。
戻り値
false, Array Array of all items that are empty (false | Array)
パラメータ
pNd (DOM node | string ID | DOM node Array) Sting (pClassFail) Sting (pClass)
アイテムの値を配列として戻します。ラジオ・アイテムおよびチェック・ボックスで役立ちます。
戻り値
(Array)
パラメータ
pId (DOM node | string ID)
1つのDOMノードまたは配列のDOMノードの内容をクリアし、そのノードを非表示にします。
戻り値
Not applicable.
パラメータ
pNd (DOM node | string ID | DOM node array)
選択アイテム(pNd)の選択されたオプションのDOMノードを戻します。
戻り値
(DOM Array)
パラメータ
pNd (DOM node | string ID)
選択アイテム(pNd)の選択されたオプションの値を戻します。
戻り値
(DOM Array | String)
パラメータ
pNd (DOM node | string ID)
指定された配列(pArray)について、その値を指定の区切り文字(pDelim)で区切った文字列を戻します。
戻り値
Not applicable.
パラメータ
pArray (pArray) pDelim (String)
イメージ(pId)のsource属性に、部分文字列(pSearch)が含まれているかどうかをチェックします。ファンクションは、部分文字列(pSearch)が見つかった場合にtrueを戻します。検出されない場合はfalseが戻ります。
戻り値
(true | false)
パラメータ
pId (DOM Node | String) pSearch (pSearch)
ページ・アイテム(pThis)の値と、一連の値(pValue)を照合します。値が一致すると、このファンクションはtrueを戻します。
戻り値
(true | false)
パラメータ
pThis (DOM node | string ID) pValue (Number | String | Array)
ページ・アイテム(pThis)の値と値(pValue)を照合します。一致した場合は、DOMノード(pThat)が非表示に設定されます。一致しなかった場合は、DOMノード(pThat)が表示されるように設定されます。
戻り値
(true | false)
パラメータ
pThis (DOM node | string ID) pThat (DOM node | string ID | DOM node Array ) pValue (Number | String | Array)
ページ・アイテム(pThis)の値と値(pValue)を照合します。一致した場合は、DOMノード(pThat)が表示に設定されます。一致しなかった場合は、DOMノード(pThat)が非表示にされるように設定されます。
戻り値
(true | false)
パラメータ
pThis (DOM node | string ID) pThat (DOM node | string ID | DOM node Array ) pValue (Number | String | Array)
アイテム(pThis)の値(pValue)をチェックします。一致した場合、このファンクションは、表内の(pThat)を保持する行を非表示にします。一致しなかった場合は、その行を表示します。
戻り値
(true | false)
パラメータ
pThis (DOM node | string ID) pThat (DOM node | string ID | DOM node Array ) pValue (Number | String | Array)
アイテム(pThis)の値(pValue)をチェックします。一致した場合、このファンクションは、表内の(pThat)を保持する行を表示します。一致しなかった場合は、その行を非表示にします。
戻り値
(true | false)
パラメータ
pThis (DOM node | string ID) pThat (DOM node | string ID | DOM node Array ) pValue (Number | String | Array)
アイテム(pThis)の値(pValue)をチェックします。一致した場合、このファンクションは、そのアイテムまたは配列のアイテム(pThat)を無効にします。一致しなかった場合は、アイテムを有効にします。
戻り値
(true | false)
パラメータ
pThis (DOM node | string ID) pValue (String) pThat (DOM node | string ID | DOM node Array )
配列のノードをクラスによって選択し、そのクラス属性を設定します。
戻り値
(DOM node | DOM node Array)
パラメータ
pNd (DOM node | string ID) pClass (String) pTag (String) pClass2 (String)
クラス属性が(pClass)、ノード名が(pTag)のDOMノード(pThis)に含まれるフォーム・アイテムの値を収集して、配列を戻します。
戻り値
No applicable.
パラメータ
pThis (DOM node | string ID) pCLass (String) pTag (String)
特定のタイプ(pType)のDOMノード(pThis)に含まれているフォーム入力アイテムをすべて戻します。
戻り値
DOM node Array
パラメータ
pNd (DOM node | string ID) pType (String)
DOMノード(pThis)に含まれるすべてのチェック・ボックスを選択または選択解除(pCheck)します。DOMノードのチェック・ボックスの配列(pArray)が指定されている場合は、その配列を対象のチェック・ボックスとして使用します。
戻り値
Not applicable.
パラメータ
pThis (DOM node | string ID) pCheck (true | fales) pArray (DOM node array)
このファンクションは、表の最初の列にあるすべてのチェック・ボックスを、コール先のチェック・ボックス(pNd)の選択状態に基づいて設定します。これは、表形式のフォームで役立ちます。
戻り値
DOM node Array
パラメータ
pNd (DOM node | String)
親ウィンドウ(pThat)内のアイテムの値を(pValue)に設定してから、ポップアップ・ウィンドウを閉じます。
|
注意: この関数は非推奨です。この場合は、次を使用します。apex.navigation.popup.close(pThat,pValue) 既存のアプリケーションでは、レガシーJavaScriptファイル(legacy.js)が含まれるため、古い機能を引き続き使用できます。このファイルを含めるかどうかの制御方法の詳細は、『Oracle Application Expressアプリケーション・ビルダー・ユーザーズ・ガイド』のデータベース・アプリケーションに関する説明を参照してください。 |
戻り値
Not applicable.
パラメータ
pValue (string) pThat (DOM node | string ID)
イメージ要素(pThis)およびDOMノード(pNd)を指定すると、このファンクションは、DOMノード(pNd)の表示状態を切り替えます。イメージ要素(pThis)のsrc属性はリライトされます。イメージのsrcは、プラスの部分文字列がマイナスの部分文字列で置換されるか、またはマイナスの部分文字列がプラスの部分文字列で置換されます。
戻り値
(DOM Node)
パラメータ
pThis (DOM Node | string ID) pNd (DOM Nnde | string iD | DOM node Array)
イメージ(pId)のsrc属性に部分文字列(pSearch)が含まれているかどうかをチェックします。その部分文字列が検出されると、このファンクションはイメージのsrc属性全体を(pReplace)で置換します。
戻り値
(DOM node | false)
パラメータ
pNd (DOM node | string ID) pSearch (String) pReplace (String)
イメージ(pNd)のsource属性に、部分文字列(pSearch)が含まれているかどうかをチェックします。ファンクションは、部分文字列(pSearch)が見つかった場合にtrueを戻します。検出されない場合はfalseが戻ります。
戻り値
(true | fales)
パラメータ
pNd (DOM node | string ID) pSearch (String)
文字列(pText)に部分文字列(pMatch)が含まれるかどうかで、trueまたはfalseを戻します。
戻り値
(true | false)
パラメータ
pText (String) pMatch (String)
DOMメソッドを使用して、DOMノード(pND)の子のDOMをすべて削除します。
戻り値
Not applicable.
パラメータ
pNd (DOM node | string ID)
フォーム要素が空かどうかでtrueまたはfalseを戻します(空白、タブ、フォーム・フィードなどの空白文字は、空とみなされます)。アイテムで指定された任意のNULL値も考慮されます。
|
注意: この関数は非推奨です。この場合は、次を使用します。既存のアプリケーションでは、レガシーJavaScriptファイル(legacy.js)が含まれるため、古い機能を引き続き使用できます。このファイルを含めるかどうかの制御方法の詳細は、『Oracle Application Expressアプリケーション・ビルダー・ユーザーズ・ガイド』のデータベース・アプリケーションに関する説明を参照してください。 |
戻り値
[true | false]
パラメータ
pThis (DOM Node | String)
選択アイテム(pId)の値(pValue)を設定します。値が検出されない場合、このファンクションは最初のオプションを選択します(通常はNULLを選択します)。
戻り値
Not applicable.
パラメータ
pId (DOM node | String) pValue (String)
onloadファンクション(func)を追加します。すでに指定されたonloadファンクションが存在している場合でも、そのファンクションは上書きされません。
戻り値
Not applicable.
パラメータ
pFunction (Javascript Function)
2つのフォーム要素(pThis、pThat)のフォーム値を交換します。
戻り値
Not applicable.
パラメータ
pThis (DOM Node | String) pThat (DOM Node | String)
テキスト・フィールドで[Enter]が押されたときにページを送信し、リクエスト値をDOMノード(pNd)のIDに設定します。
例: onkeypress="submitEnter(this,event)"
|
注意: この関数は非推奨です。この場合は、次を使用します。
|
戻り値
Not applicable.
パラメータ
pNd (DOM node | String | Array)
フォーム・アイテムの配列(pArray)に(pMultiple)の倍数の連番を設定します。
戻り値
Not applicable.
パラメータ
pArray (Array) pMultiple (Number)
innerHTMLを(pText)に設定し、html要素(pTag)をDOMノード(pThis)の子ノードとして挿入します。
戻り値
DOM node
パラメータ
pThis (DOM node | string ID ) pTag (String) pText (String)
表のセルを表の行(pThis)に追加します。内容を(pText)に設定します。
戻り値
(DOM node)
パラメータ
pThis (DOM node | string ID) pText (String)
表のセルを表の行(pThis)に追加します。内容を(pText)に設定します。
戻り値
DOM node
パラメータ
pThis (DOM node | string ID) pTest (String)
ID (pId)および名前(pName)の値をpValueに設定して、htmlフォーム入力要素(pType)をDOMノード(pThis)の子ノードとして挿入します。
戻り値
(DOM node)
パラメータ
pThis (DOM node | string ID) pType (String) pId (String) pName (String) pValue (String)
DOMノード(p_Node)をDOMノード(p_Parent)の子にしてから、DOMノード(pNode)を戻します。
戻り値
(DOM node)
パラメータ
p_This (DOM node | string ID) p_Parent (DOM node | string ID)
表の行のDOM要素(pThis)を指定すると、このファンクションは、表のすべてのセルの背景色を(pColor)に設定します。グローバル変数gCurrentRowはpThisに設定されます。
戻り値
Not applicable.
パラメータ
pThis (DOM node | String) pColor(String)
表の行のDOMノード(pThis)を指定すると、このファンクションは、表のすべてのセルの背景をNULLに設定します。
戻り値
Not applicable.
パラメータ
pThis (DOM Element | String)
DOMノード(pThis)の子ノードで、そのinnerHTMLがpStringのいずれかのインスタンスに一致するものを非表示にします。子ノードを絞り込むには、タグ名(pTag)またはクラス名(pClass)を指定します。子ノードは、表示可能に設定されている場合にブロック・レベル要素に設定されます。
戻り値
Not applicable.
パラメータ
pThis (DOM node | String) pString (String) pTags (String pClass (String)
ポップアップからのアイテムの移入に使用できるように、DOMアイテムをグローバル変数returnInput(p_R)およびreturnDisplay(p_D)に設定します。
|
注意: このファンクションは非推奨であり、値が非常に制限されるため、かわりの値はありません。既存のアプリケーションでは、レガシーJavaScriptファイル(legacy.js)が含まれるため、古い機能を引き続き使用できます。このファイルを含めるかどうかの制御方法の詳細は、『Oracle Application Expressアプリケーション・ビルダー・ユーザーズ・ガイド』のデータベース・アプリケーションに関する説明を参照してください。 |
戻り値
Not applicable.
パラメータ
p_R p_D
ユーザーのフォーカスをフォーム・アイテム(pNd)に移動します。pNdが検出されなかった場合は、ユーザー編集が可能なフィールドで、最初に検出されたフィールドにフォーカスが移動します。
戻り値
true (if successful)
パラメータ
pNd
Cookie名(pName)の値を戻します。
|
注意: この関数は非推奨です。この場合は、次を使用します。既存のアプリケーションでは、レガシーJavaScriptファイル(legacy.js)が含まれるため、古い機能を引き続き使用できます。このファイルを含めるかどうかの制御方法の詳細は、『Oracle Application Expressアプリケーション・ビルダー・ユーザーズ・ガイド』のデータベース・アプリケーションに関する説明を参照してください。 |
戻り値
Not applicable.
パラメータ
pName (String)
Cookie (pName)を指定の値(pValue)に設定します。
|
注意: この関数は非推奨です。この場合は、次を使用します。apex.storage.setCookie(pName,pValue) 既存のアプリケーションでは、レガシーJavaScriptファイル(legacy.js)が含まれるため、古い機能を引き続き使用できます。このファイルを含めるかどうかの制御方法の詳細は、『Oracle Application Expressアプリケーション・ビルダー・ユーザーズ・ガイド』のデータベース・アプリケーションに関する説明を参照してください。 |
戻り値
Not applicable.
パラメータ
pName (String) pValue (String)
