Documentation

検証ルールの追加

フラグメントの設定オプションを定義する際に、text タイプのフィールドに有効なエントリーのルールを決める validation プロパティを追加することができます。 ルールのタイプ(textnumberemailurl、または pattern)を指定することで、各フィールドが受け入れるデータのタイプを決定します。 また、カスタムのエラーメッセージを追加して、無効なエントリーをユーザーに通知することもできます。

テキスト検証ルール

次のJSONコードは、 textタイプフィールドの有効なエントリー(つまりminLengthおよびmaxLength)で使用される最小および最大文字数を設定するtext検証ルールを追加します。

{
    "fieldSets": [
        {
            "fields": [
                {
                    "label": "validate text length",
                    "name": "text1",
                    "type": "text",
                    "typeOptions": {
                      "validation": {
                        "errorMessage": "Enter a minimum of 10 characters. Entries cannot exceed 30 characters.",
                        "type": "text",
                        "minLength": 10,
                        "maxLength": 30
                      }
                    }
                }
            ]
        }
    ]
}

テキスト検証ルールを使用して、有効なエントリーで使用される最小および最大の文字数を設定します。

数値検証ルール

次のJSONコードは、 textタイプフィールドの有効なエントリーの数値範囲(つまりminおよびmax)を定義するnumber検証ルールを追加します。

{
    "fieldSets": [
        {
            "fields": [
                {
                    "dataType": "int",
                    "label": "validate number",
                    "name": "text2",
                    "type": "text",
                    "typeOptions": {
                      "validation": {
                        "errorMessage": "Enter a number between 5 and 10.",
                        "type": "number",
                        "min": 5,
                        "max": 10
                      }
                    }
                }
            ]
        }
    ]
}

数値検証ルールを使用して、有効なエントリーの数値範囲を定義します。

メール検証ルール

次のJSONコードは、メール構文を要求し、textタイプフィールドの有効なエントリーの文字長(つまりminLengthおよびmaxLength)を定義するemail検証ルールを追加します。

{
    "fieldSets": [
        {
            "fields": [
                {
                    "label": "validate email",
                    "name": "text3",
                    "type": "text",
                    "typeOptions": {
                      "validation": {
                        "errorMessage": "Enter a valid email address.",
                        "type": "email",
                        "minLength": 1,
                        "maxLength": 30
                      }
                    }
                }
            ]
        }
    ]
}

メール検証ルールを使用して、メールの構文を要求し、有効なエントリーの文字長を定義します。

URL検証ルール

次のJSONコードは、適切なURLプロトコルを要求し、textタイプフィールドの有効なURLの文字長(つまりminLengthおよびmaxLength)を定義するurl検証ルールを追加します。

{
    "fieldSets": [
        {
            "fields": [
                {
                    "label": "validate url",
                    "name": "text4",
                    "type": "text",
                    "typeOptions": {
                      "validation": {
                        "errorMessage": "Enter a valid URL.",
                        "type": "url",
                        "minLength": 1,
                        "maxLength": 100
                      }
                    }
                }
            ]
        }
    ]
}

URL検証ルールを使用して、適切なURLプロトコルを要求し、有効なURLの文字長を定義します。

パターン検証ルール

次のJSONコードは、正規表現を使用してpattern検証ルールをtextタイプフィールドに追加して、有効なエントリーを定義します。

注釈

正規表現値の文字をエスケープするためにバックスラッシュを使用する場合(例:\d)、最初にバックスラッシュをエスケープするためにJSONファイル内で2つのバックスラッシュを使用する必要があります (例:\\d)。 JSONの文法については、 IETF のドキュメントを参照してください。

{
    "fieldSets": [
        {
            "fields": [
                {
                    "label": "validate pattern",
                    "name": "text5",
                    "type": "text",
                    "typeOptions": {
                      "validation": {
                        "errorMessage": "Enter a valid 10 digit phone number.",
                        "type": "pattern",
                        "regexp": "([0-9]{3})[.-]?([0-9]{3})[.-]?([0-9]{4})"
                      }
                    }
                }
            ]
        }
    ]
}

正規表現を使ったパターン検証ルールを使用して、有効なエントリーを定義します。