Carregando documentação...

oziAuth

Versão: 2.2.4Atualizado 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 isoladooziAuth() 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
data-ozi-auth-submit Exibe dropdown por padrão
data-ozi-auth-list-id Exibe lista no container indicado
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]);