プライマリ・コンテンツに移動

Oracle® Application Express APIリファレンス リリース5.1 E85937-02 |
| 目次 | 索引

前 | 次 |

# 14.7 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_key                     IN VARCHAR2 DEFAULT NULL);

パラメータ

表14-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_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' );