storage form

storage-form

允许您将数据提交到本地存储的Web组件。

演示|进一步阅读

例子

一般用法示例：

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

提交change事件而不是提交按钮的示例。光/黑模式的用例：

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

连接到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 > 

特征

此Web组件允许您：

• 使用常规表单元素在本地存储中操纵数据
• 调用页面上的storage事件以将页面上的其他位置挂钩
• 刷新或重新加载页面时，使用本地存储保持表单状态
• 可选地通过省略表单提交按钮/输入元素在表单上change事件的表单提交表单

安装

您有一些选择（选择其中之一）：

1. 通过NPM安装： npm install @daviddarnes/storage-form
2. 从Github手动下载源到您的项目。
3. 跳过此步骤，直接通过第三方CDN使用脚本（不建议用于生产使用）

用法

确保在项目中包括<script> （选择其中之一）：

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

信用

感谢以下人员：

• 扎克·莱瑟曼（Zach Leatherman）启发此Web组件回购模板
• 内森·诺尔勒（Nathan Knowler）为updateForm()方法提出解决方案