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

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

前 | 次 |

# 13.18 SWITCHファンクション

このファンクションは、フリップ・トグル・アイテムを動的に生成します。オン/オフ値とラベルが指定されない場合は、Yes/Noトグルが表示されます。`APEX_ITEM`で使用できる他のファンクションと同様、SWITCHファンクションも、F01からF50のフォームの配列要素でフォームを生成するように設計されています。

構文

    APEX_ITEM.SWITCH(
         p_idx IN NUMBER,
         p_value IN VARCHAR2,
         p_on_value IN VARCHAR2 DEFAULT 'Y',
         p_on_label IN VARCHAR2 DEFAULT 'Yes',
         p_off_value IN VARCHAR2 DEFAULT 'N',
         p_off_label IN VARCHAR2 DEFAULT 'No',
         p_item_id IN VARCHAR2 DEFAULT NULL,
         p_item_label IN VARCHAR2,
         p_attributes IN VARCHAR2 DEFAULT NULL)
         RETURN VARCHAR2;

パラメータ

表13-18 SWITCHのパラメータ

パラメータ | 説明
--- | ---
`p_idx` | フォーム要素名。たとえば、1はF01、2はF02です。通常、`P_IDX`パラメータは指定した列の定数です。
`p_value` | フォーム要素の現行の値。
`p_on_value` | ユーザーが「オン」オプションを選択した場合のアイテムの値。
`p_on_label` | 「オン」オプションの表示テキスト。
`p_off_value` | ユーザーが「オフ」オプションを選択した場合のアイテムの値。
`p_off_label` | 「オフ」オプションの表示テキスト。
`p_item_id` | <input>タグのHTML属性のID。一意になるように、一部の文字列と行番号との連結を試みます。
`p_item_label` | アイテムに対して作成された非表示のラベル。
`p_attributes` | フォーム・アイテムで使用する追加のHTML属性。

例

次の例では、`APEX_ITEM.SWITCH`を使用して、次に示す条件でYes/Noのフリップ・トグル・アイテムを生成する方法を示します。

- フォーム配列要素F01が生成される(`p_idx`パラメータ)。

- 各要素の初期値はNに等しくなります(`p_value`パラメータ)。

- 各行に対してHTML ID属性が生成され、現在の行番号が一意に識別されます(`p_item_id`パラメータ)。行2に対しては`'IS_MANAGER_2'`のIDが1つ生成されます。

- 各行に対してHTMLラベル要素が生成される(`p_item_label`パラメータ)。

    SELECT
      ename "Name",
      APEX_ITEM.SWITCH (
           p_idx => 1,
           p_value => 'N',
       p_item_id => 'IS_MANAGER_'||rownum,
           p_item_label => apex_escape.html(ename)||': Is Manager' )
    "Is Manager"
    FROM emp;