ページ・レベル・アイテムの作成

チェック・ボックス

LOVを使用して表示します。チェック・ボックスとして表示されるアイテムには、LOVが必要です。選択したチェック・ボックスに対応する値が、コロンで区切られた文字列で戻されます。

次の例に、YESを戻す単一のチェック・ボックスを作成する方法を示します。この例では、チェック・ボックスとフィールド・ラベルの両方が表示されます。

SELECT NULL display_text, 'YES' return_value FROM DUAL;

次の例では、追加テキストClick to selectを含めます。

SELECT 'Click to select' display_text, 'YES' return_value FROM DUAL;

参照: 戻り値の分割については、Oracle Application Express APIリファレンスの「APEX_UTIL」を参照してください。

日付ピッカー

横にカレンダ・アイコンが付いたテキスト・フィールドを表示します。このアイコンをクリックすると小さいカレンダが表示され、ユーザーは日付および時刻を選択できます（オプション）。

必要な書式が「表示形式」リストに表示されない場合は、「日付ピッカー(アプリケーションの書式マスクを使用)」か「日付ピッカー(アイテムの書式マスクを使用)」を選択します。後者はページ・アイテムの編集ページの「ソース」セクションの「書式マスク」フィールドの値を使用します。

表示のみ

「テキストとして表示」には次のサブタイプがあります。

• テキストとして表示(状態は保存しない): フォーム・アイテムを作成せずに、アイテムのソース値をページ上に表示します。

• テキストとして表示(特殊文字をエスケープし、状態は保存しない): 特殊文字（'<'、'>'、'&'）をエスケープしてアイテムのソース値を表示します。

• テキストとして表示(状態を保存する): アイテムのソース値を表示し、値をセッション・ステートに渡すためページとともに送信されるフォーム・アイテムを作成します。

• テキストとして表示(LOVに基づき、状態は保存しない): アイテムのソース値をLOVの戻り値と照合することで、表示値をLOVから表示します。

• テキストとして表示(LOVに基づき、状態を保存する): 前述のオプションとほぼ同じですが、戻り値をセッション・ステートに渡すためページとともに送信されるフォーム・アイテムも生成します。

ファイル参照

「参照」ボタンが付いたテキスト・フィールドを表示します。「参照」ボタンを使用すると、ローカル・ファイル・システムのファイルを検索、およびアップロードできます。Oracle Application Expressは、これらのファイルをアップロードする表、およびファイルを取得するAPIを提供します。

参照: 「ファイルのアップロードの保護」

非表示

HTMLの非表示のフォーム要素をレンダリングします。セッション・ステートは、テキスト・フィールドと同様に割当ておよび参照することができます。

非表示で保護

HTMLの非表示のフォーム要素をレンダリングします。セッション・ステートは、テキスト・フィールドと同様に割り当てたり、参照することができます。たとえば、ページがOracle Application Expressによってレンダリングされた後でアイテムの値を変更するJavaScriptなどのように、クライアント側の動作がページにないかぎり、セキュリティを最高に保つため、「非表示」ではなく「非表示で保護」を使用します。

リスト・マネージャ

LOVに基づきます。このアイテムを使用すると、アイテムを選択し、リストに追加してアイテム・リストを管理できます。LOVはポップアップ表示されます。

複数選択

複数選択HTMLフォーム要素としてレンダリングします。実行時に、選択された値がコロンで区切られた文字列に戻されます。APEX_UTIL APIを使用して、値を分割できます。

参照: 「複数選択リスト・アイテムでの操作」およびOracle Application Express APIリファレンスの「APEX_UTIL」

パスワード

HTMLのパスワードのフォーム要素としてレンダリングします。使用可能なパスワードのタイプには、次のものがあります。

• パスワード: フィールドに入力されたテキストを非表示にします。ページの送信時に、セッション・ステートに値が保存されます。

• パスワード([Enter]を押すと送信): フィールドに入力されたテキストを非表示にします。[Enter]を押すと、ページが送信されます。

• パスワード(状態は保存しない): フィールドに入力されたテキストを非表示にします。セッション・ステートに値が保存されません。

• パスワード([Enter]を押すと送信し、状態は保存しない): フィールドに入力されたテキストを非表示にします。[Enter]を押すと、ページが送信されます。セッション・ステートに値が保存されません。

