用JavaScript操作表单和操作DOM是类似的，因为表单本身也是DOM树。

不过表单的输入框、下拉框等可以接收用户输入，所以用JavaScript来操作表单，可以获得用户输入的内容，或者对一个输入框设置新的内容。

HTML表单的输入控件主要有以下几种：

  • 文本框，对应的，用于输入文本；
  • 口令框，对应的，用于输入口令；
  • 单选框，对应的，用于选择一项；
  • 复选框，对应的，用于选择多项；
  • 下拉框，对应的，用于选择一项；
  • 隐藏文本，对应的，用户不可见，但表单提交时会把隐藏文本发送到服务器。

获取值

如果我们获得了一个节点的引用，就可以直接调用value获得对应的用户输入值：

  1. // <input type="text" id="email">
  2. let input = document.getElementById('email');
  3. input.value; // '用户输入的值'

这种方式可以应用于text、password、hidden以及select。但是，对于单选框和复选框，value属性返回的永远是HTML预设的值，而我们需要获得的实际是用户是否“勾上了”选项，所以应该用checked判断：

  1. // <label><input type="radio" name="weekday" id="monday" value="1"> Monday</label>
  2. // <label><input type="radio" name="weekday" id="tuesday" value="2"> Tuesday</label>
  3. let mon = document.getElementById('monday');
  4. let tue = document.getElementById('tuesday');
  5. mon.value; // '1'
  6. tue.value; // '2'
  7. mon.checked; // true或者false
  8. tue.checked; // true或者false

设置值

设置值和获取值类似，对于text、password、hidden以及select，直接设置value就可以：

  1. // <input type="text" id="email">
  2. let input = document.getElementById('email');
  3. input.value = 'test@example.com'; // 文本框的内容已更新

对于单选框和复选框，设置checked为true或false即可。

HTML5控件

HTML5新增了大量标准控件，常用的包括date、datetime、datetime-local、color等，它们都使用标签：

  1. <input type="date" value="2021-12-02">
  1. <input type="datetime-local" value="2021-12-02T20:21:12">
  1. <input type="color" value="#ff0000">

不支持HTML5的浏览器无法识别新的控件，会把它们当做type="text"来显示。支持HTML5的浏览器将获得格式化的字符串。例如，type="date"类型的input的value将保证是一个有效的YYYY-MM-DD格式的日期，或者空字符串。

提交表单

最后，JavaScript可以以两种方式来处理表单的提交（AJAX方式在后面章节介绍）。

方式一是通过

元素的submit()方法提交一个表单，例如，响应一个的click事件，在JavaScript代码中提交表单：

  1. <!-- HTML -->
  2. <form id="test-form">
  3.     <input type="text" name="test">
  4.     <button type="button" onclick="doSubmitForm()">Submit</button>
  5. </form>
  7. <script>
  8. function doSubmitForm() {
  9.     let form = document.getElementById('test-form');
  10.     // 可以在此修改form的input...
  11.     // 提交form:
  12.     form.submit();
  13. }
  14. </script>

这种方式的缺点是扰乱了浏览器对form的正常提交。浏览器默认点击时提交表单，或者用户在最后一个输入框按回车键。因此，第二种方式是响应

本身的onsubmit事件，在提交form时作修改：

  1. <!-- HTML -->
  2. <form id="test-form" onsubmit="return checkForm()">
  3.     <input type="text" name="test">
  4.     <button type="submit">Submit</button>
  5. </form>
  7. <script>
  8. function checkForm() {
  9.     let form = document.getElementById('test-form');
  10.     // 可以在此修改form的input...
  11.     // 继续下一步:
  12.     return true;
  13. }
  14. </script>

注意要return true来告诉浏览器继续提交，如果return false，浏览器将不会继续提交form，这种情况通常对应用户输入有误，提示用户错误信息后终止提交form。

在检查和修改时，要充分利用来传递数据。

例如，很多登录表单希望用户输入用户名和口令，但是，安全考虑，提交表单时不传输明文口令，而是口令的MD5。普通JavaScript开发人员会直接修改：

  1. <!-- HTML -->
  2. <form id="login-form" method="post" onsubmit="return checkForm()">
  3.     <input type="text" id="username" name="username">
  4.     <input type="password" id="password" name="password">
  5.     <button type="submit">Submit</button>
  6. </form>
  8. <script>
  9. function checkForm() {
  10.     let pwd = document.getElementById('password');
  11.     // 把用户输入的明文变为MD5:
  12.     pwd.value = toMD5(pwd.value);
  13.     // 继续下一步:
  14.     return true;
  15. }
  16. </script>

这个做法看上去没啥问题，但用户输入了口令提交时，口令框的显示会突然从几个*变成32个*（因为MD5有32个字符）。

要想不改变用户的输入，可以利用实现：

  1. <!-- HTML -->
  2. <form id="login-form" method="post" onsubmit="return checkForm()">
  3.     <input type="text" id="username" name="username">
  4.     <input type="password" id="input-password">
  5.     <input type="hidden" id="md5-password" name="password">
  6.     <button type="submit">Submit</button>
  7. </form>
  9. <script>
  10. function checkForm() {
  11.     let input_pwd = document.getElementById('input-password');
  12.     let md5_pwd = document.getElementById('md5-password');
  13.     // 把用户输入的明文变为MD5:
  14.     md5_pwd.value = toMD5(input_pwd.value);
  15.     // 继续下一步:
  16.     return true;
  17. }
  18. </script>

注意到id为md5-password的标记了name="password"，而用户输入的id为input-password的没有name属性。没有name属性的的数据不会被提交。

练习

利用JavaScript检查用户注册信息是否正确，在以下情况不满足时报错并阻止提交表单：

  1. <!-- HTML结构 -->
  2. <form id="test-register" action="#" target="_blank" onsubmit="return checkRegisterForm()">
  3.     <p id="test-error" style="color:red"></p>
  4.     <p>
  5.         用户名: <input type="text" id="username" name="username">
  6.     </p>
  7.     <p>
  8.         口令: <input type="password" id="password" name="password">
  9.     </p>
  10.     <p>
  11.         重复口令: <input type="password" id="password-2">
  12.     </p>
  13.     <p>
  14.         <button type="submit">提交</button> <button type="reset">重置</button>
  15.     </p>
  16. </form>
用户名: 口令: 重复口令: 
  1. window.checkRegisterForm = function () {
  2.     // TODO:
  3.     return false;
  4. };
  6. // 测试:
  7. (function () {
  8.     window.testFormHandler = window.checkRegisterForm;
  9.     let form = document.getElementById('test-register');
  10.     if (form.dispatchEvent) {
  11.         let event = new Event('submit', {
  12.             bubbles: true,
  13.             cancelable: true
  14.           });
  15.         form.dispatchEvent(event);
  16.     } else {
  17.         form.fireEvent('onsubmit');
  18.     }
  19. })();

[TOC]