docs(elements): add form

ruanyf · ruanyf · commit 25b20ac4eacc · 2018-05-13T15:32:34.000+08:00
diff --git a/chapters.yml b/chapters.yml
@@ -72,5 +72,6 @@
 - elements/: 附录：网页元素接口
 - elements/a.md: <a>
 - elements/image.md: <img>
+- elements/form.md: <form>
 - elements/input.md: <input>
 - elements/button.md: <button>
diff --git a/docs/dom/document.md b/docs/dom/document.md
@@ -102,6 +102,16 @@ var selectForm = document.forms[0];
 
 上面代码获取文档第一个表单。
 
+除了使用位置序号，`id`属性和`name`属性也可以用来引用表单。
+
+```javascript
+/* HTML 代码如下
+  <form name="foo" id="bar"></form>
+*/
+document.forms[0] === document.forms.foo // true
+document.forms.bar === document.forms.foo // true
+```
+
 **（3）document.images**
 
 `document.images`属性返回页面所有`<img>`图片节点。
diff --git a/docs/elements/form.md b/docs/elements/form.md
@@ -0,0 +1,33 @@
+# <form> 元素
+
+`<form>`元素代表了表单，继承了 HTMLFormElement 接口。
+
+## HTMLFormElement 的实例属性
+
+- `elements`：返回一个类似数组的对象，成员是属于该表单的所有控件元素。该属性只读。
+- `length`：返回一个整数，表示属于该表单的控件数量。该属性只读。
+- `name`：字符串，表示该表单的名称。
+- `method`：字符串，表示提交给服务器时所使用的 HTTP 方法。
+- `target`：字符串，表示表单提交后，服务器返回的数据的展示位置。
+- `action`：字符串，表示表单提交数据的 URL。
+- `enctype`（或`encoding`）：字符串，表示表单提交数据的编码方法，可能的值有`application/x-www-form-urlencoded`、`multipart/form-data`和`text/plain`。
+- `acceptCharset`：字符串，表示服务器所能接受的字符编码，多个编码格式之间或空格分隔。
+- `autocomplete`：字符串`on`或`off`，表示浏览器是否要对`<input>`控件提供自动补全。
+- `noValidate`：布尔值，表示是否关闭表单的自动校验。
+
+## HTMLFormElement 的实例方法
+
+- `submit()`：提交表单，但是不会触发`submit`事件和表单的自动校验。
+- `reset()`：重置表单控件的值为默认值。
+- `checkValidity()`：如果控件能够通过自动校验，返回`true`，否则返回`false`，同时触发`invalid`事件。
+
+下面是一个创建表单并提交的例子。
+
+```javascript
+var f = document.createElement('form');
+document.body.appendChild(f);
+f.action = '/cgi-bin/some.cgi';
+f.method = 'POST';
+f.submit();
+```
+
