13.1 表单
在HTML中,表单是由 <form> 元素来表示的,而在 JavaScript 中,表单对应的则是 HTMLFormElement 类型。HTMLFormElement 继承了 HTMLElement,因而与其他 HTML 元素具有相同的默认属性。不过,HTMLFormElement 也有它自己独有的属性和方法。
- acceptCharset: 服务器能够处理的字符集;等价于 HTML 中的 accept-charset 特性。
- action: 接受请求的 URL;等价于 HTML 中的 action 特性。
- elements: 表单中所有控件的集合 (HTMLCollection)。
- enctype: 请求的编码类型;等价于 HTML 中的 enctype 特性。
- length: 表单中控件的数量。
- method: 要发送的 HTTP 请求类型,通常是 "get" 或 "post";等价于 HTML 的 method 特性。
- name: 表单的名称;等价于 HTML 的 name 特性。
- reset(): 将所有表单域重置为默认值。
- submit(): 提交表单。
- target: 用于发送请求和接收响应的窗口名称;等价于 HTML 的 target 特性。
13.1.1 提交表单
用户单击提交按钮或图像按钮时,就会提交表单。使用 <input> 或 <button> 都可以定义提交按钮,只要将其 type 特性的值设置为 "submit" 即可,而图像按钮则是通过将 <input> 的 type 特性值设置为 "image" 来定义的。因此,只要我们单击以下代码生成的按钮,就可以提交表单:
<!-- 通用提交按钮 -->
<input type="submit" value="Submit Form">
<!-- 自定义提交按钮 -->
<button type="submit">Submit Form</button>
<!-- 图像按钮 -->
<input type="image" src="graphic.gif" >
只要表单中存在上面列出的任何一种按钮,那么在相应表单控件拥有焦点的情况下,按回车键就可以提交该表单。如果表单里没有提交按钮,按回车键不会提交表单。
以这种方式提交表单时,浏览器会在将请求发送给服务器之前触发 submit 事件。这样,我们就有机会验证表单数据,并据以决定是否允许表单提交。阻止这个事件的默认行为就可以取消表单提交。例如,下列代码会阻止表单提交:
var form = document.getElementById("myForm");
EventUtil.addHandler(form, "submit", function(event){
// 取得事件对象
event = EventUtil.getEvent(event);
// 阻止默认事件
EventUtil.preventDefault(event);
});
这里使用了第12章定义的 EventUtil 对象,以便跨浏览器处理事件。调用 preventDefault() 方法阻止了表单提交。一般来说,在表单数据无效而不能发送给服务器时,可以使用这一技术。
在 JavaScript 中,以编程方式调用 submit() 方法也可以提交表单。而且,这种方法无需表单包含提交按钮,任何时候都可以正常提交表单。来看一个例子:
var form = document.getElementById("myForm");
// 提交表单
form.submit();
在以调用 submit() 方法的形式提交表单时,不会触发 submit 事件,因此要记得在调用此方法之前先验证表单数据。
提交表单时可能出现的最大问题,就是重复提交表单。在第一次提交表单后,如果长时间没有反应,用户可能会变得不耐烦。这时候,他们也许会反复单击提交按钮。结果往往很麻烦 (因为服务器要处理重复的请求),或者会造成错误 (如果用户是下订单,那么可能会多订好几份)。解决这一问题的办法有两个:在第一次提交表单后就禁用提交按钮,或者利用 onsubmit 事件处理程序取消后续的表单提交操作。
13.1.2 重置表单
在用户单击重置按钮时,表单会被重置。使用 type 特性值为 "rest" 的 <input> 或 <button> 都可以创建重置按钮,如下面的例子所示:
<!-- 通用重置按钮 -->
<input type="reset" value="Reset Form">
<!-- 自定义重置按钮 -->
<button type="reset">Reset Form</button>
这两个按钮都可以用来重置表单。在重置表单时,所有表单字段都会恢复到页面刚加载完毕时的初始值。如果某个字段的初始值为空,就会恢复为空;而带有默认值的字段,也会恢复为默认值。
用户单击重置按钮重置表单时,会触发 reset 事件。利用这个机会,我们可以在必要时取消重置操作。例如,以下展示了阻止重置表单的代码:
var form = document.getElementById("myForm");
EventUtil.addHandler(form, "reset", function(event){
// 取得事件对象
event = EventUtil.getEvent(event);
// 阻止表单重置
EventUtil.preventDefault(event);
});
与提交表单一样,也可以通过 JavaScript 来重置表单,如下面的例子所示:
var form = document.getElementById("myForm");
// 重置表单
form.reset();
与调用 submit() 方法不同,调用 reset() 方法会像单击重置按钮一样触发 reset 事件。
在 Web 表单设计中,重置表单通常意味着对已经填写的数据不满意。重置表单经常会导致用户摸不着头脑,如果意外地触发了表单重置事件,那么用户甚至会很恼火。事实上,重置表单的需求是很少见的。更常见的做法是提供一个取消按钮,让用户能够回到前一个页面,而不是不分青红皂白地重置表单中的所有值。
13.1.3 表单字段
可以像访问页面中的其他元素一样,使用原生 DOM 方法访问表单元素。此外,每个表单都有 elements 属性,该属性是表单中所有元素的集合。这个 elements 集合是一个有序列表,其中包含着表单中的所有字段,例如 <input>、<textarea>、<button> 和 <fieldset> 。每个表单字段在 elements 集合中的顺序,与它们出现在标记中的顺序相同,可以按照位置和 name 特性来访问它们。下面来看一个例子:
var form = document.getElementById("form1");
// 取得表单中的第一个字段
var field1 = form.elements[0];
// 取得名为 textbox1 的字段
var field2 = form.element["textbox1"];
// 取得表单中包含的字段的数量
var fieldCount = form.elements.length;
如果有多个表单控件都在使用一个 name (如单选按钮),那么就会返回以该 name 命名的一个 NodeList 。例如,以下面的HTML代码片段为例:
<form method="post" id="myForm">
<ul>
<li><input type="radio" name="color" value="red">Red</li>
<li><input type="radio" name="color" value="green">Green</li>
<li><input type="radio" name="color" value="blue">Blue</li>
</ul>
</form>
在这个 HTML 表单中,有3个单选按钮,它们的 name 都是 "color" ,意味着这3个字段是一起的。在访问 elements["colors"] 时,就会返回一个 NodeList,其中包含这3个元素;不过,如果访问 elements[0],则只返回第一个元素。来看下面的例子:
var form = document.getElementById("myForm");
var colorFields = form.elements["color"];
alert(colorFields.length); // 3
var firstColorField = colorFields[0];
var firstFormField = form.elements[0];
alert(firstColorField === firstFormField); // true
以上代码显示,通过 form.elements[0] 访问到的第一个表单字段,与包含在 form.elements["color"] 中的第一个元素相同。
也可以通过访问表单的属性来访问元素,例如 form[0] 可以取得第一个表单字段,而 form["color"] 则可以取得第一个命名字段。这些属性与通过 elements 集合访问到的元素是相同的。但是,我们应该紧可能使用 elements,通过表单属性访问元素只是为了与旧留啦请你向后兼容而保留的一种过渡方式。
1.共有的表单字段属性
除了 <fieldset> 元素之外,所有表单字段都拥有相同的一组属性。由于 <input> 类型可以表示多种表单字段,因此有些属性只适用于某些字段,但还有一些属性是所有字段所共有的。表单字段共有的属性和方法如下:
- disabled: 布尔值,表示当前字段是否被禁用。
- form: 指向当前字段所属表单的指针;只读。
- name: 当前字段的名称。
- readOnly: 布尔值,表示当前字段是否只读。
- tabIndex: 表示当前字段的切换 (tab) 序号。
- type: 当前字段的类型,如 "checkbox"、"radio",等等。
- value: 当前字段将被提交给服务器的值。对文件字段来说,这个属性是只读的,包含着文件在计算机中的路径。
2.共有的表单字段方法
每个表单字段都有两个方法:focus() 和 blur() 。其中,focus() 方法用于将浏览器的焦点设置到表单字段,即激活表单字段,使其可以响应键盘事件。例如,接收到焦点的文本框会显示插入符号,随时可以接收输入。使用 focus() 方法,可以将用户的注意力吸引到页面中的某个部位。例如,在页面加载完毕后,将焦点转移到表单中的第一个字段。为此,可以侦听页面的 load 事件,并在该事件发生时在表单的第一个字段上调用 focus() 方法,如下面的例子所示:
EventUtil.addHandler(window, "load", function(event){
document.forms[0].elements[0].focus();
});
要注意的是,如果第一个表单字段是一个 <input> 元素,且其 type 特性的值为 "hidden" ,那么以上代码会导致错误。另外,如果使用 CSS 的 display 和 visibility 属性隐藏了该字段,同样也会导致错误。
在默认情况下,只有表单字段可以获得焦点。对于其他元素而言,如果先将其 tabIndex 属性设置为 -1 ,然后再调用 focus() 方法,也可以让这些元素获得焦点。只有 Opera 不支持这种技术。
与 focus() 方法相对的是 blur() 方法,它的作用是从元素中移走焦点。在调用 blur() 方法时,并不会把焦点转移到某个特定的元素上;仅仅是将焦点从调用这个方法的元素上面移走而已。在早期Web开发中,那时候的表单字段还没有 readonly 特性,因此就可以使用 blur() 方法来创建只读字段。现在,虽然需要使用blur() 的场合不多了,但必要时还可以使用的。用法如下:
document.forms[0].elements[0].blur();
3.共有的表单字段事件
除了支持鼠标、键盘、更改和 HTML 事件之外,所有表单字段都支持下列3个事件。
- blur: 当前字段失去焦点时触发。
- change: 对于 <input> 和 <textarea> 元素,在它们失去焦点且 value 值改变时触发;对于 <select> 元素,在其选项改变时触发。
- focus: 当前字段获得焦点时触发。
var textbox = document.forms[0].elements[0];
EventUtil.addHandler(textbox, "focus", function(event){
event = EventUtil.getEvent(event);
var target = EventUtil.getTarget(event);
if(target.style.backgroundColor != "red"){
target.style.backgroundColor = "yellow";
}
});
EventUtil.addHandler(textbox, "blur", function(event){
event = EventUtil.getEvent(event);
var target = EventUtil.getTarget(event);
if(/[^\d]/.test(target.value)){
target.style.backgroundColor = "red";
}else {
target.style.backgroundColor = "";
}
});
Event.addHandler(textbox, "change", function(event){
event = EventUtil.getEvent(event);
var target = EventUtil.getTarget(event);
if(/[^\d]/.test(target.value)){
target.style.backgroundColor = "red";
}else {
target.style.backgroundColor = "";
}
});