「パスワード」および「パスワード([Enter]を押すと送信)」では、ページの送信時にデータベース表にパスワードが保存されます。これらのパスワード・アイテム・タイプは、セッション中に他のページで使用するためにセッション・ステートのパスワードが必要になる場合にのみ使用します。

「パスワード(状態は保存しない)」および「パスワード([Enter]を押すと送信し、状態は保存しない)」では、データベース表にパスワードが保存されません。これらのパスワード・アイテム・タイプは、送信したパスワードの値が同じページでの送信後のページ・プロセスでのみ使用され、セッション中に要求されることがない場合にのみ使用します。

アプリケーションでパスワードの値を参照および取得する必要がある場合は、「セッション・ステートに暗号化された値を保存」属性を「はい」に設定します。詳細は、「セッション・ステートおよびセキュリティの概要」を参照してください。

ポップアップLOV

アイコン付きのテキスト・フィールドとしてレンダリングします。アイコンをクリックすると、ユーザーが選択した次のいずれかとともにポップアップ・ウィンドウが表示されます。

• 一連のリンクとして表示された値のリスト: このリストから選択すると、選択した値がテキスト・フィールドに配置されます。

• カラー・ピッカー: パレットから選択すると、選択した色のHTML値（たとえば黒は#000000）が戻されます。

カラー・ピッカーを除いて、テンプレートでポップアップLOVを制御します。アプリケーションごとに1つのみポップアップLOVを指定できます。ポップアップLOVは、単一のページに戻すには大きすぎるLOVに対して有効です。

ポップアップLOVには、ウィンドウがポップアップ表示された際に行セットをフェッチするものと、フェッチしないものの2つのタイプがあります。使用できるポップアップLOVは次のとおりです。

• ポップアップ・キーLOV (説明を表示し、キー値を戻す)

• ポップアップ・キーLOV (フェッチなし) (説明を表示し、プリフェッチせずにキー値を戻す)

• ポップアップLOV(最初の行セットおよびフィルタをフェッチ)

• ポップアップLOV(最初の行セットをフェッチ)

• ポップアップLOV(フェッチなし)

• ポップアップ・カラー・ピッカー

ポップアップLOVは、異なる列別名を持つ2つの列を選択する問合せに基づく必要があります。次に例を示します。

SELECT ename name, empno id 
   FROM emp

いずれかの列が式の場合は、別名を使用します。次に例を示します。

SELECT ename||' '||job display_value, empno FROM emp

ラジオ

LOVに基づいて、HTMLのラジオ・グループのフォーム要素としてレンダリングします。ラジオ・ボタンの選択時にページを送信するには、「送信機能付きラジオ・グループ」を選択します。

次の例では、従業員名（ename）が表示されますが、従業員番号（empno）が戻されます。

SELECT ename, empno FROM emp

選択リスト

LOVを使用して表示します。選択リストとしてアイテムを表示するには、LOVが必要です。選択リストは、HTMLフォーム要素<selectを使用してレンダリングされます。選択リストの値は、名前付きLOVまたはアイテム・レベルで定義されたLOVで決まります。表示値および戻り値にはNULLを指定できます。

次の例では、従業員名（ename）および従業員番号（empno）がemp表から戻されます。列の別名は必須ではありませんが、この例では、意味を明確にするために含まれています。

SELECT ename display_text, empno return_value FROM emp

Oracle Application Expressでは、標準的なHTML選択リストに加えて次の拡張機能が提供されます。

• 送信機能付き選択リスト: ユーザーがページで選択した値を変更すると、そのページが送信されます。ページが送信されると、選択リストを表すアイテム名にREQUESTが設定され、条件付き計算、検証、プロセスおよびブランチを実行できます。

• リダイレクト機能付き選択リスト: ユーザーを同じページにリダイレクトし、セッション・ステートの選択リストの新しく選択された値のみを設定します。

• URLリダイレクトを戻す選択リスト: 戻り値としてURLを含むLOVに基づきます。選択リストの値を変更すると、ブラウザが対応するURLにリダイレクトします。

• ページへのブランチ付き選択リスト: 戻り値としてページ番号を含むLOVに基づきます。選択リストで選択された値を変更すると、Application Expressエンジンが対応するページにブランチします。

