Close
Angular React Web Components Blazor Angular
Open Source

Color Picker コンポーネント New

Ignite UI for Angular Color Picker は、グラデーション キャンバス、色相と透明度のスライダー、フォーマットの切り替え、スポイト、定義済みのスウォッチを備えたインタラクティブなドロップダウンを通じて、ユーザーが色を選択および編集できるフォーム関連コンポーネントです。

ライブ デモ

Angular Color Picker のデモは、現在選択されている色をプレビューし、別の色を編集または選択できるドロップダウンを開く input モードのアンカーを示します。

構造

Angular Color Picker は、ピッカー サーフェス (グラデーション キャンバス、色相と透明度のスライダー、フォーマットに応じた色入力、アクション ボタン、オプションのスウォッチ グリッド) を含むポップオーバー ドロップダウンを開くアンカーで構成されます。

Color Picker anatomy
A - 入力型 Color Picker

1. 入力モード: mode="input" でレンダリングされた Color Picker。
2. カラー アンカー/フィル: ピッカー ドロップダウンをトリガーし、現在選択されている色を表示します。
3. ラベル: 入力型 Color Picker のラベル。
4. プレースホルダー: 入力が空の間に表示される、#rrggbb のようなアクティブなフォーマットのパターン。
5. サフィックス コンテナー: アクション ボタンなどのサフィックス要素のコンテナー。
6. ヒント: 入力型 Color Picker のヒント テキスト。
B - デフォルト Color Picker

1. カラー アンカー: ピッカー ドロップダウンをトリガーします。
2. フィル: 現在選択されている色を表示します。
3. ラベル: Color Picker のラベル。
4. ヒント: Color Picker のヒント テキスト。
C - Color Picker ドロップダウン

1. Color Picker ドロップダウン: すべての色選択コントロールを含むポップオーバー。
2. グラデーション キャンバス: ドラッグ可能なマーカーを持つ HSV の彩度/明度エリア。
3. Color Picker マーカー: グラデーション キャンバス上で現在選択されている色を示すドラッグ可能なマーカー。
4. 色相スライダー: 基本色用の範囲スライダー。
5. 色相スライダー ハンドル: 色相スライダー上で現在選択されている色相を示すドラッグ可能なマーカー。
6. コピー ボタン: 現在選択されている色をクリップボードにコピーします。
7. スポイト ボタン: 画面から色を選択するためのスポイト ツールをアクティブにします。
8. 透明度スライダー: show-alpha が設定されている場合に表示されるオプションの不透明度スライダー。
9. 透明度スライダー ハンドル: 透明度スライダー上で現在選択されている透明度の値を示すドラッグ可能なマーカー。
10. 不透明度の値: 透明度スライダー上で現在選択されている不透明度の値。
11. フォーマット スイッチャー: 色のフォーマット (hex、rgb、hsl) を選択するためのドロップダウン。
12. 色の値: 選択されたフォーマット (hex、rgb、hsl) に従って表示される現在選択されている色の値。
13. スウォッチ: 定義済みの色のスウォッチのオプションのグリッド。
<igc-color-picker>
└── ::part(color-picker)
    ├── igc-popover
    │   ├── ::part(anchor)                   // trigger button (default mode) or swatch button in the input prefix (input mode)
    │   │                                    // also ::part(empty) with no value, ::part(input-mode) in input mode
    │   └── ::part(picker)                   // dropdown, role="dialog"
    │       ├── ::part(picker-canvas)        // gradient canvas
    │       │   └── ::part(marker)           // focusable slider; also ::part(dragging) while dragged
    │       ├── ::part(main-row)
    │       │   ├── ::part(hue)              // hue range slider
    │       │   └── ::part(buttons)
    │       │       ├── ::part(copy)         // copy-to-clipboard button
    │       │       └── ::part(eye-dropper)  // eye-dropper button
    │       ├── ::part(alpha-row)            // rendered when show-alpha is set
    │       │   ├── ::part(alpha)            // alpha range slider
    │       │   └── ::part(alpha-input)      // alpha percentage input
    │       ├── ::part(inputs-row)
    │       │   ├── ::part(format-select)    // format switcher, hidden when hide-formats is set
    │       │   └── color value input
    │       └── ::part(swatches)             // rendered when swatches is non-empty
    │           └── ::part(swatch)           // individual swatch buttons
    ├── ::part(label)                        // default mode, rendered when label is set
    └── helper text and validation messages

