Skip to content

Componente Vue 3 para validação reativa de formulários, facilitando a criação de formulários dinâmicos e interativos com regras de validação personalizáveis.

Notifications You must be signed in to change notification settings

marlon-bento/v-required

Repository files navigation

Documentação v-required

npm version License: MIT Built with TypeScript

js-icon

Elimine a repetição de validações manuais nos seus projetos Vue.js. O v-required oferece uma abordagem declarativa, automatizada e escalável para gerenciar validações de campos de formulário.


🚀 O que é o v-required?

v-required é uma diretiva Vue 3 pensada para facilitar o gerenciamento de validações de formulários. Ela automatiza tarefas comuns como:

  • Validação de campos obrigatórios
  • Exibição de mensagens de erro
  • Estilização visual de campos inválidos
  • Scroll automático até o primeiro erro

Tudo isso com mínima configuração e foco em manutenibilidade e legibilidade do código.


🎯 Quando usar?

Este projeto é ideal para aplicações Vue 3 que precisam de:

  • Gerenciamento centralizado de validações
  • Scroll automático ao primeiro campo inválido
  • Código mais limpo e padronizado
  • Baixo acoplamento entre regras de validação e visualização

🔧 Como funciona?

A diretiva v-required age como uma camada de abstração para validações em formulários Vue. Ela utiliza os recursos do Vue de forma reativa, mantendo o controle visual e funcional dos inputs.

Benefícios:

  • Não é intrusiva
  • Usa refs, eventos e listeners do Vue
  • Permite personalização por classes
  • Torna fácil estender para regras mais complexas

📚 Sumário


📦 Instalação

Instalar a biblioteca

npm install v-required

Instanciar a diretiva

import vRequired from "v-required"
import { createApp } from 'vue'

const app = createApp(App)

// adicionar a diretiva v-required
app.directive("required", vRequired);

app.mount('#app')

About

Componente Vue 3 para validação reativa de formulários, facilitando a criação de formulários dinâmicos e interativos com regras de validação personalizáveis.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •