1. APIリファレンス
  2. APEX_JAVASCRIPT
  3. ADD_LIBRARYプロシージャ

30.8 ADD_LIBRARYプロシージャ

このプロシージャは、JavaScriptライブラリをロードするためのスクリプト・タグを追加します。ライブラリが追加されている場合、2回目は追加されません。

構文

APEX_JAVASCRIPT.ADD_LIBRARY (
    p_name                    IN VARCHAR2,
    p_directory               IN VARCHAR2,
    p_version                 IN VARCHAR2 DEFAULT NULL,
    p_check_to_add_minified   IN BOOLEAN  DEFAULT FALSE,
    p_skip_extension          IN BOOLEAN  DEFAULT FALSE,
    p_ie_condition            IN VARCHAR2 DEFAULT NULL,
    p_requirejs_module        IN VARCHAR2 DEFAULT NULL,
    p_requirejs_js_expression IN VARCHAR2 DEFAULT NULL,
    p_requirejs_required      IN BOOLEAN  DEFAULT FALSE,
    p_is_module               IN BOOLEAN  DEFAULT FALSE,
    p_is_async                IN BOOLEAN  DEFAULT FALSE,
    p_is_defer                IN BOOLEAN  DEFAULT FALSE,
    p_attributes              IN VARCHAR2 DEFAILT NULL,
    p_key                     IN VARCHAR2 DEFAULT NULL )

パラメータ

表30-7 ADD_LIBRARYのパラメータ

パラメータ 説明
p_name JavaScriptファイルの名前。指定時に.jsを使用する必要はありません。
p_directory JavaScriptライブラリをロードするディレクトリ。末尾のスラッシュを付ける必要があります。
p_version バージョン識別子。
p_check_to_add_minified TRUEの場合、プロシージャは.min拡張子の追加が適切かどうかをテストし、適切な場合は追加します。これは、アプリケーションがDEBUGモードで実行されていない場合に追加され、DEBUGモードでは省略されます。
p_skip_extension TRUEの場合、拡張子.jsは追加されません。
p_ie_condition Internet Explorerの条件として使用される条件。
p_requirejs_module RequireJSにライブラリを公開する際に使用されるモジュール名。
p_requirejs_js_expression RequireJSモジュールにライブラリを公開する際に使用されるJavaScript式。
p_requirejs_required ライブラリが他のJavaScriptファイルをロードするためにそのコードでRequireJSを使用する場合は、trueである必要があります。
p_key ライブラリがすでにロードされているかどうかを示すために使用する名前。指定しなければ、p_directory||p_name||p_versionにデフォルト設定します。
p_key ライブラリがすでにロードされているかどうかを示すために使用する名前。指定しなければ、p_directory||p_name||p_versionにデフォルト設定します。
p_key ライブラリがすでにロードされているかどうかを示すために使用する名前。指定しなければ、p_directory||p_name||p_versionにデフォルト設定します。
p_is_module trueの場合、スクリプト・タグにtype="module"を追加します。
p_is_async trueの場合、スクリプト・タグに属性asyncを追加します。
p_is_defer

trueの場合、スクリプト・タグに属性deferを追加します。

deferは、asyncと組み合せて使用することはできません。

deferは、モジュール・スクリプトがデフォルトで遅延するため、type="module"と組み合せて使用しないでください。

p_attributes

スクリプト・タグに追加する追加属性。

ノート:

コール元がこのパラメータのエスケープに対して責任を持ちます。
p_key ライブラリがすでにロードされているかどうかを示すために使用する名前。指定しなければ、p_directory||p_name||p_versionにデフォルト設定します。

例

次の例には、p_plugin.file_prefixによって指定されているディレクトリにあるhammer-2.0.4.min.js (アプリケーションがビルダーから起動されていない場合)、またはhammer-2.0.4.js(アプリケーションがビルダーから起動されている場合、またはDEBUGモードで実行されている場合)という名前のJavaScriptライブラリ・ファイルが含まれます。p_skip_extensionが指定されていないため、これを.jsにデフォルト設定します。また、p_keyが指定されていないため、キーはp_plugin.file_prefix||hammer-2.0.4にデフォルト設定します。Hammerは、モジュール名にhammerjsを使用して、それ自身をRequireJSに公開するJavaScriptライブラリです。 

apex_javascript.add_library (
    p_name                    => 'hammer-2.0.4#MIN#',
    p_directory               => p_plugin.file_prefix,
    p_requirejs_module        => 'hammerjs',
    p_requirejs_js_expression => 'Hammer' );

親トピック: APEX_JAVASCRIPT