Créateur de formulaires
Un outil dynamique de création de formulaires qui permet aux utilisateurs de créer, de personnaliser et de valider les formulaires de manière transparente dans les applications Web. Construit avec React, Next.js et diverses autres technologies, Form Builder fournit une interface intuitive pour les développeurs et les utilisateurs.
Table des matières
- Créateur de formulaires
- Table des matières
- Caractéristiques
- Démo en direct
- Démo youtube
- Installation
- Usage
- Composants
- Validation
- API
- Contributif
- Licence
- Remerciements
Caractéristiques
- Création de formulaire dynamique : créez facilement des formulaires avec divers types d'entrée, y compris le texte, la case à cocher, les boutons radio, etc.
- Validation en temps réel : valider les entrées utilisateur à l'aide de la bibliothèque ZOD, assurer l'intégrité des données et les commentaires conviviaux.
- Conception réactive : construite avec CSS de vent arrière, garantissant que les formulaires ont fière allure sur tous les appareils.
- Composants personnalisables : tirez parti des composants Shadcn pour une expérience d'interface utilisateur cohérente et moderne.
- Rendu côté serveur : utilisez Next.js pour des performances optimisées et un référencement.
Démo en direct
Découvrez la démo en direct du constructeur de formulaires ici.
Démo youtube
Installation
Pour commencer avec Form Builder, suivez ces étapes:
Clone le référentiel:
git clone https://github.com/hasanharman/form-builder.git
Naviguer dans le répertoire du projet:
Installez les dépendances nécessaires:
Usage
Pour démarrer le serveur de développement, exécutez:
Ouvrez votre navigateur et accédez à http://localhost:3000 pour voir l'application en action.
Créer une forme
- Accédez au constructeur : une fois l'application en cours d'exécution, accédez à l'interface de générateur de formulaire.
- Ajoutez des entrées : utilisez la barre d'outils pour ajouter différents types d'entrées.
- Personnalisez les entrées : cliquez sur n'importe quel champ de saisie pour configurer des propriétés telles que l'étiquette, l'espace réservé, la validation requise, etc.
- Enregistrer et prévisualiser : une fois votre formulaire construit, enregistrez-le et prévisualisez la sortie.
Composants
Le constructeur de formulaires se compose de divers composants réutilisables:
- FormContainer : Le conteneur principal des éléments de forme.
- Inputfield : un composant d'entrée personnalisable.
- SELECTFIELD : composant de sélection déroulant.
- CheckboxField : un composant d'entrée à cocher.
- Bouton : un composant de bouton stylé pour la soumission de formulaire.
Validation
Form Builder utilise ZOD pour la validation d'entrée. Vous pouvez définir des schémas pour vos formulaires comme suit:
import { z } from 'zod' ;
const formSchema = z . object ( {
name : z . string ( ) . min ( 1 , "Name is required" ) ,
email : z . string ( ) . email ( "Invalid email address" ) ,
age : z . number ( ) . min ( 18 , "You must be at least 18 years old" ) ,
} ) ; Ce schéma peut être appliqué à votre formulaire pour appliquer les règles de validation.
API
Soumission de formulaire
Une fois votre formulaire prêt, vous pouvez gérer les soumissions avec un appel API simple. Voici un exemple de la façon de soumettre les données du formulaire:
const handleSubmit = async ( data ) => {
try {
const response = await fetch ( '/api/form-submit' , {
method : 'POST' ,
body : JSON . stringify ( data ) ,
headers : {
'Content-Type' : 'application/json' ,
} ,
} ) ;
const result = await response . json ( ) ;
console . log ( 'Form submitted successfully:' , result ) ;
} catch ( error ) {
console . error ( 'Error submitting form:' , error ) ;
}
} ; Contributif
Les contributions sont les bienvenues! Si vous souhaitez contribuer à Form Builder, veuillez suivre ces étapes:
- Fourchez le référentiel : cliquez sur le bouton "Fork" dans le coin supérieur droit de la page du référentiel.
- Créer une branche :
git checkout -b feature/YourFeatureName
- Apporter des modifications : implémentez votre fonctionnalité ou correcte.
- Commettre des changements :
git commit -m " Add a feature "
- Poussez les changements :
git push origin feature/YourFeatureName
- Créez une demande de traction : accédez au référentiel d'origine et créez une demande de traction.
Licence
Ce projet est autorisé sous la licence du MIT.
Remerciements
- React - Une bibliothèque JavaScript pour la construction d'interfaces utilisateur.
- Next.js - Le cadre React pour la production.
- Tailwind CSS - Un framework CSS-First utilitaire pour la création de conceptions personnalisées.
- ZOD - DÉCLARATION ET VALIDATION SCHEMA-FIRST-FIRST.