チェックボックス |
単一のチェック・ボックスを表示し、ユーザーがこれを選択または選択解除できるようにします。このチェック・ボックス・アイテムは常に、チェック済値または未チェック値という2つの値のいずれかを持ちます。
ページ・デザイナのアイテム属性:
|
チェック・ボックス・グループ |
複数の値をチェック・ボックスとして表示し、エンド・ユーザーが複数の値を選択できるようにします。チェック・ボックスとして表示されるアイテムには、LOVが必要です。選択されたボックスに対応する値は、1つのコロンで区切られた文字列に格納されます。
ノート: はい/いいえのチェック・ボックス(つまり、値が1つのみになるチェック・ボックス)には、チェック・ボックス・タイプまたは切替えアイテム・タイプを使用することをお薦めします。
次の例では、従業員名(ename )が表示されますが、従業員番号(empno )が戻されます。
SELECT ename, empno FROM emp;
関連項目: 戻り値の分割の詳細は、Oracle APEX APIリファレンスのAPEX_UTILを参照
ページ・デザイナのアイテム属性:
- 設定、数値列 - チェック・ボックスの表示に使用されるレイアウト列の数を入力します。たとえば、2という値を指定すると、2列のチェック・ボックスが表示されます。デフォルトでは、1つの列にすべての値を表示します。
- 検証、必須の値 - 「オン」に設定し、ページ・アイテムが表示されている場合、Oracle APEXでは、ページの送信時にNOT NULL検証が自動的に実行されます。詳細は、ヘルプを参照してください。
関連項目: カスケードLOVの作成
|
カラー・ピッカー |
「表示形式」の設定に応じて、色を選択または入力するためのコントロールが表示されます。エンド・ユーザーは、カラー値を入力するか、インラインまたはポップアップのカラー・スペクトルからカラー値を選択できます。
ページ・デザイナのアイテム属性:
-
設定、デフォルトの使用 - 「オン」に設定すると、「カラー・ピッカー」では「共有コンポーネント」、「コンポーネント設定」、「カラー・ピッカー」で定義されたアプリケーション・レベルのコンポーネント設定が使用されます。
関連項目: カラー・ピッカーの表示の構成
「デフォルトの使用」が「オフ」に設定されている場合は、次の設定が表示されます。
-
表示形式-カラー・ピッカーの表示方法を選択します。オプションは次のとおりです。
-
ポップアップ - カラー・スペクトルのピッカーを開くアイコンが付いたテキスト・フィールドとして表示します。
-
インライン - インラインのカラー・スペクトルとして表示します。
-
カラーのみのポップアップ - カラー・スペクトルのポップアップを開くボタンとして表示されます。
-
ネイティブ・カラー・ピッカー - ネイティブ・ブラウザのカラー入力(UIはブラウザに依存)として表示します。
-
モード - カラー・ピッカーに表示される情報の量を選択します。オプションには、「シンプル」または「完全」があります。
-
カラー・プリセット - カラー・ピッカーに事前定義された色のセットを表示するかどうか、およびテーマとカスタムのどちらの色を表示するかを指定します。オプションには、「なし」、「テーマ・スタイル・カラー」、「カスタム・カラー」があります。
-
コントラスト対象 - このアイテムの色を別のアイテムの色または静的な値と比較し、それらのコントラスト比をカラー・ピッカーUIに表示します。このオプションを有効にすると、すべてのユーザーがアクセスできる十分なコントラストの色を選択できます。オプションには、「なし」、「ページ・アイテム」、「静的カラー」があります。
-
戻り値の形式 - このアイテムによって返される色の値の形式を指定します。カラーが別の有効な形式で入力された場合でも、この形式で表示され、返され、サーバーに送信されます。オプションには、「16進」、「RGB」、「RGB/RGBA」、「HSL」、「HSL/HSLA」、「任意のCSS値」があります。詳細は、ヘルプを参照してください。
-
検証、必須の値 - 「オン」に設定し、ページ・アイテムが表示されている場合、Oracle APEXでは、ページの送信時にNOT NULL検証が自動的に実行されます。詳細は、ヘルプを参照してください。
|
日付ピッカー |
カレンダ・アイコン付きのテキスト・フィールドを表示します。エンド・ユーザーは、テキスト・アイテムに直接日付を入力するか、カレンダ・アイコンをクリックしてカレンダ・ポップアップから日付(およびオプションで時間)を選択します。
このアイテムの書式マスクに時間コンポーネントが含まれている場合にのみ、カレンダ・ポップアップに時間が表示されます。
ページ・デザイナのアイテム属性:
-
設定、時間の表示 - 時間情報を含めるにはこのオプションを有効にします。
-
設定、表示形式 - 日付ピッカーの表示モードを選択します。オプションは次のとおりです。
-
ポップアップ - アイテムがフォーカスを受け取った場合、またはカレンダ・アイコンがクリックされた場合にポップアップに表示されます。
-
インライン - カレンダは常にページにインラインで表示されます。テキスト・フィールドは表示されず、現在の日付の選択がカレンダで強調表示されます。
-
ネイティブHTML - ブラウザでサポートされている場合は、ネイティブHTML入力日付型を使用してレンダリングします。「時間の表示」がオフの場合、'date'型が表示され、「時間の表示」がオンの場合、'datetime-local'型がレンダリングされます。ノート: これらの日付型の正確な表示は、ブラウザによって異なります。モバイル・デバイス上でアプリケーションが使用されている場合は、ネイティブHTMLが優先オプションとなる場合があります。
「ネイティブHTML」の使用については注意してください。ネイティブ日付型は必要な日付書式に非常に固有であるため、アイテムの書式マスクはAPEXによって自動的に設定され、変更できなくなります。ただし、これはエンド・ユーザーに表示される書式ではありません。エンド・ユーザーには、現在のロケールに適した書式で日付が表示されます。
-
設定、最小日付 - このアイテムに最小日付があるかどうかを指定します。オプションは次のとおりです。
追加属性は、選択された値に基づいて条件付きで表示されます。
-
設定、最大日付 - 入力または選択可能な最大日付を入力します。追加属性は、選択された値に基づいて条件付きで表示されます。
-
設定、複数月 - カレンダに複数の月を表示するかどうか、およびいくつ表示するかを決定します。「いいえ」を選択してこのオプションを無効にするか、月数を選択します。
-
設定、デフォルトの使用 - 「オン」に設定すると、「日付ピッカー」では「共有コンポーネント」、「コンポーネント設定」、「日付ピッカー」で定義されたアプリケーション・レベルのコンポーネント設定が使用されます。「日付ピッカーの構成」を参照してください
「デフォルトの使用」が「オフ」に設定されている場合は、次の属性が表示されます。
-
外観と動作 - 日付の選択に使用されるカレンダの外観を制御します。この属性は、「表示形式」が「ポップアップ」または「インライン」である場合にのみ適用されます。オプションは次のとおりです。
- 週の表示 - 年間通算週を表示するかどうかを決定します。
- 月ピッカー - 月を、ユーザーが別の選択を行うことができるボタンとしてレンダリングするか、単にテキストとしてレンダリングするかを制御します。
- 年ピッカー - 年を、ユーザーが別の選択を行うことができるボタンとしてレンダリングするか、単にテキストとしてレンダリングするかを制御します。
- 複数の月でページ区切り - 複数の月を表示するときのページ区切りサイズを1か月のみにするかどうか、または月数を決定します。
- 「今日」ボタンの表示 - 現在の日付を選択するために「今日」ボタンを表示するかどうかを決定します。
- 「クリア」ボタンの表示 - 日付ピッカーの値をクリアするために「クリア」ボタンを表示するかどうかを制御します。この属性は、「表示形式」が「インライン」に設定されている場合にのみ適用されます。
-
月の範囲外の日 - 現在表示中の月の範囲外の日の動作を指示します。この属性は、 「表示形式」が 「ポップアップ」または 「インライン」に設定されている場合にのみ適用されます。オプションは次のとおりです。
- 非表示 - 現在表示中の月の範囲外の日は非表示になります。
- 選択可能 - 現在表示中の月の範囲外の日は表示され、選択できます。
- 表示可能 - 現在表示中の月の範囲外の日は表示されます。
-
時間の増分 - 時間選択コントロールで使用される時間の増分(分単位)。この属性は、手動で入力して保存することもできる増分の時間を選択するために使用します。
この属性は、「表示形式」が「ポップアップ」または「インライン」のどちらかに設定され、「時間の表示」が有効になっている場合にのみ使用します。
-
表示条件 - どのような場合にカレンダ・ポップアップを表示するかを制御します。このオプションは、「表示形式」が「ポップアップ」または「インライン」のどちらかに設定されている場合にのみ使用します。オプションは次のとおりです。
- アイテム・フォーカス - アイテムがフォーカスを受け取った場合、またはカレンダ・アイコンがクリックされた場合。
- アイコン・クリック - カレンダ・アイコンをクリックした場合のみ。
-
外観、書式マスク - このコンポーネントに適用する日付書式マスクを入力します。
-
検証、必須の値 - 「オン」に設定し、ページ・アイテムが表示されている場合、Oracle APEXでは、ページの送信時にNOT NULL検証が自動的に実行されます。詳細は、ヘルプを参照してください。
|
日付ピッカー(jQuery) (サポート終了) |
ノート: 日付ピッカー(jQuery)アイテム・タイプはサポートが終了したため、使用しないでください。使用可能なカスタマイズを保持するために、既存のアプリケーションは新しい日付ピッカーを使用するように自動的に切り替わりません。アプリケーション・ビルダーでアプリケーションの「ユーティリティ」セクションにある「アプリケーションのアップグレード」を使用して、新しい日付ピッカーを使用するようにアプリケーションのすべての日付ピッカーを切り替えることができます。「アプリケーションのアップグレードの実行」を参照してください。
カレンダ・アイコン付きのテキスト・フィールドを表示します。エンド・ユーザーは、テキスト・アイテムに直接日付を入力するか、カレンダ・アイコンをクリックしてカレンダ・ポップアップから日付(およびオプションで時間)を選択します。
このアイテムの書式マスクに時間コンポーネントが含まれている場合にのみ、カレンダ・ポップアップに時間が表示されます。
ページ・デザイナのアイテム属性:
-
設定、時間の表示 - 時間情報を含めるにはこのオプションを有効にします。
-
設定、表示形式 - 日付ピッカーの表示モードを選択します。オプションは次のとおりです。
-
ポップアップ・カレンダ - アイテムがフォーカスを受け取った場合、またはカレンダ・アイコンがクリックされた場合にポップアップに表示されます。
-
インライン - カレンダは常にページにインラインで表示されます。テキスト・フィールドは表示されず、現在の日付の選択がカレンダで強調表示されます。
-
ネイティブHTML - ブラウザでサポートされている場合は、ネイティブHTML入力日付型を使用してレンダリングします。「時間の表示」がオフの場合、'date'型が表示され、「時間の表示」がオンの場合、'datetime-local'型がレンダリングされます。ノート: これらの日付型の正確な表示は、ブラウザによって異なります。モバイル・デバイス上でアプリケーションが使用されている場合は、ネイティブHTMLが優先オプションとなる場合があります。
「ネイティブHTML」を使用する場合に注意してください。ネイティブ日付型は必要な日付書式に非常に固有であるため、アイテムの書式マスクはAPEXによって自動的に設定され、変更できなくなります。ただし、これはエンド・ユーザーに表示される書式ではありません。エンド・ユーザーには、現在のロケールに適した書式で日付が表示されます。
-
設定、最小日付 - このアイテムに最小日付があるかどうかを指定します。オプションは次のとおりです。
追加属性は、選択された値に基づいて条件付きで表示されます。
-
設定、最大日付 - 入力または選択可能な最大日付を入力します。追加属性は、選択された値に基づいて条件付きで表示されます。
-
設定、複数月 - カレンダに複数の月を表示するかどうかを決定します。「オン」に設定すると、「月数」属性が表示されます。一度に表示する月の数を入力します。
-
設定、デフォルトの使用 - 「オン」に設定すると、「日付ピッカー」では「共有コンポーネント」、「コンポーネント設定」、「日付ピッカー」で定義されたアプリケーション・レベルのコンポーネント設定が使用されます。
関連項目: 日付ピッカーの構成
「デフォルトの使用」が「オフ」に設定されている場合は、次の属性が表示されます。
-
外観 - 日付の選択に使用されるカレンダの外観の制御オプションは次のとおりです。
この属性は、「表示形式」が「ポップアップ」または「インライン」のどちらかに設定されている場合にのみ使用します。
-
月の範囲外の日 - 現在表示中の月の範囲外の日の動作を指示します。オプションは次のとおりです。
- 非表示 - 現在表示中の月の範囲外の日は非表示になります。
- 選択可能 - 現在表示中の月の範囲外の日は表示され、選択できます。
- 表示可能 - 現在表示中の月の範囲外の日は表示されます。
この属性は、「表示形式」が「ポップアップ」または「インライン」のどちらかに設定されている場合にのみ使用します。
-
時間の増分 - 時間選択コントロールで使用される時間の増分(分単位)。この属性は、手動で入力して保存することもできる増分の時間を選択するために使用します。
この属性は、「表示形式」が「ポップアップ」または「インライン」のどちらかに設定され、「時間の表示」が有効になっている場合にのみ使用します。
-
表示条件 - カレンダ・ポップアップが表示されるタイミングを制御します。オプションは次のとおりです。
- アイテム・フォーカス - アイテムがフォーカスを受け取った場合、またはカレンダ・アイコンがクリックされた場合。
- アイコン・クリック - カレンダ・アイコンをクリックした場合のみ。
このオプションは、「表示形式」が「ポップアップ」または「インライン」のどちらかに設定されている場合にのみ使用します。
-
外観、書式マスク - このコンポーネントに適用する日付書式マスクを入力します。
-
検証、必須の値 - 「オン」に設定し、ページ・アイテムが表示されている場合、Oracle APEXでは、ページの送信時にNOT NULL検証が自動的に実行されます。詳細は、ヘルプを参照してください。
|
イメージの表示 |
データベースBLOB 列に格納されているイメージまたはイメージURLに基づくイメージを表示します。
ノート: 対話グリッド列ではサポートされません。
ページ・デザイナのアイテム属性:
-
設定、基準 - アイテムの取得元を決定します。属性についてさらに学習するには、フィールドレベル・ヘルプを参照してください。
-
設定、代替テキスト列 - このイメージの代替テキストを保持する大文字のページまたはアプリケーション・アイテム名を入力します。このテキストは、エンド・ユーザーがこのアイテムにナビゲートすると、スクリーン・リーダーによって読み上げられます。
-
設定、ファイル名列 - BLOB 列に関連付けられているファイル名列値を保持する大文字のページまたはアプリケーション・アイテム名を入力します。
-
設定、MIMEタイプ列 - アップロードされたファイルのMIMEタイプの格納に使用する大文字のページまたはアプリケーション・アイテム名を入力します。MIMEタイプは、ファイルをダウンロードするときにBLOBのコンテンツの表示に使用するアプリケーションを識別するために、ブラウザによって使用されます。
-
設定、BLOB最終更新列 - 関連付けられているBLOB が最後に更新されたときの日付列値を保持する大文字のページまたはアプリケーション・アイテム名を入力します。この値は、ブラウザ・キャッシュに使用され、ブラウザからの最後のリクエスト以降にイメージが変更されているかどうかを識別するために使用されます。イメージが更新されていない場合は、ブラウザ・キャッシュからイメージが取得されます(使用可能な場合)。
|
マップの表示 |
GeoJSONポイント形式の座標に基づいてマップを表示します。
ページ・デザイナのアイテム属性:
- 設定、背景 - 使用する背景マップを選択します。詳細は、ヘルプを参照してください。
- 設定、ズーム・レベル - このレイヤーが表示されるズーム・レベルを指定します。最小値は1です。最大値は18です。
- 設定、マーカーの表示 - マーカーを表示するかどうかを指定します。
- 設定、マーカーの色 - マーカー塗りつぶしの色を指定します。詳細は、ヘルプを参照してください。
- 設定、ツールチップ - 表示されるマーカーのツールチップ・テキストを指定します。ツールチップ属性は、HTMLおよびAPEXテンプレート・ディレクティブをサポートします。
- 設定、マップ・コントロールの表示 - マップ・コントロールを表示するかどうかを指定します。これにより、ズームと回転のコントロールがマップに追加されます。
- 設定、対話型マップ - マップを対話型にするかどうかを指定します。無効にすると、対話性のない静的マップが作成されます。
- 設定、高さ - 表示されるマップの高さ(ピクセル)を指定します。マップのデフォルトの高さは、その幅に基づいて3:2のアスペクト比で計算されます。
|
表示のみ |
入力不可テキスト・アイテムを表示します。
ページ・デザイナのアイテム属性:
- 設定、書式 - オプションには、「プレーン・テキスト」、「HTML」または「マークダウン」があります。
- 設定、基準 - フィールドに表示される内容を指定します。オプションは次のとおりです。
- ページ・アイテム値 - ページ・アイテムの現在の値が表示されます。
- LOVの値の表示 - ページ・アイテムの現在の値がLOVを使用して別の表示値にマップされます。
- 設定、改行の表示 - 「オン」を選択すると、表示値の改行がHTML改行に変換されて、HTML出力で表示されます。
- 設定、ページの送信時に送信 - ページの送信時に現在のアイテム値を送信するかどうかを指定します。
- セッション・ステート、データ型 - ページ・アイテムのデータ型(
VARCHAR2 またはCLOB )を選択します。
- セッション・ステート、ストレージ - セッション・ステートの保持方法を選択します。オプションは次のとおりです。
- リクエストごと(メモリーのみ) - ステートをデータベースに保存しません。ステートを使用できるのは、現在のリクエストを処理しているときのみです。AJAXリクエストでアイテムを使用する必要がある場合は、「送信するページ・アイテム」を使用してアイテム名を必ず渡してください。
- セッションごと(永続) - リクエストをまたがって値にアクセスできるように、各セッションの値がデータベースに保存されます。
|
ファイル参照 |
「参照」ボタンが付いたテキスト・フィールドを表示します。ユーザーは「参照」ボタンを使用して、ローカル・ファイル・システムのファイルを検索し、アップロードすることができます。
ノート: 対話グリッド列ではサポートされません。
関連項目: ファイルのアップロードの保護について
ページ・デザイナの属性:
- 設定、表示形式 - ファイル参照アイテムの表示方法を示す表示スタイルを選択します。詳細は、ヘルプを参照してください。
- 設定、ドロップ・ゾーンのタイトル - ドロップ・ゾーンのタイトルを指定します。このフィールドが空白のままの場合は、デフォルトで、テキスト・メッセージ
APEX.ITEM.FILE.DROP_FILE またはAPEX.ITEM.FILE.DROP_FILES が使用されます。
-
設定、記憶域タイプ - アップロードしたファイルの格納場所を指定します。オプションは次のとおりです。
-
アイテム・ソース属性で指定されたBLOB列 - 行の自動処理(DML)プロセスによって使用される表およびアイテム・ソース属性で指定された列にアップロードされるファイルを格納します。列はBLOB データ型である必要があります。ファイルがダウンロードされる場合、行の自動フェッチ・プロセスの表名が使用されます。
-
表APEX_APPLICATION_TEMP_FILES - ビューAPEX_APPLICATION_TEMP_FILES でアクセスできる一時的な場所にアップロードしたファイルを格納します。「ファイルをパージするタイミング」の選択に応じて、Oracle APEXにより、セッションの最後またはアップロード・リクエストの最後にファイルが自動的に削除されます。
「記憶域タイプ」が「表APEX_APPLICATION_TEMP_FILES」の場合:
-
ファイルをパージするタイミング - Oracle APEXが一時ファイルを削除するタイミングを定義します。
-
複数ファイルの許可 - 複数のファイルを一度にアップロードするかどうかを指定します。複数のファイル名は、コロンで区切られたリストとしてページ・アイテムに格納されます。
-
ファイル・タイプ - ブラウザがアップロードするファイルを制限するために使用できるカンマで区切られたファイル・タイプのリストを指定します。
「記憶域タイプ」が「アイテム・ソースで指定されたBLOB列」の場合:
-
MIMEタイプ列 - アップロードされたファイルのMIMEタイプの格納に使用する、ページまたはアプリケーション・アイテム名を大文字で入力します。MIMEタイプは、ファイルをダウンロードするときにBLOBのコンテンツの表示に使用するアプリケーションを識別するために、ブラウザによって使用されます。
-
ファイル名列 - アップロードされたファイルのファイル名の格納に使用する、ページまたはアプリケーション・アイテムを入力します。
-
文字セット列 - アップロードされたファイルの文字セットの格納に使用する、ページまたはアプリケーション・アイテム名を大文字で入力します。BLOB の文字セットはアップロード時に自動的に設定されません。エンド・ユーザーは、アップロードするドキュメントの文字セットを設定する必要があります。
-
BLOB最終更新列 - ファイルのアップロード時の現在のタイムスタンプの格納に使用する、ページまたはアプリケーション・アイテム名を大文字で入力します。この日付値は、ブラウザ・キャッシュに使用されます。
-
ダウンロード・リンクの表示 - このアイテムに空でないBLOBが関連付けられている場合にダウンロード・リンクを表示するかどうかを指定します。
-
リンク・テキストのダウンロード - ダウンロード・リンクの一部として表示されるテキストを入力します。指定されない場合、共有コンポーネント内のAPEX.FILE_BROWSE.DOWNLOAD_LINK_TEXT のテキスト・メッセージに格納されているテキストが表示されます。
-
コンテンツ配置 - ダウンロード時のブラウザによるコンテンツの処理方法を選択します。
-
設定、ファイル・タイプ - ブラウザがアップロードするファイルを制限するために使用できるカンマで区切られたファイル・タイプのリストを指定します。例については、ヘルプを参照してください。
|
ジオコーディングされた住所 |
郵便番号を座標に変えるジオコーディング機能を提供します。
ジオコーディングは、Oracle Elocationジオコーディング・サービス(https://elocation.oracle.com/elocation/home.html)へのRESTリクエストを使用してブラウザによって実行されます。ジオコーディングが機能するには、ユーザーのブラウザがインターネットに接続されている必要があります。
ジオコーディング入力データは、住所の一部(通り、番地、郵便番号、市区町村など)にマップされている他のページ・アイテムから取得されます。ジオコーダは、一致候補のリストを含むポップアップ・ウィンドウを表示します。一致を選択すると、アイテムのセッション・ステート値はGeoJSON形式の住所の座標になります。
「構造化住所」属性によって、ジオコーディング・サービスに提供される住所部分が構造化方式なのか、非構造化方式なのかが決まります。構造化とは、明示的なページ・アイテムが通り、郵便番号、市区町村、地域などの住所部分にマップされることを意味します。構造化された住所は、より正確なジオコーディング結果であり、また住所の修正をページ・アイテムに返送することもできます。非構造化とは、住所全体に対して1つの項目のみが使用され、住所部分がカンマで区切られることを意味します。非構造化モードでは、住所の修正はサポートされません。
ジオコーディングされた住所アイテムを使用するには、少なくとも1つの他の入力アイテムが必要で、正確な住所に最大8つの入力アイテムが必要です。
「構造化住所」が「オフ」の場合、アイテムは1つのテキスト・フィールドまたはテキスト領域にのみマップされ、エンド・ユーザーはカンマで区切って住所部分を入力します。ページ・デザイナのプロパティ・エディタの「設定」の下に、次のアイテム属性が表示されます。
-
国タイプ - ジオコーディングに静的な国を使用するか、アイテムから国を導出するかを選択します。オプションには、「静的」または「アイテム」があります。
-
国 - ジオコーディングに使用する国を選択します。
-
構造化住所 - 「オフ」を選択します。ジオコーディング・サービスに提供される住所部分が構造化方式なのか、非構造化方式なのかを判定します。
-
住所アイテム - 非構造化住所部分を含むアイテムをカンマで区切って選択します。
-
一致ベクトル・アイテム - ジオコーダのページ・アイテムを選択して、一致ベクトルを返します。一致ベクトルは17桁の文字列で、各住所属性がジオコーディングに使用されるデータとどのように一致しているかに関する詳細情報が示されます。詳細は、アイテム・ヘルプを参照してください。
-
ジオコーディングのトリガー - ジオコーディングをいつトリガーするかを決定します。これには、ブラウザがジオコーディング・サービスへのRESTリクエストを実行し、一致候補を含むポップアップ・ウィンドウを表示することが含まれています。オプションには、「自動」、「動的アクション」および「jQueryセレクタ」があります。詳細は、アイテム・ヘルプを参照してください。
「構造化住所」が「オン」の場合、ページ・デザイナのプロパティ・エディタの 「設定」の下に、次のアイテム属性が表示されます。
-
国タイプ - ジオコーディングに静的な国を使用するか、アイテムから国を導出するかを選択します。オプションには、「静的」または「アイテム」があります。
-
国 - ジオコーディングに使用する国を選択します。
-
構造化住所 - 「オン」を選択します。ジオコーディング・サービスに提供される住所部分が構造化方式なのか、非構造化方式なのかを判定します。
-
住所のサニタイズ - このスイッチを有効にすると、ジオコーディング・サービスからマップ済アイテムに住所データがフィードバックされます。
-
通りアイテム - 住所の通り部分を含むアイテムを選択します。
-
番地アイテム - 住所の番地部分を含むアイテムを選択します。
-
郵便番号アイテム - 住所の郵便番号部分を含むアイテムを選択します。
-
市アイテム - 住所の市部分を含むアイテムを選択します。
-
市のサブエリア・アイテム - 住所の市のサブエリア部分を含むアイテムを選択します。
-
一致ベクトル・アイテム - ジオコーダのページ・アイテムを選択して、一致ベクトルを返します。一致ベクトルは17桁の文字列で、各住所属性がジオコーディングに使用されるデータとどのように一致しているかに関する詳細情報が示されます。詳細は、アイテム・ヘルプを参照してください。
-
ジオコーディングのトリガー - ジオコーディングをいつトリガーするかを決定します。これには、ブラウザがジオコーディング・サービスへのRESTリクエストを実行し、一致候補を含むポップアップ・ウィンドウを表示することが含まれています。オプションには、「自動」、「動的アクション」および「jQueryセレクタ」があります。詳細は、アイテム・ヘルプを参照してください。
ノート: 「ジオコーディングされた住所」アイテムと「マップの表示」アイテムは、両方ともOracle Elocation Map Cloudサービス(https://maps.oracle.com/elocation/ajax/index.jsp)と連携しています。このサービスは、サーバー上のAPEXデータベースではなく、ブラウザによってアクセスされます。これにより、ユーザーのデータ保護が影響を受ける可能性があります。ジオコーディング・アイテムおよび「マップの表示」アイテムは、GeoJSON形式(https://de.wikipedia.org/wiki/GeoJSON)で座標を格納します。ジオメトリ部分のみが使用されることに注意してください。現在サポートされているのは「ポイント」ジオメトリのみです。たとえば:
{
"type": "Point",
"coordinates": [
13.74081,
51.05363
]
}
|
非表示 |
ページ・ソース内に含まれているが、レンダリングされないアイテム。非表示のアイテム値は、セッション・ステートに保存されます。通常、ページ処理または他のページ・アイテムで必要とされる値の格納に使用されますが、エンド・ユーザーに表示されません。
ページ・デザイナの属性:
- 設定、保護された値 - 「オン」を選択すると、ページがポストされたときに非表示の値が操作できないようになります。
- セッション・ステート、データ型 - ページ・アイテムのデータ型(
VARCHAR2 またはCLOB )を選択します。
- セッション・ステート、ストレージ - セッション・ステートの保持方法を選択します。オプションは次のとおりです。
- リクエストごと(メモリーのみ) - ステートをデータベースに保存しません。ステートを使用できるのは、現在のリクエストを処理しているときのみです。AJAXリクエストでアイテムを使用する必要がある場合は、「送信するページ・アイテム」を使用してアイテム名を必ず渡してください。
- セッションごと(永続) - リクエストをまたがって値にアクセスできるように、各セッションの値がデータベースに保存されます。
|
マークダウン・エディタ
|
マークダウンの短縮構文を使用してテキストに書式を追加できる単純なテキスト・エディタが表示されます。
ノート:マークダウン・エディタは、対話グリッド列ではサポートされていません。
関連項目: マークダウン・ガイド
ページ・デザイナのアイテム属性:
|
リスト・マネージャ |
ポップアップLOVアイコン、「追加」および「削除」ボタン、選択された値のリストを含むテキスト・アイテムを表示します。
ノート: 対話グリッド列ではサポートされません。
値を入力するか、使用可能なアイテムのリストから選択します。これにより、ボタンを使用して、選択された値を管理できます。選択された値は、1つのコロンで区切られた文字列に格納されます。
ページ・デザイナの属性:
関連項目: カスケードLOVの作成
|
数値フィールド |
数値フィールドとして表示され、自動書式設定をサポートします。数値は、書式マスクに従ってデータ入力後にクライアントで書式設定されます。このアイテム・タイプでは、入力された値が数値かどうかが自動的にチェックされます。追加検証は必要ありません。検証は、クライアントとサーバーの両方で実行されます。
ページ・デザイナの属性:
-
外観、書式マスク - 表示用の数値を書式設定する方法を指定します。データ入力に使用する小数点セパレータは、ロケールによって決まります。
-
設定、最小値 - 最小許容値を入力します。値は、静的値または置換構文を使用した動的値です。
-
設定、最大値 - 最大許容値を入力します。値は、静的値または置換構文を使用した動的値です。
-
設定、数字の位置合せ - 表示する数値の位置合せ方法を選択します。アイテムが「読取り専用」としてレンダリングされる場合、または「HTMLフォームの要素属性」が指定されている場合、この設定は適用されません。
-
設定、仮想キーボード - タッチスクリーンで数値フィールドを使用する場合に表示する仮想キーボードを選択します。オプションは次のとおりです。
- 小数 - 小数点キーが追加された数字のみのキーボード。
- 数値 - 数字のみのキーボード。このオプションは、金額、PIN、郵便番号、クレジット・カード番号などに有用です。
- テキスト - 通常の英数字キーボード。
-
検証、必須の値 - 「オン」に設定し、ページ・アイテムが表示されている場合、Oracle APEXでは、ページの送信時にNOT NULL検証が自動的に実行されます。
「共有コンポーネント」、「テキスト・メッセージ」でAPEX.PAGE_ITEM_IS_REQUIRED というメッセージを定義すると、事前定義されたエラー・テキストをアプリケーション固有のエラー・メッセージに置換できます。アプリケーション・レベル設定の「デフォルトのエラー表示位置」を更新することで、メッセージの表示位置を指定します。
|
パスワード |
HTMLパスワード・フォーム要素を表示します。エンド・ユーザーがテキストを入力すると、入力した実際の文字のかわりに黒いドットが表示されます。
ページ・デザイナの属性:
-
設定、[Enter]を押すと送信 - このフィールドで[Enter]キーを押すと、ページが自動的に送信されるかどうかを指定します。
-
設定、状態を保存しない - パスワードがセッション・ステートに保存されるかどうかを指定します。
セキュリティ上の理由から、パスワードをセッション・ステートに書き込まないよう強くお薦めします。ブラウザ・キャッシュおよびAPEXセッション表から値が読み取られる可能性があります。この属性を「いいえ」に設定する場合、「セッション・ステートに暗号化された値を保存」を「はい」に設定することを検討してください。
-
検証、必須の値 - 「オン」に設定し、ページ・アイテムが表示されている場合、Oracle APEXでは、ページの送信時にNOT NULL検証が自動的に実行されます。詳細は、ヘルプを参照してください。
関連項目: セッション・ステートおよびセキュリティについて
|
パーセント・グラフ |
パーセンテージ・グラフとして値を表示します。取得される値は、0から100までの間である必要があります。
|
ポップアップLOV |
ポップアップLOVアイコン付きのテキスト・アイテムを表示します。エンド・ユーザーがアイコンをクリックすると、検索フィールドおよびサポートされる値のリストを含むポップアップ・ウィンドウが表示されます。
エンド・ユーザーが検索基準を入力して、表示される使用可能な値を絞り込むことができるため、大きなリストにはポップアップLOVが最適です。比較的小さなリストには、多くの場合、選択リストの方が適しています。
SELECT ename name, empno id
FROM emp
いずれかの列が式の場合は、別名を使用します。たとえば:
SELECT ename||' '||job display_value, empno FROM emp
ページ・デザイナのアイテム属性:
-
設定、表示形式 - インラインのポップアップまたはモーダル・ダイアログのどちらで結果を表示するかを選択します。
-
設定、初期フェッチ - LOV用のデータの初期フェッチ方法を選択します。これは、ページがロードされた後、またはアイテムがリフレッシュされた(カスケードのためなど)後に、初めてポップアップを開いた場合にのみ適用されます。「最小文字数」属性も参照してください。
-
設定、複数の値 - 複数の値を選択または入力できるかどうかを指定します。
-
設定、手動入力 - 手動入力を許可するかどうかを選択します。
-
検証、必須の値- 「オン」に設定し、ページ・アイテムが表示されている場合、Oracle APEXでは、ページの送信時にNOT NULL検証が自動的に実行されます。詳細は、ヘルプを参照してください。
関連項目: カスケードLOVの作成
|
ラジオ・グループ |
複数の値をラジオ・ボタン・オプションとして表示し、エンド・ユーザーが1つの値を選択できるようにします。
次の例では、従業員名(ename )が表示されますが、従業員番号(empno )が戻されます。
SELECT ename, empno FROM emp;
ページ・デザイナのアイテム属性:
-
設定、列の数 - 表示するラジオ・グループ列の数を入力します。たとえば、2 という値では2列が表示されます。値が5個ある場合、3行に表示されます。
-
設定、選択時のページ・アクション - ラジオ・グループ値が選択されたときに実行されるアクションを選択します。詳細は、ヘルプを参照してください。
-
設定、検証の実行 - この属性は「値の変更時のページ・アクション」が「ページの送信」に設定されている場合にのみ表示されます。ページの送信時の検証の実行を制御します。この属性を「オフ」に設定すると、検証が実行されず、関連エラー・メッセージが表示されません。この属性を「オン」に設定すると、ページの送信時にすべてのページ検証、ビルトイン検証が実行され、関連エラー・メッセージが表示されます。
関連項目: 検証の実行タイミングの決定についておよびカスケードLOVの作成
-
検証、必須の値 - 「オン」に設定し、ページ・アイテムが表示されている場合、Oracle APEXでは、ページの送信時にNOT NULL検証が自動的に実行されます。詳細は、ヘルプを参照してください。
|
リッチ・テキスト・エディタ |
様々なテキスト書式設定オプションを持つテキスト領域を表示します。エンド・ユーザーは、Microsoft Wordなどのワード・プロセッサを使用した場合と同様の形式で表示されるコンテンツを拡張できます。エンド・ユーザーは、Rich Text Format (RTF)ファイル形式のドキュメントをこのアイテムにカット・アンド・ペーストすることもできます。
ページ・デザイナのアイテム属性:
- 設定、書式 - リッチ・テキスト・エディタで入力されるコンテンツの出力形式を指定します。オプションは次のとおりです。
- HTML - このリッチ・テキスト・エディタのソースおよび出力用にHTMLを使用します。HTMLは、マークダウンよりも柔軟でより多くの書式設定オプションを提供しますが、安全性が低いため、表示する場合は信頼されているか、サニタイズされる必要があります。
- マークダウン - このリッチ・テキスト・エディタのソースおよび出力用にマークダウン形式を使用します。マークダウンはHTMLよりも機能が制限されていますが、表示する前にまずパーサーを通過する必要があるため、より安全です。
- 「設定」、「書式」が「HTML」に設定されている場合、次の追加属性が表示されます。
- 設定、最小高 - 編集可能領域の高さの最小値をピクセル単位で設定します。
- 設定、最大高 - 編集可能領域の高さの最大値をピクセル単位で設定します。この属性を空のままにすると、入力にあわせてエディタが無限に拡張されます。
- 検証、必須の値 - 「オン」に設定し、ページ・アイテムが表示されている場合、Oracle APEXでは、ページの送信時にNOT NULL検証が自動的に実行されます。詳細は、ヘルプを参照してください。
- セッション・ステート、データ型 - ページ・アイテムのデータ型(
VARCHAR2 またはCLOB )を選択します。
- セッション・ステート、ストレージ - セッション・ステートの保持方法を選択します。オプションは次のとおりです。
- リクエストごと(メモリーのみ) - ステートをデータベースに保存しません。ステートを使用できるのは、現在のリクエストを処理しているときのみです。AJAXリクエストでアイテムを使用する必要がある場合は、「送信するページ・アイテム」を使用してアイテム名を必ず渡してください。
- セッションごと(永続) - リクエストをまたがって値にアクセスできるように、各セッションの値がデータベースに保存されます。
|
選択リスト |
値セレクタの組込みリスト付きのアイテムを表示します。エンド・ユーザーがアイテムをクリックすると、サポートされる値のリストが現在のアイテムに直接埋め込まれて表示されます。
選択リストは、比較的小さな不連続のリストに最適です。エンド・ユーザーは、ポップアップ・ダイアログにフォーカスを変更する必要なく、非常に迅速にリストから値を選択できます。大きなリストには、ポップアップLOVの使用を検討してください。
select [displayValue],
[returnValue]
from ...
where ...
order by ...
ページ・デザイナのアイテム属性:
-
設定、選択時のページ・アクション - リスト値が選択されたときに実行されるアクションを選択します。オプションのヘルプを参照してください。
- 設定、複数選択を許可 - LOVから複数の値を選択できるようにするか、単一の値を選択できるようにするかを指定します。複数の値の場合、カンマ区切りのリストで返されます。
-
設定、検証の実行 - 「選択時のページ・アクション」が「ページの送信」に設定されているかどうかを表示します。ページの送信時の検証の実行を制御します。この属性を「オフ」に設定すると、検証が実行されず、関連エラー・メッセージが表示されません。この属性を「オン」に設定すると、ページの送信時にすべてのページ検証、ビルトイン検証が実行され、関連エラー・メッセージが表示されます。この属性は、検証属性「常に実行」と組み合せて使用します。
関連項目: 検証の実行タイミングの決定について
-
検証、必須の値 - 「オン」に設定し、ページ・アイテムが表示されている場合、Oracle APEXでは、ページの送信時にNOT NULL検証が自動的に実行されます。詳細は、ヘルプを参照してください。
|
シャトル |
リストを含む2つのボックスを含む複数の選択リストとして表示します。左のリストには、選択されていない値のソース・リストが表示され、右のリストには、現在選択されている値が表示されます。エンド・ユーザーは、リストで1つ以上の値を選択し、選択した値またはすべての値をシャトル・コントロールを使用して移動できます。
現在の値は、1つのコロンで区切られた文字列に格納されます。
ページ・デザイナのアイテム属性:
ノート: このアイテム・タイプを作成するにはLOVを定義する必要があります。アプリケーション・レベルでのLOVの作成、複数選択リスト・アイテムでの操作およびカスケードLOVの作成を参照してください。
|
星評価
|
エンド・ユーザーが数値を設定するためにクリックできる、星評価(最高は10)が表示されます。
ページ・デザイナのアイテム属性:
-
設定、星の数 - エンド・ユーザーが選択する星の合計数(1から10)を設定します(デフォルトは5)。
-
設定、デフォルトの使用 - 「オン」に設定すると、「星評価」では「共有コンポーネント」、「コンポーネント設定」、「星評価」で定義されたアプリケーション・レベルのコンポーネント設定が使用されます。
関連項目:星評価の構成
「デフォルトの使用」が「オフ」に設定されている場合は、次のカスタム設定が表示されます。
- アイコン - 使用するアイコン・クラス(
fa-thumb-up など)。ドロップダウン・リストをクリックしてアイコンを選択します。
- アクティブな色 - アクティブな星のデフォルトの色。
- 非アクティブな色 - 非アクティブな星のデフォルトの色。
- ツールチップ - エンド・ユーザーがアイテムの上にマウスを移動したときに表示されるツールチップのテンプレート。この評価値によって、
#VALUE# 置換文字列が置き換えられます(たとえば、映画の評価は#VALUE# です)。
- 「クリア」ボタンの表示 - 星の横に「クリア」ボタン(
x )を表示するかどうかを選択します。
- 値の表示 - 星の横に値を表示するかどうかを選択します。
- 読取り専用の表示 - アイテムが読取り専用の場合の表示方法を選択します。オプションには、星、値、星と値および1つの星と値があります。
|
スイッチ |
フリップ・トグル・スイッチとして表示します。
ページ・デザイナのアイテム属性:
-
設定、デフォルトの使用 - 「オン」に設定すると、「カラー・ピッカー」では「共有コンポーネント」、「コンポーネント設定」、「カラー・ピッカー」で定義されたアプリケーション・レベルのコンポーネント設定が使用されます。
ノート: 切替えアイテムは、フリップ・トグル・スイッチ(デフォルト)、「ピル・ボタン」または「選択リスト」として表示できます。「切替えのデフォルト値の構成」を参照してください。
「デフォルトの使用」が「オフ」に設定されている場合は、次のカスタム設定が表示されます。
-
オン値 - エンド・ユーザーが「オン」オプションを選択した場合にページ・アイテムに格納される値を入力します。値は255文字以内で指定できます。
-
オン・ラベル - 「オン」オプションとして表示されるテキストを入力します。
-
オフ値 ユーザーが「オフ」オプションを選択した場合にページ・アイテムに格納される値を入力します。「オフ」オプションが選択されているときにNULLを格納する場合は、この属性を空白にすることもできます。値は255文字以内で指定できます。
ノート: この値は、ページ・アイテムに移入される値が「オン値」または「オフ値」のいずれにも一致しない場合に使用されます。
-
オフ・ラベル - 「オフ」オプションとして表示されるテキストを入力します。
-
検証、必須の値 - 「オン」に設定し、ページ・アイテムが表示されている場合、Oracle APEXでは、ページの送信時にNOT NULL検証が自動的に実行されます。詳細は、ヘルプを参照してください。
|
テキスト・フィールド |
テキスト・フィールドとしてアイテムを表示します。
ページ・デザイナのアイテム属性:
-
設定、サブタイプ - HTML5テキスト・サブタイプを選択します。これによって、オンスクリーン・キーボードの付いたデバイスで、サブタイプごとに最適化されたキーボード・レイアウトを表示できるため、データ入力が簡単になります。サブタイプの選択は、ページ・アイテムの値を使用して適切なリンクをレンダリングする際にも使用されます(読取り専用でレンダリングされる場合)。物理キーボードを使用する場合、この属性でテキスト・アイテムやデータ・エントリは変更されません。
ノート: これはHTML5の機能のため、対応するブラウザでのみ機能します。より古い、HTML5に準拠していないブラウザではこの属性は無視され、ページ・アイテムは通常のテキスト・フィールドとしてレンダリングされます。
-
設定、空白の切捨て - アイテム値をどのように切り捨てるかを選択します。この設定によって、入力されたテキストから、空白、タブおよび改行が切り捨てられます。オプションには、「先頭」、「末尾」、「先頭および末尾」または「なし」があります。
-
設定、テキストの大/小文字 - アイテム値のテキストの大/小文字をどのように変換するかを選択します。オプションには、「変更なし」、「小文字」および「大文字」があります。
-
検証、必須の値 - 「オン」に設定し、ページ・アイテムが表示されている場合、Oracle APEXでは、ページの送信時にNOT NULL検証が自動的に実行されます。詳細は、ヘルプを参照してください。
|
オートコンプリートが有効なテキスト・フィールド |
エンド・ユーザーが入力したテキストに基づいてテキスト・アイテムが埋め込まれた、使用可能な値のリストを表示するテキスト・フィールドを表示します。エンド・ユーザーがテキストを入力するにつれてリストが絞り込まれます。
select [column]
from ...
where ...
order by ...
ページ・デザイナのアイテム属性:
-
設定、検索 - 入力値に対する検索の実行方法を選択します。「遅延ロード」を使用する場合、この設定が問合せのパフォーマンスに影響することがあります。「「次を含む」および「大/小文字を区別」」または「「次を含む」および「大/小文字区別なし」」を選択すると、列索引が使用されません。
-
設定、入力時にフェッチ - ユーザーがオートコンプリート・アイテムで入力したとき、一致する値をデータベースから取得するかどうかを指定します。「入力時にフェッチ」では、ユーザーが文字を入力するたびに、一致するレコードがデータベースから取得されます。それ以外の場合、ページをロードするときに、すべてのリスト値がロードされます。
多数のレコードのロードによってページの初期ロード時間が影響を受けることがあるため、選択リストが大きい場合、「入力時にフェッチ」を使用することをお薦めします。
-
設定、リスト内の最大値 - 選択ボックスに表示するアイテムの最大数を入力します。この値によって、数の行を返すことによるパフォーマンスの問題を回避でき、数文字のみが入力された場合に戻りセットが非常に大きくなることも避けられます。
-
検証、必須の値 - 「オン」に設定し、ページ・アイテムが表示されている場合、Oracle APEXでは、ページの送信時にNOT NULL検証が自動的に実行されます。詳細は、ヘルプを参照してください。
|
テキスト領域 |
複数行のテキスト領域を表示します。
ページ・デザイナのアイテム属性:
-
設定、サイズ変更可能 - マウスを使用したテキスト領域のサイズ変更が有効かどうかを指定します。
-
設定、高さ自動調整機能 - 表示されるテキストの量に基づいてテキスト領域の高さを変えるかどうかを指定します。テキスト領域をデータ量に応じて決める場合は、このオプションを使用します。
-
設定、文字カウント機能 - 「オン」に設定すると、フィールドに入力された文字数を表示するカウンタが含まれます。
-
設定、空白の切捨て - アイテム値をどのように切り捨てるかを選択します。この設定によって、入力されたテキストから、空白、タブおよび改行が切り捨てられます。オプションには、「先頭」、「末尾」、「先頭および末尾」または「なし」があります。
-
検証、必須の値 - 「オン」に設定し、ページ・アイテムが表示されている場合、Oracle APEXでは、ページの送信時にNOT NULL検証が自動的に実行されます。詳細は、ヘルプを参照してください。
- セッション・ステート、データ型 - ページ・アイテムのデータ型(
VARCHAR2 またはCLOB )を選択します。
- セッション・ステート、ストレージ - セッション・ステートの保持方法を選択します。オプションは次のとおりです。
- リクエストごと(メモリーのみ) - ステートをデータベースに保存しません。ステートを使用できるのは、現在のリクエストを処理しているときのみです。AJAXリクエストでアイテムを使用する必要がある場合は、「送信するページ・アイテム」を使用してアイテム名を必ず渡してください。
- セッションごと(永続) - リクエストをまたがって値にアクセスできるように、各セッションの値がデータベースに保存されます。
|