miércoles, 12 de abril de 2017

Referencia de validadores

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