我们希望将这个开源项目提供给全世界的人。请帮助我们将教程的内容 翻译为你所掌握的语言 对应的版本。
è´­ä¹°EPUB/PDF
教程路线图
  1. 教程
  2. 浏览器：文档，事件，接口
  3. 表单，控件
2022年8月1日

表单属性和方法

表单（form）以及例如 <input> 的控件（control）元素有许多特殊的属性和事件。

当我们学习了这些相关内容后，处理表单会变得更加方便。

导航：表单和元素

文档中的表单是特殊集合 document.forms 的成员。

这就是所谓的“命名的集合”：既是被命名了的，也是有序的。我们既可以使用名字，也可以使用在文档中的编号来获取表单。

document.forms.my; // name="my" 的表单
document.forms[0]; // 文档中的第一个表单

当我们有了一个表单时，其中的任何元素都可以通过命名的集合 form.elements 来获取到。

例如：

<form name="my">
  <input name="one" value="1">
  <input name="two" value="2">
</form>

<script>
  // 获取表单
  let form = document.forms.my; // <form name="my"> 元素

  // 获取表单中的元素
  let elem = form.elements.one; // <input name="one"> 元素

  alert(elem.value); // 1
</script>

可能会有多个名字相同的元素，这种情况经常在处理单选按钮中出现。

在这种情况下，form.elements[name] 将会是一个集合。例如：

<form>
  <input type="radio" name="age" value="10">
  <input type="radio" name="age" value="20">
</form>

<script>
let form = document.forms[0];

let ageElems = form.elements.age;

alert(ageElems[0]); // [object HTMLInputElement]
</script>

这些导航（navigation）属性并不依赖于标签的结构。所有的控件元素，无论它们在表单中有多深，都可以通过 form.elements 获取到。

Fieldset 作为“子表单”

一个表单内会有一个或多个 <fieldset> 元素。它们也具有 elements 属性，该属性列出了 <fieldset> 中的表单控件。

例如：

<body>
  <form id="form">
    <fieldset name="userFields">
      <legend>info</legend>
      <input name="login" type="text">
    </fieldset>
  </form>

  <script>
    alert(form.elements.login); // <input name="login">

    let fieldset = form.elements.userFields;
    alert(fieldset); // HTMLFieldSetElement

    // 我们可以通过名字从表单和 fieldset 中获取 input
    alert(fieldset.elements.login == form.elements.login); // true
  </script>
</body>
更简短的表示方式：form.name

还有一个更简短的表示方式：我们可以通过 form[index/name] 来访问元素。

换句话说，我们可以将 form.elements.login 写成 form.login。

这也有效，但是会有一个小问题：如果我们访问一个元素，然后修改它的 name，之后它仍然可以被通过旧的 name 访问到（当然也能通过新的 name 访问）。

我们可以很直观地通过一个例子看到这个情况：

<form id="form">
  <input name="login">
</form>

<script>
  alert(form.elements.login == form.login); // true，与 <input> 相同

  form.login.name = "username"; // 修改 input 的 name

  // form.elements 更新了 name：
  alert(form.elements.login); // undefined
  alert(form.elements.username); // input

  // form 允许我们使用两个名字：新的名字和旧的名字
  alert(form.username == form.login); // true
</script>

这通常来说并不是一个问题，因为我们很少修改表单元素的名字。

反向引用：element.form

对于任何元素，其对应的表单都可以通过 element.form 访问到。因此，表单引用了所有元素，元素也引用了表单。

这是一张示意图：

例如：

<form id="form">
  <input type="text" name="login">
</form>

<script>
  // form -> element
  let login = form.login;

  // element -> form
  alert(login.form); // HTMLFormElement
</script>

表单元素

让我们来谈谈表单控件。

input 和 textarea

我们可以通过 input.value（字符串）或 input.checked（布尔值）来访问复选框（checkbox）和单选按钮（radio button）中的 value。

像这样：

input.value = "New value";
textarea.value = "New text";

input.checked = true; // 对于复选框（checkbox）或单选按钮（radio button）
使用 textarea.value 而不是 textarea.innerHTML

请注意，即使 <textarea>...</textarea> 将它们的 value 作为嵌套的 HTML 标签来保存，我们也绝不应该使用 textarea.innerHTML 来访问它。

它仅存储最初在页面上的 HTML，而不是存储的当前 value。

select 和 option

一个 <select> 元素有 3 个重要的属性：

  1. select.options —— <option> 的子元素的集合，
  2. select.value —— 当前所选择的 <option> 的 value，
  3. select.selectedIndex —— 当前所选择的 <option> 的编号。

它们提供了三种为 <select> 设置 value 的不同方式：

  1. 找到对应的 <option> 元素（例如在 select.options 中），并将其 option.selected 设置为 true。
  2. 如果我们知道新的值：将 select.value 设置为对应的新的值。
  3. 如果我们知道新的选项的索引：将 select.selectedIndex 设置为对应 <option> 的编号。

