Validation

Validating fields (text or other) is crucial for ensuring that data entered by users meets specific criteria or formats and for maintaining data integrity and security.

In Jigx Builder you can use regular expressions (regex) for text validation. They allow for pattern matching and can enforce complex rules for text fields such as email addresses, phone numbers, usernames, passwords, and more. When applied to text validation, regex can be used to check if the input text matches the desired format. If it is not valid, an invalid message is displayed.

In Jigx you combine a JSONata expression with a Regex expressions to create a validation pattern and provide a message if the pattern does not match.

Creating the validation expression:

JSONata expression - [email protected]
Regex expression - /^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$/
Validation message - not an email

Combine the three above to validate an email address in the text-field component.

YAML

- type: component.text-field
          instanceId: email
          options:
            label: Email
            errorText: =$contains(@ctx.components.email.state.value, /^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$/) ? '' :'not an email'

Regex and JSONata Expression examples

Here are some common validation expressions to create and use for text field validation.

Validation

Expected result

Phone number

+271234556789

[email protected]

Credit Card

Typically 13-16 digits, with spaces or dashes optional, and includes checks for Visa, MasterCard, American Express, and Discover. 1111-1111-1111-1111 or 1111 1111 1111 1111

ZIP/Postal code (US)

5-digit codes, e.g. 10036

Social Security Number (US)

XXX-XX-XXXX

National Insurance (UK)

AA123456C

US Date (DD/MM/YYYY)

23/07/2024

Date (MM/DD/YYYY)

03/28/2023

Date (DD Month YYYY)

25 July 2024