oziAuth
Versão: 2.2.4 — Atualizado em: 2026-04-25
Descrição
Plugin de validação de formulários de autenticação. Concentra as regras de senha, e-mail e confirmação em um motor isolado — oziAuth() — e aplica feedback visual em tempo real nos campos, lista de regras e botão de envio, orientando o usuário a seguir a ordem correta de preenchimento.
Exemplos
[1] Formulário completo com lista de regras
<input type="email" name="email"
data-ozi-auth-mail
class="form-control"
placeholder="E-mail">
<input type="password" name="senha"
data-ozi-auth-pass="bi bi-eye-slash,bi bi-eye"
class="form-control"
placeholder="Senha">
<input type="password" name="confirma"
data-ozi-auth-confirm="bi bi-eye-slash,bi bi-eye"
class="form-control"
placeholder="Confirmar senha">
<div id="regrasSenha"></div>
<button type="submit"
data-ozi-auth-submit
data-ozi-auth-list-id="regrasSenha"
data-ozi-auth-check="bi bi-circle,bi bi-check2-circle"
class="btn btn-secondary"
disabled>
Salvar
</button>
[2] Com dropdown de regras
<input type="password" name="senha"
data-ozi-auth-pass="bi bi-eye-slash,bi bi-eye"
class="form-control">
<button type="submit"
data-ozi-auth-submit
data-ozi-auth-dropdown
class="btn btn-secondary"
disabled>
Salvar
</button>
[3] Com campo de usuário
<input type="text" name="usuario"
data-ozi-auth-user
data-ozi-auth-user-caracter="4"
class="form-control"
placeholder="Nome de usuário">
[4] Lista + Dropdown simultâneos
<button type="submit"
data-ozi-auth-submit
data-ozi-auth-list-id="regrasSenha"
data-ozi-auth-dropdown
class="btn btn-secondary"
disabled>
Salvar
</button>
<div id="regrasSenha"></div>
[5] Motor de validação via JavaScript
Use oziAuth() de forma isolada para validar programaticamente:
const result = oziAuth({
mail: 'user@email.com',
password: 'Senha@123',
confirm: 'Senha@123',
userCaracter: 4
});
if (result.access) {
console.log('✔ Tudo válido — pode enviar!');
} else {
console.log('✘ Erros:', result);
}
Recursos
- Motor isolado —
oziAuth() valida sem depender do DOM
- Feedback em tempo real — regras atualizadas a cada tecla
- Toggle show/hide — ícones customizáveis nos campos de senha
- Lista de regras — renderizada em container configurável
- Dropdown de regras — exibido ao focar no campo de senha
- Badge de contagem — exibe progresso em tempo real (
6/14 · faltam 2)
- Ordem de preenchimento — e-mail validado ao digitar a senha
- Ícones customizáveis — estados válido/inválido configuráveis
Atributos HTML
[1] Campos
| Atributo |
Descrição |
data-ozi-auth-mail |
Campo de e-mail — valida formato e bloqueia partes do e-mail na senha |
data-ozi-auth-pass="iconShow,iconHide" |
Campo de senha — ativa toggle show/hide |
data-ozi-auth-confirm="iconShow,iconHide" |
Campo de confirmação — ativa toggle show/hide |
data-ozi-auth-user |
Campo de usuário — valida comprimento mínimo |
data-ozi-auth-user-caracter |
Mínimo de caracteres para o campo usuário |
[2] Feedback Visual
| Atributo |
Descrição |
data-ozi-auth-submit |
Botão de envio — ativado/desativado conforme validação |
data-ozi-auth-list-id="id" |
ID do container onde a lista de regras será renderizada |
data-ozi-auth-dropdown |
Ativa dropdown de regras nos campos de senha |
data-ozi-auth-check="iconInvalid,iconValid" |
Ícones para os estados de regra — ex: bi bi-circle,bi bi-check2-circle |
data-ozi-auth-class="classes" |
Substitui a classe padrão no botão show/hide |
[3] Regras de Exibição
| Configuração |
Comportamento |
Só data-ozi-auth-submit |
Exibe dropdown por padrão |
Só data-ozi-auth-list-id |
Exibe lista no container indicado |
Só data-ozi-auth-dropdown |
Exibe dropdown |
data-ozi-auth-list-id + data-ozi-auth-dropdown |
Lista + dropdown simultâneos |
Validações
Usuário
- Comprimento mínimo definido por
data-ozi-auth-user-caracter
E-mail
- Formato válido:
nome@dominio.com
Senha
| Regra |
Descrição |
| Comprimento |
Entre 8 e 14 caracteres — badge em tempo real |
| Minúscula |
Mínimo 1 letra minúscula |
| Maiúscula |
Mínimo 1 letra maiúscula |
| Número |
Mínimo 1 número |
| Especial |
Mínimo 1 caractere especial |
| Sem espaços |
Não pode conter espaços |
| Sem partes do e-mail |
Não pode conter prefixo ou domínio do e-mail |
Confirmação
- Deve ser idêntica à senha
Badge de Contagem
A regra passLength exibe progresso em tempo real:
| Estado |
Exibição |
| Sem digitação |
0/14 |
| Dentro do limite |
6/14 · faltam 2 |
| Limite atingido |
8/14 |
| Excedido |
15/14 · excedido |
Retorno do motor oziAuth()
{
userValid: true, // usuário com mínimo de caracteres
mailValid: true, // e-mail em formato válido
passLength: true, // entre 8 e 14 caracteres
passLowercase: true, // tem letra minúscula
passUppercase: true, // tem letra maiúscula
passNumber: true, // tem número
passSpecial: true, // tem caractere especial
passNoSpace: true, // sem espaços
passNoEmailParts: true, // senha não contém partes do e-mail
passConfirm: true, // confirmação igual à senha
access: true // true somente se todas as regras forem atendidas
}
API Pública
| Método |
Descrição |
window.oziAuth(data) |
Motor de validação isolado |
window.oziAuthInit($scope) |
Inicializa em um escopo |
window.oziAuthInitFetched(root) |
Reinicializa após render dinâmico |
Uso com conteúdo dinâmico
// Após inserir HTML no DOM
window.oziAuthInitFetched($('#destino')[0]);
// Ou via evento
$(document).trigger('oziAuth:initFetched', [rootElement]);