注意: 選択リストが長くなると、エラーが発生する可能性があります。エラーが発生する長い選択リストがある場合は、その選択リストのかわりにポップアップLOVを使用することをお薦めします。

シャトル

複数のリストを含むボックスが2つある複数の選択リストとしてレンダリングします。左側にあるリストにはソースのLOVが表示されます。ユーザーはシャトル・コントロール・アイコンとボタンを使用してリスト・アイテムを選択し、左側にある「ソース」リストから右側にある「宛先」リストに移動します。各シャトルには、次の5つの制御があります。

• すべて移動: 「ソース」リストのすべてのアイテムを「宛先」リストに移動します。

• 選択項目を移動: 選択したアイテム（［Ctrl］+［Shift］でアイテムを選択）のみを「宛先」リストに移動します。

• 選択対象の削除: 選択したアイテム（［Ctrl］+［Shift］でアイテムを選択）のみを「ソース」リストに移動します。

• すべて削除: 「宛先」リストのすべてのアイテムを「ソース」リストに戻します。

• リフレッシュ: 「ソース」リストおよび「宛先」リストをリセットします。

右側にある「宛先」リストにはソート制御の「最上位に移動」ボタン、「上に移動」ボタン、「下に移動」ボタンおよび「最下位に移動」ボタンが含まれています。

注意: このアイテム・タイプを作成するにはLOVを定義する必要があります。「静的値リストの作成」、「LOVの作成」および「複数選択リスト・アイテムでの操作」を参照してください。

テキスト

最大30,000バイトのテキストを含むHTMLテキスト・フィールドとして表示します。「高さ」および「幅」アイテム属性を編集して最大長と表示幅を制御します。

使用可能なテキスト表示オプションは、次のとおりです。

• テキスト・フィールド: テキスト・フィールドとしてレンダリングします。

• テキスト・フィールド(無効、状態を保存しない): セッション・ステートのアイテムの値を使用してLOVから読取り専用バージョンの表示値を表示し、関連付けられたLOVで対応する表示値を検索します。画面に表示された値は、送信時にセッション・ステートには保存されません。

• テキスト・フィールド(無効、状態を保存する): セッション・ステートのアイテムの値を使用してLOVから読取り専用バージョンの表示値を表示し、関連付けられたLOVで対応する表示値を検索します。

• テキスト・フィールド([Enter]を押すと常にページを送信): セッション・ステートの読取り専用バージョンの値を表示します。送信されると、表示された値はセッション・ステートに保存されます。

• ポップアップ計算機付きテキスト・フィールド: 横にアイコンが付いたテキスト・フィールドとしてレンダリングします。このアイコンをクリックすると、計算機付きの小さいウィンドウが表示されます。計算結果は、テキスト・フィールドに表示されます。

テキスト領域

HTMLのテキスト領域としてレンダリングします。テキスト領域として表示されるアイテムの最大長はありません。「高さ」および「幅」アイテム属性を編集して、高さと幅を制御します。さらに使用可能なテキスト領域の表示形式のオプションには、次のものがあります。

• テキスト・エリア

• テキスト領域（高さ自動）: テキストの量に応じて高さが変わります。テキスト領域をデータ量に応じて決める場合は、このオプションを使用します。

• 文字カウント機能付きテキスト領域: フィールドに入力されたバイト数を示すカウンタを含みます。

• スペル・チェック機能付きテキスト領域: ポップアップの英語スペル・チェッカを提供します。

• HTMLエディタ最小: ボールド、イタリック、下線、箇条書き、インデントなど、基本的なテキスト編集機能を提供します。

• HTMLエディタ標準:フォント、フォーマット、色など、「HTMLエディタ最小」より多くのテキスト編集機能を提供します。

• HTMLエディタ付きテキスト領域:基本的なテキスト書式制御を提供します。一部のブラウザでは、これらの制御が動作しない場合があることに注意してください。

表の停止および開始

</table>タグでHTML表がクローズされ、HTML表が開始されます。このアイテム・タイプを使用してリージョンの中央部分で列の幅を再設定できます。

「表の停止および開始」アイテムでは、ラベルのみが表示されることに注意してください。このラベルを非表示にするには、NULLに設定します。これを行うには、デフォルトのラベルを削除します。