Validaciones disponibles:
DjValidator posee por defecto las siguientes claves de validación, que se deben colocar como Strings dentro del atributo data-dj-validator , a excepción de validar un campo obligatorio que reconoce el atributo required de HTML5.
Validación
|
clave
|
Parámetros
|
Descripción
|
Campo obligatorio
|
Se usa el atributo “required” de
HTML5
|
-----
|
El campo no debe estar vacío ni contener solo espacios, es
obligatorio.
|
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 (*).
|
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 la longitud del texto. El tamaño máximo se puede omitir (*).
|
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 la longitud del texto. El tamaño máximo se puede omitir (*).
|
Una 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 la
longitud del texto. El tamaño máximo se puede omitir (*).
|
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 su longitud. El tamaño
máximo se puede omitir (*).
|
Solo 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 el valor del entero. El valor máximo y/o mínimo se pueden omitir
(*).
|
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 el valor del número. El valor
máximo y/o mínimo se pueden omitir (*).
|
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 el tamaño máximo de forma opcional (*).
|
Dirección web (url)
|
url,[max]
|
max: máximo de caracteres permitidos.
|
Acepta URLs validas de los protocolos HTTP, HTTPS, FTP y FTPS;
validando también el tamaño máximo de forma opcional (*).
|
Número telefónico
|
phone
|
-----
|
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 debe tener de 5 a 12 dígitos.
|
Validar archivos
|
file,[min],[max],[min_size],[max_size],[type1|type2....]
|
min: cantidad mínima de archivos seleccionados.
max: cantidad máxima de archivos seleccionados.
min_size: Tamaño mínimo de los archivos seleccionados.
max_size: Tamaño máximo de los archivos seleccionados.
type1|type2....: Tipos mime permitidos.
|
Valida inputs de tipo file 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 los archivos seleccionados que también se
pueden omitir (*) y finalmente valida
el tipo de archivo siguiendo los tipos mime especificados como array
(requiere al menos uno).
|
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 (debe haber al menos una), se puede usar de
manera más sencilla y cuando no se disponga el API file de javascript.
|
Dirección IP
|
Ip,[type]
|
type(opcional): ipv4 o ipv6
|
Acepta direcciones IP que pueden ser v4, v6 dependiendo del parámetro
especificado, si no se especifica se validan v4 o v6.
|
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 select multiple,
el máximo se puede omitir (*).
|
Botones de radio
|
radio
|
-----
|
Valida la selección obligatoria de un botón de radio de un grupo de
radios (con el mismo name).
|
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.
max(opcional): máximo de casillas marcadas.
label(opcional):
Nombre del grupo de casillas a mostrar.
|
Sin parámetros valida que la casilla este seleccionada (obligatoria).
Especificando todos los parámetros valida el marcado de un grupo de
casillas definido (atributo data-dj-validator-group), el máximo de opciones
se puede omitir (*), el parámetro [label] es solo para mostrar el mensaje.
|
Campos iguales
|
equal,[id],[label]
|
id: id del input a comparar.
Label: Nombre a mostrar de los campos. |
Valida que el valor del campo sea igual al especificado, el [id] debe
ser del campo (otro) con el que se desea comparar.
|
Campos diferentes
|
nequal,[id],[label]
|
id: id del input a comparar.
Label: Nombre a mostrar de los campos. |
Valida que el valor del campo sea diferente al especificado, el [id]
debe ser del campo (otro) con el que se desea comparar.
|
Campos opcionales
|
or,[group],[label]
|
group: Nombre del grupo de campos (atributo data-dj-validator-group).
Label: Nombre a mostrar de los campos.
|
Valida que al menos uno de los campos del grupo no este vacío (grupo
obligatorio), el parámetro [label] es solo para mostrar el mensaje.
|
Validar una expresión regular
|
regexp,[
regular_expresion],[ flags]
|
regular_expresion: expresión regular.
Flags(opcional): flags de la expresión regular.
|
Acepta el valor de un campo de acuerdo con la expresión regular
especificada, el formato de la expresión y las flags (se especifican por
separado) deben ser como cadenas (para usarse con el constructor del objeto RegExp).
Si la expresión regular lleva comas, estas se deben reemplazar por: ° para evitar errores (v1.1.0). |
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.
|
No hay comentarios:
Publicar un comentario