x_validators

Description:

x validators

☕ X Validators #


Simplest form validation for flutter form widgets.

Zero dependency
Extensible
Well tested
Open source

🚀 Installation #
Add the following to your pubspec.yaml file
dependencies:
x_validators: ^1.0.7
copied to clipboard
Don't forget to flutter pub get.
Api Overview #



Rules for Text
Description




IsRequired()
Ensures that the trimmed input is not empty.


Contains()
Verifies if the input string contains the provided value.


EndsWith()
Ensures that the input string ends with a specific value.


IsEmpty()
Ensures that the trimmed input is empty.


Match()
Verifies if the input matches the specified string.


MaxLength()
Ensures that the length is less than or equal to the specified maximum.


MinLength()
Ensures that the length is greater than or equal to the specified minimum.


NotContains()
Verifies if the input string does not contain the provided value.


StartsWith()
Ensures that the input string starts with a specific pattern.






Rules for NUMBERS
Description




IsArabicNum()
Verifies if the input is a valid Arabic integer.


IsHindiNum()
Verifies if the input is a valid Hindi integer.


IsNumber()
Verifies if the input is a valid integer.


MaxValue()
Verifies if the numeric value is less than or equal to the specified maximum.


MinValue()
Verifies if the numeric value is greater than or equal to the specified minimum.






Rules for URLS
Description




IsFacebookUrl()
Verifies if the input is a valid Facebook URL.


IsInstagramUrl()
Verifies if the input is a valid Instagram URL.


IsSecureUrl()
Verifies if the input is a secure URL (starts with 'https://').


IsUrl()
Verifies if the input is a valid URL.


IsYoutubeUrl()
Verifies if the input is a valid YouTube URL.






Rules for Phone
Description




IsEgyptianPhone()
Verifies if the input is a valid Egyptian phone number.


ISKsaPhone()
Verifies if the input is a valid Saudi Arabian phone number.






Rules for It
Description




IsEmail()
Verifies if the input is a valid email address.


IsBool()
Verifies if the input is a valid boolean value.


IsIpAddress()
Verifies if the input is a valid IP address.


IsPort()
Verifies if the input is a valid port number.


RegExpRule()
Allows using a regular expression as a validation rule.






Rules for lists
Description




ContainsAny()
Checks if the input contains any string from the provided list.


IsIn()
Checks if the input is in the provided list.


IsNotIn()
Checks if the input is not in the provided list.


NotContainsAny()
Checks if the input does not contain any item from the provided list.






Rules for magic
Description




IsOptional()
Allows skipping errors if the input is null.






Rules for colors
Description




IsHexColor()
Checks if the input is a valid hex color.






Rules for dates
Description




IsDateAfter()
Checks if the date is after the specified date.


IsDate()
Checks if the input is a valid date format.


IsDateMillis()
Checks if the input is a valid date format for milliseconds since epoch.






Rules for languages
Description




IsArabicChars()
Checks if the input consists of Arabic characters.


IsEnglishChars()
Checks if the input consists of English characters.


IsLtrLanguage()
Checks if the language code represents an LTR language.


IsArabicChars()
Checks if the input consists of Arabic characters.


IsNumbersOnly()
Checks if the input consists of numbers only.


IsRTLLanguage()
Checks if the language code represents an RTL language.



How to Use #
📚Basic use
Demonstrates basic usage of IsRequired validation rule to ensure that the input is not empty.
TextFormField(
decoration: const InputDecoration(labelText: 'IsRequired'),
validator: xValidator([

IsRequired(),
]),
),
copied to clipboard
📚onFailureCallBack
Illustrates more complex validation with multiple rules (IsRequired, MinLength, MaxLength).
The onFailureCallBack is triggered for any rule failure, logging the input and the failed rule for analysis.
TextFormField(
decoration: const InputDecoration(labelText: 'IsRequired'),
validator: xValidator([
// Ensures that the input is not empty with a custom error message.
IsRequired("Field cannot be empty"),

// Ensures that the input has a minimum length of 3 characters.
MinLength(3, "Field must be at least 3 characters"),

// Ensures that the input does not exceed a maximum length of 20 characters.
MaxLength(20, "Field cannot exceed 20 characters"),
], onFailureCallBack: (String? input, List<TextXValidationRule> rules, TextXValidationRule failedRule) {
// Logs information about the failed validation for further analysis.
log("###### Validation failed for input #### : $input");
log("#### Failed rule #### : $failedRule");
}),
),
copied to clipboard
Explanation:
The first example demonstrates basic usage of IsRequired validation rule. It ensures that the input is not empty.
The second example uses multiple rules (IsRequired, MinLength, MaxLength) for more complex validation. It also includes an
onFailureCallBack to handle validation failures. If any rule fails, the callback is triggered, logging the input and the failed rule for further analysis.
License #
Please see LICENSE.
👨🏻‍💻 Authors #

@Eng-MahmoudBasuony