5 APEX_CSS

APEX_CSSパッケージには、CSSスタイルをHTTP出力に追加するためのユーティリティ・ファンクションが用意されています。通常、このパッケージはプラグイン開発に使用されます。

トピック:

ADDプロシージャ
ADD_3RD_PARTY_LIBRARY_FILEプロシージャ
ADD_FILEプロシージャ

ADDプロシージャ

このプロシージャは、HTML出力にインラインで含められるCSSスタイルのスニペットを追加します。このプロシージャは、新しいCSSスタイルの宣言を追加する場合に使用します。

構文

APEX_CSS.ADD (
    p_css          IN    VARCHAR2,
    p_key          IN    VARCHAR2 DEFAULT NULL);

パラメータ

表5-1に、ADDプロシージャで使用可能なパラメータを示します。

表5-1 ADDのパラメータ

パラメータ	説明
`p_css`	CSSスタイルのスニペット。たとえば、`#test {color:#fff}`とします。
`p_key`	スタイル・スニペットの識別子。指定して、同じ名前のスタイル・スニペットがすでに追加されている場合、新しいスタイル・スニペットは無視されます。

例

クラス・オートコンプリートのインラインCSS定義をHTMLページに追加します。キーautocomplete_widgetは、apex_css.addが再度コールされた場合に定義が再度追加されるのを防ぎます。

apex_css.add (
    p_css => '.autocomplete { color:#ffffff }',
    p_key => 'autocomplete_widget' );

ADD_3RD_PARTY_LIBRARY_FILEプロシージャ

このプロシージャは、サード・パーティのcssファイルをロードするためのリンク・タグを追加し、アプリケーションに関して指定したコンテンツ配信ネットワークも考慮します。サポートされるライブラリは、jQuery、jQueryUI、jQueryMobileです。

ライブラリがすでに追加されている場合、再度追加されることはありません。

構文

add_3rd_party_library_file ( 
    p_library in varchar2, 
    p_file_name in varchar2, 
    p_directory in varchar2 default null, 
    p_version in varchar2 default null, 
    p_media_query in varchar2 default null );

パラメータ

表5-2に、ADD_3RD_PARTY_LIBRARY_FILEプロシージャで使用可能なパラメータを示します。

表5-2 ADD_3RD_PARTY_LIBRARY_FILEパラメータ

パラメータ	説明
`p_library`	c_library_*定数のいずれかを使用します。
`p_file_name`	バージョン、.minおよび.cssを含めずにファイル名を指定します。
`p_directory`	ファイル`p_file_name`があるディレクトリ(オプション)。
`p_version`	値が指定されていない場合、同じバージョンのApplication Expressの値が使用されます(オプション)。
`p_media_query`	メディア問合せとして設定される値(オプション)。

例

次の例では、jQuery UIのアコーディオン・コンポーネントのカスケード・スタイルシート・ファイルをロードします。

apex_css.add_3rd_party_library_file (
    p_library   => apex_css.c_library_jquery_ui,
    p_file_name => 'jquery.ui.accordion' )

ADD_FILEプロシージャ

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

構文

APEX_CSS.ADD_FILE (
    p_name           IN    VARCHAR2,
    p_directory      IN    VARCHAR2 DEFAULT WWV_FLOW.G_IMAGE_PREFIX||'css/',
    p_version        IN    VARCHAR2 DEFAULT NULL,
    p_skip_extension IN    BOOLEAN DEFAULT FALSE
    p_media_query    IN    VARCHAR2 DEFAULT NULL,
    p_ie_condition   IN    VARCHAR2 DEFAULT NULL);

パラメータ

表5-3では、ADD_FILEプロシージャで使用可能なパラメータについて説明します。

表5-3 ADD_FILEのパラメータ

パラメータ	説明
`p_name`	CSSファイルの名前。
`p_directory`	CSSファイルの読取り元となるURLの開始。このファンクションをプラグインに対して使用する場合は、このパラメータに`p_plugin.file_prefix`を設定する必要があります。
`p_version`	CSSファイルのバージョンの識別子。バージョンはCSSファイル名に追加されます。ほとんどの場合、値にデフォルトのNULLを使用することをお薦めします。
`p_skip_extension`	このファンクションは、CSSファイル名に自動的に.cssを追加します。このパラメータにTRUEを設定すると追加されません。
`p_media_query`	メディア問合せとして設定される値。
`p_ie_condition`	Internet Explorerの条件として使用される条件。

例

p_plugin.image_prefixに指定したディレクトリのCSSファイルjquery.autocomplete.cssをページのHTML出力に追加します。apex_css.add_fileがその名前で複数回コールされた場合でも1回のみ含められるようにします。

apex_css.add_file (
    p_name => 'jquery.autocomplete',
    p_directory => p_plugin.image_prefix );