-
Notifications
You must be signed in to change notification settings - Fork 58
Available Validators (rules)
All validators are written as snake_case
but it's up to the user's taste and could also be used as camelCase
. So for example alpha_dash_spaces
and alphaDashSpaces
are both equivalent.
NOTE: on an input type="number"
, the +
sign is an invalid character (browser restriction) even if you are using a signed
validator. If you really wish to use the +
, then change your input to a type="text"
.
-
accepted
The field under validation must beyes
,on
,1
, ortrue
. Useful for validating "Terms of Service" acceptance. -
alpha
Only alpha characters (including latin) are present (a-z, A-Z) -
alpha_spaces
Only alpha characters (including latin) and spaces are present (a-z, A-Z) -
alpha_num
Only alpha-numeric characters (including latin) are present (a-z, A-Z, 0-9) -
alpha_num_spaces
Only alpha-numeric characters (with latin & spaces) are present (a-z, A-Z, 0-9) -
alpha_dash
Only alpha-numeric characters + dashes, underscores are present (a-z, A-Z, 0-9, _-) -
alpha_dash_spaces
Alpha-numeric chars + dashes, underscores and spaces (a-z, A-Z, 0-9, _-) -
between:min,max
Will auto-detect value type then use proper validator.- Type Number uses
between_num
, String usebetween_len
.
- Type Number uses
-
between_date_iso:d1,d2
Alias ofbetween_date_iso
. -
between_date_euro_long:d1,d2
Alias ofdate_euro_long_between
. -
between_date_euro_short:d1,d2
Alias ofdate_euro_short_between
. -
between_date_us_long:d1,d2
Alias ofdate_us_long_between
. -
between_date_us_short:d1,d2
Alias ofdate_us_short_between
. -
between_len:min,max
Ensures the length of a string is between a min,max length. -
between_num:min,max
Ensures the numeric value (int or float) is between a min,max number. -
boolean
Ensures the value istrue
orfalse
(0
or1
is also valid). -
compare
Alias ofmatch
-
credit_card
Valid credit card number (AMEX, VISA, Mastercard, Diner's Club, Discover, JCB) -
date_iso
Ensure date follows the ISO format (yyyy-mm-dd) -
date_iso_between:d1,d2
Ensure date follows the ISO format and is between (d1) & (d2) -
date_iso_max:d
Date must follow ISO format and is lower or equal than date (d) -
date_iso_min:d
Date must follow ISO format and is higher or equal than date (d) -
date_euro_long
Date must follow the European long format (dd-mm-yyyy) or (dd/mm/yyyy) -
date_euro_long_between:d1,d2
Date must follow European long format and is between (d1) & (d2) -
date_euro_long_max:d
Date must follow European long format and is lower or equal than date (d) -
date_euro_long_min:d
Date must follow European long format and is higher or equal than date (d) -
date_euro_short
Date must follow the Euro short format (dd-mm-yy) or (dd/mm/yy) -
date_euro_short_between:d1,d2
Date must follow Euro short format and is between (d1) & (d2) -
date_euro_short_max:d
Date must follow Euro short format and is lower or equal than date (d) -
date_euro_short_min:d
Date must follow Euro short format and is higher or equal than date (d) -
date_us_long
Date must follow the US long format (mm-dd-yyyy) or (mm/dd/yyyy) -
date_us_long_between:d1,d2
Date must follow the US long format and is between (d1) & (d2) -
date_us_long_max:d
Date must follow US long format and is lower or equal than date (d) -
date_us_long_min:d
Date must follow US long format and is higher or equal than date (d) -
date_us_short
Date must follow the US short format (mm-dd-yy) or (mm/dd/yy) -
date_us_short_between:d1,d2
Date must follow the US short format and is between (d1) & (d2) -
date_us_short_max:d
Date must follow US short format and is lower or equal than date (d) -
date_us_short_min:d
Date must follow US short format and is higher or equal than date (d) -
different
Alias ofdifferent_input
-
different_input:f
Must be different from another input field(f), where (f) must be the exact ngModel attribute of input field to compare to. The error message will use the input name or thefriendly-name
if it was provided on first input, ex.:<input friendly-name="First Name".../>
will display :: Field must be different from specified field "First Name". -
different_input:f,t
Must be different from another input field(f), same as (different:f) but also include (t) for alternate input name to be displayed in the error message (it still uses a generic error message, if you really wish to replace the full error message then you should usematch:n:alt
see :alt) -
digits:n
Ensures that field only has integer numbers and length precisely matches the specified length (n). -
digits_between:min,max
Ensures that field only has integer numbers and is between a min,max length. -
email
Checks for a valid email address -
email_address
Alias ofemail
-
enum
Alias ofin_list
-
exact_len:n
Ensures that field length precisely matches the specified length (n). -
float
as to be floating value (excluding integer) -
float_signed
Has to be floating value (excluding int), could be signed (-/+) positive/negative. -
To properly validate an IBAN please use Wiki - Custom Validation with an external library like Github arhs/iban.jsiban
-
in
Alias ofin_list
-
in_list:foo,bar,..
Ensures the value is included inside the given list of values. The list must be separated by ',' and also accept words with spaces for example "ice cream". -
int
Only positive integer (alias tointeger
). -
integer
Only positive integer. -
int_signed
Only integer, could be signed (-/+) positive/negative (alias tointeger_signed
). -
integer_signed
Only integer, could be signed (-/+) positive/negative. -
ip
Alias ofipv4
-
ipv4
Check for valid IP (IPv4) -
ipv6
Check for valid IP (IPv6) -
match:f
Match another input field(f), where (f) must be the exact ngModel attribute of input field to compare to. The error message will use thefriendly-name
if it was provided on first input, ex.:<input friendly-name="Password".../>
will display :: Confirmation field does not match specified field "Password". -
match:f,t
Match another input field(f), same as (match:f) but also include (t) for alternate input name to be displayed in the error message (it still uses a generic error message, if you really wish to replace the full error message then you should usematch:n:alt
see :alt) -
match_input
Alias ofmatch
. -
max:n
Will auto-detect value type then use proper validator.- Type Number uses
max_num
, String usemax_len
.
- Type Number uses
-
max_date_iso
Alias ofdate_iso_max
. -
max_date_euro_long
Alias ofdate_euro_long_max
. -
max_date_euro_short
Alias ofdate_euro_short_max
. -
max_date_us_long
Alias ofdate_us_long_max
. -
max_date_us_short
Alias ofdate_us_short_max
. -
max_len:n
Checks field length, no longer than specified length where (n) is length parameter. -
max_length:n
Alias ofmax_len
-
max_num:n
Checks numeric value to be lower or equal than the number (n). -
min:n
Will auto-detect value type then use proper validator.- Type Number uses
min_num
, String usemin_len
.
- Type Number uses
-
min_date_iso
Alias ofdate_iso_min
. -
min_date_euro_long
Alias ofdate_euro_long_min
. -
min_date_euro_short
Alias ofdate_euro_short_min
. -
min_date_us_long
Alias ofdate_us_long_min
. -
min_date_us_short
Alias ofdate_us_short_min
. -
min_len:n
Checks field length, no shorter than specified length where (n) is length parameter. -
min_length:n
Alias ofmin_len
-
min_num:n
Checks numeric value to be higher or equal than the number (n). -
not_in
Alias ofnot_in_list
-
not_in_list:foo,bar,..
Ensures the value is included inside the given list of values. The list must be separated by ',' and also accept words with spaces for example "ice cream". -
numeric
Only positive numeric value (float, integer). -
numeric_signed
Only numeric value (float, integer) can also be signed (-/+). -
pattern
Ensure it follows a regular expression pattern... Refer to Wiki - Regular Expression Pattern on how to use it. -
phone
Check for a valid phone number (Canada/US) -
phone_international
Check for a valid international phone number -
range
Alias ofbetween
-
required
Ensures the specified key value exists and is not empty -
same
Alias ofmatch
. -
size
Will auto-detect value type then use proper validator.- Type Number uses
exact_num
, String useexact_len
.
- Type Number uses
-
string_len
Alias ofbetween_len
-
string_length
Alias ofbetween_len
-
time
Ensure time follows the format of (hh:mm) or (hh:mm:ss) -
url
Check for valid URL or subdomain
Contents
- Angular-Validation Wiki
- Installation
- Demo
- Code Samples
- Functionalities
- Custom Validations
- Properties & Options
- Validators
- Tests
- Misc