React (フォーム) の概要

    React の Form コンポーネントは、アプリケーションの要件に適合するお問い合わせフォームや登録ページを設定するために使用されます。React フォーム検証を簡単に提供し、フォームの向きを定義し、必要なレイアウトを構成またはカスタマイズすることもできます。React フォーム コンポーネントは、ユーザー アクションに応答する機会を与えるイベントも公開します。

    React の例

    次の例は、内部にいくつかの入力、ボタン、およびチェックボックスがある IgrForm を表しています。

    使用方法

    まず、次のコマンドを実行して、対応する Ignite UI for React npm パッケージをインストールする必要があります:

    npm install igniteui-react

    次に、以下のように、IgrForm とそれに必要な CSS をインポートし、そのモジュールを登録する必要があります:

    import { IgrFormModule, IgrForm } from 'igniteui-react';
import 'igniteui-webcomponents/themes/light/bootstrap.css';
IgrFormModule.register();

    IgrForm の使用を開始する最も簡単な方法は次のとおりです:

    フォーム データは、次のコンポーネントについて収集されます:

    フォーム コントロールが無効な場合、フォームは送信されず、エラー メッセージが表示されます。フォームの送信時にフォーム要素を検証しないように指定する場合は、novalidate 属性を IgrForm 要素に追加できます。

    <IgrForm novalidate="true"></IgrForm>

    イベント

    Form コンポーネントは、次のイベントを発生させます:

    • Submit - フォームが送信されたときに発生します。
    • Reset - フォームがリセットされたときに発生します。

    Submit イベントのイベント リスナーを追加する方法を示す例を次に示します:

    document.addEventListener('igcSubmit', function (event) {
  const customEvent = event as CustomEvent<FormData>;
  console.log(customEvent.detail);
});

    メソッド

    Form コンポーネントは、次のメソッドを公開します:

    メソッド 説明
    Submit フォーム データを送信します。
    Reset フォーム データをリセットします。
    GetFormData フォーム データを収集し、単一の FormData オブジェクトを返します。
    reportValidity 要素の子コントロールが検証制約を満たしているかどうかを返します。

    API リファレンス

    その他のリソース