Validaciones disponibles


El plugin cuenta con las siguientes reglas de validación incorpordas, que deben usarse dentro del atributo data-dj-validator:


Campo obligatorio

Se usa el atributo “required” de HTML5 para verificar que el campo no este vacío ni contenga solo espacios:

<input type="text" required=”required”/>

Validar textos:

VALIDACIÓN

CLAVE

PARÁMETROS

DESCRIPCIÓN

EJEMPLOS

Cualquier texto

text,[min],[max]

min: mínimo de caracteres permitidos.
max: máximo de caracteres permitidos.

Acepta cualquier carácter, validando solo la longitud del texto. El tamaño máximo se puede omitir (*).

data-dj-validator="text,3,12"
data-dj-validator="text,3,*"

Texto alfabético

atext,[min],[max]

min: mínimo de caracteres permitidos.
max: máximo de caracteres permitidos.

Acepta caracteres alfabéticos en mayúsculas y minúsculas, incluyendo espacios, la letra ñ y los caracteres acentuados (á, é, í, ó, ú, ç, ü), validando también la longitud del texto. El tamaño máximo se puede omitir (*).

 data-dj-validator="atext,3,12"
data-dj-validator="atext,3,*"

Texto alfabético y dígitos

antext,[min],[max]

min: mínimo de caracteres permitidos.
max: máximo de caracteres permitidos.

Acepta dígitos y caracteres alfabéticos en mayúsculas y minúsculas, incluyendo espacios, la letra ñ y los caracteres acentuados (á, é, í, ó, ú, ç, ü), validando también la longitud del texto. El tamaño máximo se puede omitir (*).

 data-dj-validator="antext,3,12"
data-dj-validator="antext,3,*"

Palabra (texto sin espacios)

word,[min],[max]

min: mínimo de caracteres permitidos.
max: máximo de caracteres permitidos.

Acepta cualquier carácter exceptuando los espacios, validando también la longitud del texto. El tamaño máximo se puede omitir (*).

 data-dj-validator="word,4,8"
data-dj-validator="word,4,*"

Solo dígitos

dig,[min],[max]

min: mínimo de dígitos permitidos.
max: máximo de dígitos permitidos.

Acepta un texto de solo dígitos, validando la longitud de la cadena de dígitos. El tamaño máximo se puede omitir (*).

 data-dj-validator="dig,4,8"
data-dj-validator="dig,4,*"

Validar campos numéricos

VALIDACIÓN

CLAVE

PARÁMETROS

DESCRIPCIÓN

EJEMPLOS

Números enteros

int,[min],[max]

min: valor mínimo permitido.
max: valor máximo permitido.

Acepta solo números enteros positivos o negativos (acepta el signo -), validando también el valor del número entero. El valor máximo y/o mínimo del número se pueden omitir (*).

 data-dj-validator="int,1,*"
data-dj-validator="int,*,100"
data-dj-validator="int,*,*"
data-dj-validator="int,-100,-1"

Números reales

num,[min],[max]

min: valor mínimo permitido.
max: valor máximo permitido.

Acepta cualquier tipo de número real, usando el punto (.) como separador decimal, acepta el signo -, validando también el valor del número. El valor máximo y/o mínimo se pueden omitir (*).

 data-dj-validator="num,1,*"
data-dj-validator="num,*,10.5"
data-dj-validator="num,*,*"
data-dj-validator="num,-1.5,1.5"

Validaciones comunes

VALIDACIÓN

CLAVE

PARÁMETROS

DESCRIPCIÓN

EJEMPLOS

Dirección de correo electrónico

email,[max]

max: máximo de caracteres permitidos.

Acepta direcciones de correo electrónico validas de cualquier nivel de dominio, validando también la cantidad máxima de caracteres de forma opcional (*).

 data-dj-validator="email,30"
data-dj-validator="email,*"

Dirección web (url)

url,[max]

max: máximo de caracteres permitidos.

Acepta URLs de los protocolos HTTP, HTTPS, FTP y FTPS, validando también la cantidad máxima de caracteres de forma opcional (*).

 data-dj-validator="url,50"
data-dj-validator="url,*"

Número telefónico

phone

NINGUNO

Acepta números telefónicos, bajo los siguientes formatos:
+591 70229728
70229728
El signo + es opcional, el separador puede ser espacio o -, el código puede tener de 2 a 3 dígitos y el número puede tener de 5 a 12 dígitos.

 data-dj-validator="phone"

Dirección IP

Ip,[type]

type(opcional): ipv4 o ipv6

Acepta direcciones IP que pueden ser v4 o v6 dependiendo del parámetro especificado, si no se especifica verifica ambas.

 data-dj-validator="ip"
data-dj-validator="ip,v4"
data-dj-validator="ip,v6"

Validar archivos

VALIDACIÓN

CLAVE

PARÁMETROS

DESCRIPCIÓN

EJEMPLOS

Validar archivos

file,[min],[max],[min_size],[max_size],[type1|type2..]

min: cantidad mínima de archivos a seleccionar.
max: cantidad máxima de archivos a seleccionar
min_size: Tamaño mínimo de los archivos seleccionados (kb).
max_size: Tamaño máximo de los archivos seleccionados(kb).
type1|type2..: Tipos mime permitidos.