下面是这三种方式的示例：

<select id="select">
  <option value="apple">Apple</option>
  <option value="pear">Pear</option>
  <option value="banana">Banana</option>
</select>

<script>
  // 下面这三行做的都是同一件事
  select.options[2].selected = true;
  select.selectedIndex = 2;
  select.value = 'banana';
  // 请注意：选项编号是从零开始的，所以编号 2 表示的是第三项
</script>

和大多数其它控件不同，如果 <select> 具有 multiple 特性（attribute），则允许多选。尽管这个特性（attribute）很少被用到。

对于多选的值，使用第一种设置值的方式：在 <option> 子元素中添加/移除 selected 属性。

这是一个如何从多选的 <select> 中获取选择的值的示例：

<select id="select" multiple>
  <option value="blues" selected>Blues</option>
  <option value="rock" selected>Rock</option>
  <option value="classic">Classic</option>
</select>

<script>
  // 从 multi-select 中获取所有选定的 `value`
  let selected = Array.from(select.options)
    .filter(option => option.selected)
    .map(option => option.value);

  alert(selected); // blues,rock
</script>

<select> 元素的完整规范可以在规范 https://html.spec.whatwg.org/multipage/forms.html#the-select-element 中找到。

new Option

在 规范 中，有一个很好的简短语法可以创建一个 <option> 元素：

option = new Option(text, value, defaultSelected, selected);

此语法是可选的。我们可以使用 document.createElement('option') 并手动设置特性（attribute）。不过，这种语法写起来可能会更短，其参数如下：

  • text —— <option> 中的文本，
  • value —— <option> çš„ value，
  • defaultSelected —— 如果为 true，那么 selected HTML-特性（attribute）就会被创建，
  • selected —— 如果为 true，那么这个 <option> 就会被选中。

defaultSelected 和 selected 的区别是，defaultSelected 设置的是 HTML-特性（attribute），我们可以使用 option.getAttribute('selected') 来获得。而 selected 设置的是选项是否被选中。

在实际使用中，通常应该将同时将这两个值设置为 true 或 false。（或者，直接省略它们；两者都默认为 false。）

例如，下面是一个新的未被选中的选项：

let option = new Option("Text", "value");
// 创建 <option value="value">Text</option>

相同的选项，但被选中了：

let option = new Option("Text", "value", true, true);

<option> 元素具有以下属性：

option.selected
<option> 是否被选择。
option.index
<option> 在其所属的 <select> 中的编号。
option.text
<option> 的文本内容（可以被访问者看到）。

参考资料

总结

表单导航：

document.forms
一个表单元素可以通过 document.forms[name/index] 访问到。
form.elements
表单元素可以通过 form.elements[name/index] 的方式访问，或者也可以使用 form[name/index]。elements 属性也适用于 <fieldset>。
element.form
元素通过 form 属性来引用它们所属的表单。

value 可以被通过 input.value，textarea.value，select.value 等来获取到。（对于单选按钮（radio button）和复选框（checkbox），可以使用 input.checked 来确定是否选择了一个值。

对于 <select>，我们可以通过索引 select.selectedIndex 来获取它的 value，也可以通过 <option> 集合 select.options 来获取它的 value。

这些是开始使用表单的基础。我们将在本教程中进一步介绍更多示例。

在下一章中，我们将介绍可能在任何元素上出现，但主要在表单上处理的 focus 和 blur 事件。

任务

在 select 元素中添加一个选项

重要程度: 5

下面是一个 <select> 元素：

<select id="genres">
  <option value="rock">Rock</option>
  <option value="blues" selected>Blues</option>
</select>

使用 JavaScript 来实现：

  1. 显示所选选项的值和文本。
  2. 添加一个选项：<option value="classic">Classic</option>。
  3. 使之变为可选的。

请注意，如果你已正确完成所有事项，那么 alert 应该显示 blues。

解决方案，分步进行：

<select id="genres">
  <option value="rock">Rock</option>
  <option value="blues" selected>Blues</option>
</select>

<script>
  // 1)
  let selectedOption = genres.options[genres.selectedIndex];
  alert( selectedOption.value );

  // 2)
  let newOption = new Option("Classic", "classic");
  genres.append(newOption);

  // 3)
  newOption.selected = true;
</script>
上一节下一节
教程路线图

评论

在评论之前先阅读本内容…
  • 如果你发现教程有错误，或者有其他需要修改和提升的地方 — 请 提交一个 GitHub issue 或 pull request，而不是在这评论。
  • 如果你对教程的内容有不理解的地方 — 请详细说明。
  • 使用 <code> 标签插入只有几个词的代码，插入多行代码可以使用 <pre> 标签，对于超过 10 行的代码，建议你使用沙箱（plnkr，JSBin，codepen…）

章节

课程导航

分享
在 GitHub 上编辑