このタグは、色を入力するためのテキスト・フィールドを作成します。 ユーザーは、colorFieldコンポーネントの構成方法に応じて、次の3つのうちいずれかの方法で色値を指定できます。
- フィールドに直接、色値を入力する。 このオプションは常に使用できます。
- 2番目のダイアログから色値を選択する。 このオプションは、ルック・アンド・フィールの実装によっては使用できない場合があります。 特に、PDAのルック・アンド・フィールでは使用できません。
- インラインのcolorPaletteコンポーネントから色値を選択する。 このオプションを使用可能にするには、colorPaletteをcolorFieldと同じページに配置して、colorFieldのpaletteId属性を対応するcolorPaletteのIDに設定する必要があります。 このオプションも、PDAのルック・アンド・フィールではサポートされません。
colorFieldのonSubmitValidaterを使用すると、colorFieldが使用する色値の表示書式と、colorFieldで有効な一連の色書式パターンの両方を制御できます。 詳細は、色のclientValidaterのドキュメントを参照してください。