storage form

storage-form

Un composant Web qui vous permet de soumettre des données au stockage local.

Démo | Dès la lecture

Exemples

Exemple d'utilisation générale:

 < script type =" module " src =" storage-form.js " > </ script >

< storage-form >
  < form >
    < label >
      Example
      < input type =" text " name =" example " value =" value " />
    </ label >
    < button > Submit </ button >
  </ form >
</ storage-form >

Exemple de soumission avec l'événement change au lieu d'un bouton de soumission. Cas d'utilisation pour le mode clair / sombre:

 < script type =" module " src =" storage-form.js " > </ script >

< storage-form >
  < form >
    < label >
      < input type =" radio " name =" theme " value =" dark " />
      < span > Dark mode </ span >
    </ label >
    < label >
      < input type =" radio " name =" theme " value =" light " />
      < span > Light mode </ span >
    </ label >
    < label >
      < input type =" radio " name =" theme " value ="" checked />
      < span > Default mode </ span >
    </ label >
    < br />
    < label >
      < input type =" hidden " name =" contrast " value />
      < input type =" checkbox " name =" contrast " value =" true " />
      < span > High contrast </ span >
    </ label >
  </ form >
</ storage-form >

Exemple de connexion dans l'événement storage :

 < script type =" module " src =" storage-form.js " > </ script >

< storage-form >
  < form >
    < label >
      Update the
      < code > output </ code >
      by checking the box
      < input type =" hidden " name =" output " value />
      < input type =" checkbox " name =" output " value =" updated " />
    </ label >
  </ form >
</ storage-form >

< output > </ output >
< script >
  const updatePage = ( ) => {
    document . querySelector ( "output" ) . innerHTML = JSON . stringify (
      window . localStorage
    ) ;
  } ;
  window . addEventListener ( "storage" , updatePage ) ;
  updatePage ( ) ;
</ script > 

Caractéristiques

Ce composant Web vous permet de:

• Utilisez des éléments de formulaire réguliers pour manipuler les données dans le stockage local
• Invoquez un événement storage sur la page pour vous connecter ailleurs sur la page
• Maintenir l'état des formulaires, en utilisant le stockage local, lorsque la page est actualisée ou rechargée
• Soumettre éventuellement le formulaire sur l'événement change des formulaires en omettant le bouton / élément de saisie de soumission des formulaires

Installation

Vous avez quelques options (choisissez-en une):

1. Installer via NPM: npm install @daviddarnes/storage-form
2. Téléchargez la source manuellement à partir de GitHub dans votre projet.
3. Ignorez cette étape et utilisez le script directement via un CDN tiers (non recommandé pour une utilisation en production)

Usage

Assurez-vous d'inclure le <script> dans votre projet (choisissez-en un):

 <!-- Host yourself -->
< script type =" module " src =" storage-form.js " > </ script > 

 <!-- 3rd party CDN, not recommended for production use -->
< script
  type =" module "
  src =" https://www.unpkg.com/@daviddarnes/[email protected]/storage-form.js "
> </ script > 

 <!-- 3rd party CDN, not recommended for production use -->
< script
  type =" module "
  src =" https://esm.sh/@daviddarnes/[email protected] "
> </ script > 

Crédit

Merci aux personnes suivantes:

• Zach Leatherman pour avoir inspiré ce modèle de repo composant Web
• Nathan Knowler pour avoir proposé une solution à la méthode updateForm()