storage form

storage-form

Um componente da Web que permite enviar dados ao armazenamento local.

Demo | Leitura adicional

Exemplos

Exemplo de uso geral:

 < 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 >

Exemplo de envio com o evento change em vez de um botão de envio. Use Case para o modo claro/escuro:

 < 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 >

Exemplo de conexão no evento 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 > 

Características

Este componente da web permite:

• Use elementos regulares de formulário para manipular dados no armazenamento local
• Invoque um evento storage na página para conectar em outros lugares da página
• Mantenha o estado dos formulários, usando o armazenamento local, quando a página estiver atualizada ou recarregada
• Opcionalmente, envie o formulário no evento change dos formulários omitindo o botão enviar o botão de envio/entrada

Instalação

Você tem algumas opções (escolha uma delas):

1. Instale via NPM: npm install @daviddarnes/storage-form
2. Faça o download da fonte manualmente do GitHub em seu projeto.
3. Pule esta etapa e use o script diretamente por meio de um CDN de terceiros (não recomendado para uso da produção)

Uso

Certifique -se de incluir o <script> em seu projeto (escolha um deles):

 <!-- 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édito

Com agradecimento às seguintes pessoas:

• Zach Leatherman para inspirar este modelo de repo componente da web
• Nathan Knowler para propor uma solução para o método updateForm()