Web Components Input (入力) の概要
Ignite UI for Web Components Input は、ユーザーがデータを入力できるコンポーネントです。
Web Components Input の例
開始するには、typescript ファイルに IgcInputComponent をインポートし、次のように defineComponents() 関数を呼び出してコンポーネントを登録する必要があります。
import { defineComponents, IgcInputComponent } from 'igniteui-webcomponents';
import 'igniteui-webcomponents/themes/light/bootstrap.css';
defineComponents(IgcInputComponent);
Ignite UI for Web Components の完全な概要については、作業の開始トピックを参照してください。
IgcInputComponent コンポーネントをインポートしたら、使用を開始する準備ができているので、最初の Input を追加しましょう。
<igc-input type="email" label="Subscribe" placeholder="john.doe@mail.com"></igc-input>
Prefix と Suffix
prefix スロットと suffix スロットを使用すると、入力のメイン コンテンツの前後に異なるコンテンツを追加できます。次のサンプルでは、テキスト プレフィックスとアイコン サフィックスを使用して新しい Input フィールドを作成します:
ヘルパー テキスト
helper-text スロットは、入力の下に配置されたヒントを提供します。Phone Input にヘルパー テキストを追加しましょう:
Input のサイズ設定
ユーザーが --ig-size CSS 変数を使用して IgcInputComponent のサイズを変更できるようにすることができます。これを行うには、すべてのサイズ値を表示するためのラジオ ボタンをいくつか追加します。このようにして、選択されるたびに、Input のサイズを変更します。
上記のサンプルでは、次の属性の使用法を示しています:
required- 入力を必須としてマークするために使用されます。disabled- 入力を無効にするために使用されます。readonly- 入力を読み取り専用としてマークするために使用されます。
属性の完全なリストは、IgcInputComponent API にあります。
スタイル設定
IgcInputComponent コンポーネントは、その内部要素のほとんどすべての CSS パーツを公開します。次の表に、公開されているすべての CSS パーツを示します:
| 名 | 説明 |
|---|---|
container |
すべての主要な入力要素を保持するメイン ラッパー。 |
input |
ネイティブ入力要素。 |
label |
ネイティブ ラベル要素。 |
prefix |
プレフィックス ラッパー。 |
suffix |
サフィックス ラッパー。 |
helper-text |
ヘルパー テキスト ラッパー。 |
igc-input::part(input) {
background-color: var(--ig-primary-100);
border-color: var(--ig-secondary-500);
box-shadow: none;
}
igc-input::part(label) {
color: var(--ig-gray-700);
}
igc-input::part(prefix),
igc-input::part(suffix) {
color: var(--ig-primary-600-contrast);
background-color: var(--ig-primary-600);
border-color: var(--ig-secondary-600);
}