Skip to content

joaobsjunior/ValidaForm

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

59 Commits
 
 
 
 
 
 
 
 

Repository files navigation

ValidaForm

O melhor script de validação de formulários

O validaform é um script que foi feito para facilitar a vida do Front-End e Back-End, pois possui suporte à bootstrap, AJAX, Bootstrap Select (Select Personalizado), dentre outras.

Instalação

O validaform.js deve ficar no final do <body> e após o jQuery:

	<script type="text/javascript" src="//ajax.googleapis.com/ajax/libs/jquery/1/jquery.min.js"></script>
	<script type="text/javascript" src="js/validaform.js"></script>

Não é necessário realizar nenhuma chamada para o script funcionar

Como utilizar

Na tag <form>, você deve informar os seguintes atribulos:
Requerido Atribulos Valor Descrição
[requerido] method POST/GET Este é o tipo método utilizado para enviar as informações do formulário
opcional class ajax Se quiser enviar o formulário utilizando via AJAX
[requerido]
se possui class "ajax"
data-elsend <seletor de elemento> Utilize o seletor do elemento para informar qual o elemento que irá mostrar quando o formulário estiver sendo enviado via AJAX.
Exemplo: data-elsend="#id_div"
[requerido] data-bootstrap <boolean> Se o formulário for no formato bootstrap setar como "true" senão "false"
[requerido]
se possui class "ajax"
data-elsuccess <seletor de elemento> Utilize o seletor do elemento para informar qual o elemento que irá mostrar o conteúdo que irá ser retornado da requisição AJAX.
Exemplo: data-elsuccess="#id_div"
opcional data-callback <função> Utilize se deseja criar um callback para ser executado quando finalizar o envio.
Funciona apenas via AJAX
Exemplo: data-callback="name_function()"
[requerido]
se data-bootstrap for "false"
data-elvalidate <seletor de elemento> Utilize o seletor do elemento para informar qual o elemento que irá mostrar as mensagens de validação Para data-bootstrap="false"
Exemplo: data-elvalidate="#id_div"
[requerido] data-scroll <boolean> Se o formulário tera um scroll automático para o campo validado setar como "true" senão "false"
Na tag <input | select | textarea>, você deve informar os seguintes atributos:
Atributo Valor Descrição
type <email | text | password | file> Tipo do campo
class <timer (hora) | phone (telefone) | cnpj | cpf | data | cep | so-numero | so-texto | moeda | no-blocked> Classes CSS que serão tratadas pelo script, gerando máscaras, retringindo caracteres e validado os dados
required <atributo html5> Setando o campo como obrigatório
data-msgrequired <string> Texto que será apresentado caso o input seja obrigatório e não estiver preenchido
data-msgvalidate <string> Texto que será apresentado caso o input seja preenchido mas não corresponda as prerequisitos do tipo informado
maxlength <atributo html5> Determinando o tamanho máximo do campo.
data-minlength <inteiro> Determinando o mínimo de caracteres do campo.
data-msgequals <string> Texto que será apresentado caso os inputs do tipo email | password com o mesmo name não estejam com valores iguais.
data-cript <array> Relação das criptografias (md5 e sha1) utilizadas para o campo do tipo password.
Exemplo: data-cript="md5, sha1, sha1". Executará assim: sha1(sha1(md5("valor")))
data-extencoes <array> Relação das extenções permitidas para o arquivo.
Exemplo: data-extencoes=".jpg, .png, .pdf"
data-typesize opcional <string> Tipo do tamanho do arquivo, podendo ser MB ou KB. Exemplo: data-typesize="MB". Default: KB
data-maxsize opcional <string> Tamanho máximo do arquivo carregado. O tamanho é baseado no data-typesize

Para cada input do tipo file, deverá ser criado no formulário um input do tipo text onde mostrará o endereço do arquivo, com o mesmo attributo name, somente acrescido de "txt".
Exemplo:

<input type="file" name="arquivo" > 
<input type="text" name="arquivotxt" >

About

Script de validação de formulário

Resources

License

Stars

Watchers

Forks

Packages

No packages published