Valida archivos en base al API file de javascript (si no está disponible no se realiza la validación), estableciendo el mínimo y máximo de archivos seleccionados donde el máximo se puede omitir (*), el tamaño máximo y mínimo en kb. De cada archivo donde ambos se pueden omitir (*) y finalmente valida el tipo de archivo siguiendo los tipos mime especificados como array (se requiere al menos uno).

 data-dj-validator="file,2,4,10,100,
image/jpeg|image/png|image/bmp"
data-dj-validator="file,1,*,1,1000,image/jpeg"
data-dj-validator="file,1,3,*,*,image/jpeg|image/png"

Validar extensiones de archivos

efile,[e1|e2|e3..]

e1|e2|e3..: Extensiones de archivo permitidas

Valida solamente la extensión del archivo seleccionado dentro de la lista de extensiones permitidas (se requiere al menos una), se puede usar de manera más sencilla y cuando no se disponga el API file de javascript.

 data-dj-validator="efile,jpg|jpeg|png|bmp"
data-dj-validator="efile,doc|docx|pdf"

Validación de otros controles de formulario

VALIDACIÓN

CLAVE

PARÁMETROS

DESCRIPCIÓN

EJEMPLOS

Selección múltiple

multi,[min],[max]

min: mínimo de opciones seleccionadas.
max: máximo de opciones seleccionadas.

Valida la cantidad de opciones seleccionadas de un selector múltiple, el máximo se puede omitir (*).

El atributo required es válido para verificar que se haya seleccionado una opción con valor.

 data-dj-validator="multi,2,4"
data-dj-validator="multi,1,*"

Botones de radio

radio

NINGUNO

Valida la selección obligatoria de un botón de radio de un grupo (con el mismo nombre), solo se debe colocar en un radio del grupo (se recomienda en el último)

 data-dj-validator="radio"

Casillas de verificación

check,[group],[min],[max],[label]

group(opcional): Nombre del grupo de casillas (atributo data-dj-validator-group).
min(opcional): mínimo de casillas marcadas del grupo.
max(opcional): máximo de casillas marcadas del grupo.
label(opcional):
Etiqueta del grupo de casillas.

Sin parámetros valida que la casilla este seleccionada (obligatoria).
Especificando todos los parámetros valida el marcado de un grupo de casillas definido (todos los check con el mismo atributo data-dj-validator-group), el máximo de opciones se puede omitir (*), el parámetro [label] solo es la etiqueta de nombre de grupo para el mensaje de validación.

 data-dj-validator="check"
data-dj-validator="check,group,1,2,options"
data-dj-validator="check,group,2,*,options"

Validar campos relacionados

VALIDACIÓN

CLAVE

PARÁMETROS

DESCRIPCIÓN

EJEMPLOS

Campos iguales

equal,[id],[label]

id: id del input a comparar.
Label: Etiqueta para mostrar.

Valida que el valor del campo sea igual al especificado, el [id] debe ser del campo con el que se desea comparar.

La etiqueta se usa para nombrar al otro campo.		 data-dj-validator="equal,a,input a"
donde “a” es el id del otro campo

Campos diferentes

nequal,[id],[label]

id: id del input a comparar.
Label: Etiqueta para mostrar

Valida que el valor del campo sea diferente al especificado, el [id] debe ser del campo con el que se desea comparar.

La etiqueta se usa para nombrar al otro campo.		 data-dj-validator="nequal,a,input a"
donde “a” es el id del otro campo

Campos opcionales

or,[group],[label]

group: Nombre del grupo (campos con el mismo atributo data-dj-validator-group).
Label: Etiqueta para mostrar

Valida que al menos uno de los campos del grupo no este vacío (grupo obligatorio), el parámetro [label] es el nombre del grupo para mostrar el mensaje.
Solo se debe colocar el validador "or" en un input del grupo (se recomienda en el último)

 data-dj-validator="or,optionals,optional inputs"
donde el grupo en cada input es: data-dj-validator-group="optionals"

Validaciones personalizadas

VALIDACIÓN

CLAVE

PARÁMETROS

DESCRIPCIÓN

EJEMPLOS

Validar una expresión regular

regexp,[ regular_expresion],[ flags]

regular_expresion: expresión regular a utilizar.
Flags(opcional): flags de la expresión regular.

Acepta el valor de un campo de acuerdo con la expresión regular especificada y las flags (se especifican por separado), deben estar en forma de cadenas (para usarse con el constructor del objeto RegExp).
Si la expresión regular lleva comas (operador reservado), estas se deben reemplazar por el caracter: ° , para evitar errores.

 data-dj-validator="regexp,^[aeiou]+$,i"
data-dj-validator="regexp,^[aeiou]{3°5}$,i"

Llamar una función de validación propia

call,[function_name]

function_name: nombre de la función validadora.

Llama a una función del usuario para realizar la validación, esta función del usuario recibe el campo a validar ($obj) y debe retornar true o false.

 data-dj-validator="call,isUpperCase"
donde “isUpperCase” es la función del usuario
Revise el apartado validaciones personalizadas para más detalles.

Validaciones en el servidor

Revise el apartado: validaciones en el servidor