作業の開始

Angular Color Picker を使用するには、基本的なプロジェクト セットアップについて Ignite UI for Angular の作業の開始 トピックを参照してから、コンポーネントを登録します。

Color Picker には igniteui-webcomponents 7.3.0 以降が必要です。

Ignite UI for Angular は Color Picker を Web コンポーネントとしてレンダリングするため、Angular プロジェクトに igniteui-webcomponents をインストールします。

npm install igniteui-webcomponents

IgcColorPickerComponent とテーマをインポートしてから、コンポーネントを登録します。

import { defineComponents, IgcColorPickerComponent } from 'igniteui-webcomponents';
import 'igniteui-webcomponents/themes/light/bootstrap.css';

defineComponents(IgcColorPickerComponent);

igc-color-picker をレンダリングする Angular コンポーネントに CUSTOM_ELEMENTS_SCHEMA を追加します。

import { CUSTOM_ELEMENTS_SCHEMA } from '@angular/core';

@Component({
    schemas: [CUSTOM_ELEMENTS_SCHEMA],
})

ラベル付きで Color Picker をレンダリングします。

<igc-color-picker label="Pick a color"></igc-color-picker>

使用方法

value には、任意の CSS カラー文字列 (先頭の # の有無にかかわらない hex、rgb/rgba、hsl/hsla、または名前付きカラー) を設定します。空または無効な文字列は値をクリアし、アンカーには市松模様が表示されます。

<igc-color-picker value="#1976d2"></igc-color-picker>

モード

mode プロパティは、アンカーの表示方法を制御します。デフォルト値の default は現在の色をプレビューするトリガー ボタンをレンダリングし、input は色のスウォッチをプレフィックスとして持つ編集可能なテキスト フィールドをレンダリングします。どちらのアンカーも同じピッカー ドロップダウンを開きます。

<igc-color-picker mode="input" label="Background"></igc-color-picker>

フォーマット

色をシリアル化する方法を制御するには format プロパティを使用します。サポートされる値は hex、rgb、hsl です。フォーマットを変更すると、既存の色を変更せずに再シリアル化するため、igcInput イベントも igcChange イベントも発生しません。

<igc-color-picker format="rgb" value="#1976d2"></igc-color-picker>

組み込みのフォーマット スイッチャーを非表示にしてピッカーを単一のフォーマットに固定するには、hideFormats プロパティを設定します。

<igc-color-picker hide-formats format="hex"></igc-color-picker>

透明度

デフォルトでは、ピッカーは完全に不透明な色を編集します。透明度スライダーとそのパーセンテージ入力を有効にするには、showAlpha プロパティを設定します。

<igc-color-picker show-alpha value="rgba(25, 118, 210, 0.5)"></igc-color-picker>

スウォッチ

swatches プロパティを通じて定義済みの色のリストを指定します。設定すると、ピッカーは色の入力の下にスウォッチ グリッドをレンダリングします。スウォッチをクリックすると、それが現在の色として適用されます。定義できるスウォッチの数に制限はありません。

const picker = document.querySelector('igc-color-picker');
picker.swatches = ['#f44336', '#e91e63', '#9c27b0', '#3f51b5', '#2196f3', '#4caf50'];

無効

Color Picker を無効にするには、disabled プロパティを設定します。

<igc-color-picker disabled value="#1976d2"></igc-color-picker>

検証

色が選択されていない場合にフォームの検証を失敗させるには、コントロールを required としてマークします。このコンポーネントは、標準のフォーム関連 API (checkValidity、reportValidity、setCustomValidity) をサポートします。

以下のスロットを使用して、アンカーの下にヘルパーと検証メッセージを表示します。

  • helper-text – アンカーの下にヒントまたは説明メッセージを表示します。
  • value-missing – 必須フィールドの検証が失敗した場合にカスタム コンテンツをレンダリングします。
  • invalid – コンポーネントが無効な状態のときにカスタム コンテンツをレンダリングします。
  • custom-error – setCustomValidity() を使用してカスタム検証メッセージが設定されている場合にコンテンツを表示します。
<igc-color-picker required label="Brand color">
  <span slot="helper-text">Pick the primary brand color.</span>
  <span slot="value-missing">A color is required.</span>
</igc-color-picker>

サイズ

--ig-size 変数を --ig-size-small、--ig-size-medium、--ig-size-large の 3 つのオプションのいずれかに設定して、Color Picker のサイズを制御します。これは、デフォルトと入力型の両方のアンカー、およびドロップダウン ウィンドウのサイズを調整するために使用できます。

使用すべき場合と使用すべきでない場合

使用する場合: ユーザーがビジュアル エディターを通じて任意の色を入力または編集する必要があり、その値がフォームの送信と検証に関与する必要がある場合に Color Picker を使用します。常に明確なラベルを提供し、ピッカーが他のフォーム フィールドと並んで配置される場合は input モードを優先します。

使用しない場合: ユーザーが少数の固定された色のセットからのみ選択する場合は、代わりにそのセットを通常のボタンまたはセレクトとしてレンダリングします。

Color Picker used to choose a drawing brush color Color Picker used to choose a product color that comes in a fixed set of options
DoDon’t

描画ツールのブラシ、イラストの塗りつぶし、チャート シリーズ、カスタム テーマなど、自由度の高い創造的なタスクには完全な Color Picker を使用します。

ユーザーが固定されたパレットからのみ選択する必要がある場合や、高度なカスタマイズ オプションを必要としない場合は、Color Picker の使用を避けてください。

Angular フォームでの Color Picker の使用

Angular フォームで Color Picker Web コンポーネントを使用し、formControlName または ngModel でバインドするには、Angular は ControlValueAccessor インターフェイスの実装を必要とします。Ignite UI for Angular は、対応する Web コンポーネントに要素セレクターでアタッチする IgcFormControlDirective としてこれを提供します。バージョン 22.2.0 以降、igc-rating に加えて igc-color-picker もサポートされます。

IgcFormControlDirective を ReactiveFormsModule (または ngModel でバインドする場合は FormsModule) と一緒にインポートします。

import { ReactiveFormsModule } from '@angular/forms';
import { IgcFormControlDirective } from 'igniteui-angular/directives';
// import { IgcFormControlDirective } from '@infragistics/igniteui-angular/directives'; for licensed package

@Component({
    imports: [ReactiveFormsModule, IgcFormControlDirective],
    schemas: [CUSTOM_ELEMENTS_SCHEMA]
})

export class LabelFormComponent {...}

次に、formControlName を使用して Color Picker を FormControl にバインドします。コントロールはアクティブな format で色を受け取り、フォーカスが異なる色で Color Picker から離れると更新されます。

<form [formGroup]="labelForm">
  <igc-color-picker formControlName="color" label="Label color" required></igc-color-picker>
</form>

このディレクティブは値のバインドのみを処理します。[swatches]="swatches" など、他の Color Picker プロパティに Angular プロパティ バインディングを使用する場合は、CUSTOM_ELEMENTS_SCHEMA を維持してください。

次のサンプルは、必須検証を伴うリアクティブ フォームで Color Picker を使用します。

プロパティ

Angular Color Picker は、そのコンテンツ、表示、およびフォームとの関連付けのためのプロパティを公開します。

名前 型 デフォルト 説明
value string '' アクティブなフォーマットでシリアル化された現在の色。
label string — アンカーのラベル。mode="input" では、アンカーの入力自体のラベルに転送されます。
format 'hex' | 'rgb' | 'hsl' 'hex' 値の文字列をシリアル化するときに使用する出力フォーマット。
mode 'default' | 'input' 'default' アンカーがトリガー ボタン (default) か、スウォッチのプレフィックスを持つ編集可能なテキスト フィールド (input) か。
swatches string[] [] 選択可能なスウォッチ グリッドとしてレンダリングされる定義済みの色の文字列。
hideFormats boolean false フォーマット スイッチャーを非表示にするかどうか。
showAlpha boolean false 透明度スライダーとそのパーセンテージ入力を表示するかどうか。
required boolean false フォームの検証にコントロールが必須かどうか。
disabled boolean false コントロールの無効状態。
open boolean false ピッカー ドロップダウンの開いた状態。
name string — フォーム送信用のコントロールの名前。
invalid boolean false コントロールの無効 (invalid) なビジュアル状態を設定または返します。

メソッド

名前 戻り値の型 説明
show Promise<boolean> igcOpening または igcOpened を発生させずにピッカー ドロップダウンを開きます。
hide Promise<boolean> igcClosing または igcClosed を発生させずにピッカー ドロップダウンを閉じます。
toggle Promise<boolean> イベントを発生させずにピッカー ドロップダウンの開いた状態を切り替えます。
checkValidity boolean メッセージを表示せずにコントロールの妥当性を確認します。
reportValidity boolean コントロールの妥当性を確認し、ユーザーに報告します。
setCustomValidity void カスタム検証メッセージを設定します。クリアするには空の文字列を渡します。

イベント

名前 キャンセル可能 詳細 説明
igcInput いいえ string グラデーション キャンバス、色相と透明度のスライダー、透明度の入力、スウォッチ、またはスポイトからのすべての中間的な変更で発生します。
igcChange いいえ string フォーカスがコンポーネントから離れ、色がフォーカスが入ったときの色と異なる場合に発生します。
igcOpening はい void ユーザーがピッカー ドロップダウンを開く直前に発生します。event.preventDefault() でキャンセルします。
igcOpened いいえ void ユーザーがピッカー ドロップダウンを開いた後に発生します。
igcClosing はい void ユーザーがピッカー ドロップダウンを閉じる直前に発生します。event.preventDefault() でキャンセルします。
igcClosed いいえ void ユーザーがピッカー ドロップダウンを閉じた後に発生します。

スタイル設定

Angular Color Picker の外観は、CSS 変数、CSS パーツ、およびテーマ設定システムを通じてカスタマイズできます。

スタイル変数

変数 変更する内容
--ig-color-picker-label-color Color Picker ラベルの色。
--ig-color-picker-label-color-invalid コンポーネントが無効 (invalid) な場合のラベルの色。
--ig-color-picker-label-color-disabled コンポーネントが無効化されている場合のラベルの色。
--ig-color-picker-anchor-background Color Picker アンカーの背景色。
--ig-color-picker-anchor-background-hover ホバー時のアンカーの背景色。
--ig-color-picker-anchor-background-focus-visible フォーカスが表示されている場合のアンカーの背景色。
--ig-color-picker-anchor-background-focus-visible-hover フォーカスが表示されており、ホバーされている場合のアンカーの背景色。
--ig-color-picker-anchor-background-active アクティブ時のアンカーの背景色。
--ig-color-picker-anchor-background-active-focus-visible フォーカスが表示された状態でアクティブなアンカーの背景色。
--ig-color-picker-anchor-background-disabled 無効化されている場合のアンカーの背景色。
--ig-color-picker-anchor-outline-color アンカーのフォーカス表示時のアウトライン色。
--ig-color-picker-anchor-border-color アンカーの境界線色。
--ig-color-picker-anchor-border-color-disabled 無効化されている場合のアンカーの境界線色。
--ig-color-picker-anchor-border-radius アンカーの境界線の半径。
--ig-color-picker-swatch-preview-border-color アンカー内の色プレビューの境界線色。
--ig-color-picker-picker-background ピッカー ドロップダウンの背景色。
--ig-color-picker-picker-border-color ピッカー ドロップダウンの境界線色。
--ig-color-picker-picker-border-radius ピッカー ドロップダウンの境界線の半径。
--ig-color-picker-picker-canvas-border-color ピッカーのグラデーション キャンバスの境界線色。
--ig-color-picker-picker-elevation ピッカー ドロップダウンの影。
--ig-color-picker-slider-track-border-color 色相と透明度のスライダー トラックの境界線色。
--ig-color-picker-slider-track-border-radius 色相と透明度のスライダー トラックの境界線の半径。
--ig-color-picker-slider-thumb-border-color 色相と透明度のスライダー サムの境界線色。
--ig-color-picker-swatch-separator-color スウォッチ グリッド上部の区切り線の色。
--ig-color-picker-swatch-border-color 定義済みの色のスウォッチの境界線色。
--ig-color-picker-swatch-border-radius 定義済みの色のスウォッチの境界線の半径。
--ig-color-picker-swatch-size 定義済みの色のスウォッチのサイズ。
--ig-color-picker-transparency-grid-odd 透明度グリッドの奇数チェッカー色。
--ig-color-picker-transparency-grid-even 透明度グリッドの偶数チェッカー色。
--ig-color-picker-invalid-color 無効 (invalid) 状態のインジケーターに使用される色。
--ig-color-picker-marker-size ピッカーのグラデーション キャンバス上のマーカーのサイズ。
--ig-color-picker-marker-elevation ピッカーのグラデーション キャンバス上のマーカーの影。
--ig-color-picker-marker-color ピッカーのグラデーション キャンバス上のマーカーの色。

スタイル パーツ

パーツ スタイル設定する内容
color-picker アンカー、ラベル、ヘルパー テキストを囲むラッパー。
anchor ピッカーを開くトリガー要素 (デフォルト モードではボタン、入力モードではスウォッチのプレフィックス)。
empty 色の値が設定されていない場合に anchor とともに適用され、市松模様の背景をレンダリングします。
input-mode 入力モードで anchor とともに適用されます。
label デフォルト モードでアンカーの上にレンダリングされるラベル。
picker キャンバス、スライダー、入力、スウォッチを保持するポップオーバー コンテナー。
picker-canvas グラデーション キャンバス。
marker グラデーション キャンバス上のドラッグ可能なマーカー。
dragging マーカーがドラッグされている間、marker とともに適用されます。
main-row 色相スライダーとコピー/スポイト ボタンを含む行。
alpha-row show-alpha が設定されている場合にレンダリングされる、透明度スライダーと入力を含む行。
alpha-input 透明度パーセンテージの入力。
inputs-row フォーマットの選択と色の値の入力を含む行。
buttons コピーとスポイトのボタンを囲むラッパー。
hue 色相の範囲スライダー。
alpha 透明度 (不透明度) の範囲スライダー。
copy クリップボードへのコピー アイコン ボタン。
eye-dropper スポイト アイコン ボタン。
format-select 色の文字列フォーマットを切り替えるために使用されるセレクト コントロール。
swatches 定義済みの色のスウォッチのコンテナー。
swatch 個々の定義済みの色のスウォッチ ボタン。

Sass テーマ

Sass を通じて Color Picker の外観をカスタマイズするには、color-picker-theme 関数を使用します。

@use "igniteui-theming/sass/themes" as *;

$custom-color-picker-theme: color-picker-theme(
  $picker-background: #e6f2ff,
  $picker-border-color: #a9b8cc,
  $picker-border-radius: 1rem
);

:root {
  @include tokens($custom-color-picker-theme);
}

CSS 変数

Sass ビルド ステップなしでローカルにスタイル設定する必要がある場合は、コンポーネントの CSS 変数を直接設定します。

igc-color-picker {
  --ig-color-picker-picker-background: #e6f2ff;
  --ig-color-picker-picker-border-color: #a9b8cc;
  --ig-color-picker-picker-border-radius: 1rem;
  --ig-color-picker-picker-elevation: none;
}

igc-color-picker::part(picker-canvas) {
  border-radius: 1rem;
}

Tailwind によるスタイル設定

igniteui-theming のカスタム Tailwind ユーティリティ クラスを使用して Color Picker のスタイルを設定します。まず Tailwind をセットアップして Ignite UI テーマを適用します。

@import "tailwindcss/theme.css";
@import "tailwindcss/utilities.css";

light-color-picker ユーティリティを適用して Color Picker にそのテーマ変数を与え、任意のプロパティ クラスで個々の変数をオーバーライドします。! プレフィックスはユーティリティを important としてマークし、コンポーネントのデフォルトのテーマ スタイルよりも優先されるようにします。

<igc-color-picker class="!light-color-picker [--ig-color-picker-picker-background:#fff0eb] [--ig-color-picker-picker-border-color:#f95924]"></igc-color-picker>

アクセシビリティ

Angular Color Picker は、キーボードで操作可能なフォーム関連コントロールです。アンカーはラベル付きボタン (デフォルト モード) または編集可能な入力 (入力モード) であり、開いたピッカーはフォーカスをトラップします。

キーボード インタラクション

以下のキー バインディングは、コンポーネントが disabled の間はスキップされます。

キー アクション
Alt + ArrowDown ピッカー ドロップダウンを切り替えます。
Alt + ArrowUp ピッカー ドロップダウンを閉じ、フォーカスをアンカーに戻します。
Escape ピッカー ドロップダウンを閉じ、フォーカスをアンカーに戻します。
矢印キー グラデーション キャンバスのマーカーにフォーカスがある場合、押された方向に 1 ステップずつマーカーを移動します。
ArrowUp / ArrowDown 透明度の入力にフォーカスがある場合、不透明度を 1% 増減します。
Tab 開いたピッカー内のインタラクティブな要素間でフォーカスを移動します。

スクリーン リーダー / ARIA

  • アンカーは aria-haspopup="dialog" と aria-expanded を設定し、aria-describedby を通じてヘルパー テキスト コンテナーを参照するため、ヘルパーと検証メッセージがアナウンスされます。
  • ピッカー ドロップダウンには role="dialog" とアクセシブルな名前 Color picker があります。
  • グラデーション キャンバスのマーカーには role="slider" があり、aria-valuetext を通じて両方の軸をアナウンスします (例: Saturation 50%, brightness 80%)。
  • 色相と透明度のスライダーは、aria-label (Hue、Alpha slider) でラベル付けされたネイティブの input[type="range"] 要素です。
  • フォーマット スイッチャーと色の値の入力には視覚的に非表示のラベルが付いており、コピーとスポイトのボタンには視覚的に非表示のテキストが公開されています。
  • 各スウォッチ ボタンは aria-label を通じてその色を公開します。
  • ピッカーが開いている間、フォーカスはその中にトラップされます。閉じている間、ピッカーのコンテンツは inert であり、タブ順序から除外されます。

アクセシビリティ準拠

Infragistics は、Section 508 および WCAG 2.1 ガイドライン領域に関する Ignite UI for Angular のアクセシビリティ サポートを アクセシビリティ コンプライアンス トピックで説明しています。

基準 コンポーネントがどのように準拠しているか
1.3.1 情報および関係性 コンポーネントは、aria-describedby とスロット プロジェクションを通じて、そのラベル、ヘルパー テキスト、検証メッセージを公開します。
2.1.1 キーボード ピッカーの開閉、グラデーション マーカー、スライダー、入力、フォーマット スイッチャー、スウォッチはキーボードで操作できます。
4.1.2 名前、役割、値 アンカーは aria-haspopup と aria-expanded を公開し、マーカーはその値とともに role="slider" を公開し、スライダーはアクセシブルなラベルを公開し、スウォッチは aria-label を通じてその色を公開します。

ユーザー側の責任:

  • スクリーン リーダーでアンカーを識別できるように、label プロパティまたは投影されたラベルを通じてアクセシブルなラベルを提供してください。
  • 必須または無効な状態を伝えるために色だけに依存しないでください。検証スロットまたはヘルパー テキストを使用してください。
  • アンカーとピッカー サーフェスのテーマ スタイルをオーバーライドする場合は、十分なコントラストを維持してください。

トラブルシューティング

Angular Color Picker のトラブルシューティング ガイダンスは、一般的な統合およびプラットフォームの問題について、問題 → 原因 → 修正の形式に従います。

色の値がクリアされたり元に戻ったりするのはなぜですか?

空、空白のみ、または無効な文字列を value に割り当てると、前の値を保持する代わりに色がクリアされます。色の入力に入力された無効な文字列は、代わりに現在の色に戻ります。有効な CSS カラー文字列を割り当て、環境が OffscreenCanvas をサポートしていることを確認してください (既知の制限を参照)。

出力される値が入力したものと異なるフォーマットになるのはなぜですか?

値は常にアクティブな format でシリアル化されるため、入力文字列はバイト単位でラウンドトリップしません。たとえば、format="hex" で red と入力すると #ff0000 が生成されます。読み戻すことが予想される表記法に format を設定してください。

色を入力しても igcInput が発生しないのはなぜですか?

色の入力は、すべてのキーストロークではなく、変更されたときに入力された色をコミットするため、入力された色は igcInput を発生させません。フォーカスが異なる色でコンポーネントから離れたときに発生する igcChange をリッスンしてください。

既知の制限事項

  • スポイト ボタンは、EyeDropper API を実装しているブラウザーでのみ有効になります。サポートは、コンポーネントが作成されたときに一度検出されます。
  • クリップボードへのコピーは navigator.clipboard と安全なコンテキスト (HTTPS または localhost) に依存します。API が利用できない場所や権限が拒否された場所では、何も実行されません。
  • このコンポーネントは、すべての色の文字列を OffscreenCanvas の 2D コンテキストを通じて解析します。OffscreenCanvas が利用できない場合、すべての値は空になります。
  • Hue、Alpha slider、Open color picker、Copy color value to clipboard などの組み込みのアクセシブルなラベルは英語のみで、ローカライズされていません。

API リファレンス

Color Picker の完全な API サーフェスについては、これらの API リファレンスを使用してください。

IgcColorPickerComponent

依存関係

Angular Color Picker は、ビジュアル スタイルを適用するためにテーマ スタイルシートを必要とします。作業の開始のセットアップを参照してください。

その他のリソース

サポートと関連する Ignite UI ドキュメントについては、以下のリソースを使用してください。

FAQ

Color Picker をフォームにバインドするにはどうすればよいですか?

name 属性をフォーム フィールド名に設定し、Color Picker を <form> 要素内に配置します。現在シリアル化されている色はその名前で送信され、コントロールは標準のフォーム関連要素 API を通じて required 検証とフォームのリセットに関与します。 Angular リアクティブ フォームでは、IgcFormControlDirective をインポートし、formControlName で Color Picker をバインドします。Angular リアクティブ フォームでの Color Picker の使用 を参照してください。

`igcInput` は `igcChange` とどう違いますか?

igcInput は、キャンバス、スライダー、透明度の入力、スウォッチ、またはスポイトとのすべての中間的な操作で発生します。igcChange は、フォーカスが Color Picker から離れ、色がフォーカスが入ったときの色と異なる場合に一度だけ発生し、ネイティブの change イベントのセマンティクスに一致します。色の入力に入力された色は igcChange のみを発生させます。

どのパッケージが Color Picker を提供していますか?

Color Picker は igniteui-webcomponents パッケージ (バージョン 7.3.0 以降) で提供されます。 igniteui-angular には Color Picker が含まれていないため、Angular アプリケーションは直接インストールします。