表单事件

表单事件的种类 #

input 事件 #

input 事件当 <input> <select> <textarea> 的值发生变化时触发。对于复选框( <input type=checkbox> )或单选框( <input type=radio> ),用户改变选项时,也会触发这个事件。另外,对于打开 contenteditable 属性的元素,只要值发生变化,也会触发 input 事件。

input 事件的一个特点,就是会连续触发,比如用户每按下一次按键,就会触发一次 input 事件。

input 事件对象继承了 InputEvent 接口。

该事件跟 change 事件很像,不同之处在于 input 事件在元素的值发生变化后立即发生,而 change 在元素失去焦点时发生,而内容此时可能已经变化多次。也就是说,如果有连续变化, input 事件会触发多次,而 change 事件只在失去焦点时触发一次。

下面是 <select> 元素的例子。

/* HTML 代码如下
<select id="mySelect">
  <option value="1">1</option>
  <option value="2">2</option>
  <option value="3">3</option>
</select>
*/

function inputHandler(e) {
  console.log(e.target.value)
}

var mySelect = document.querySelector('#mySelect');
mySelect.addEventListener('input', inputHandler);

上面代码中,改变下拉框选项时,会触发 input 事件,从而执行回调函数 inputHandler

select 事件 #

select 事件当在 <input> <textarea> 里面选中文本时触发。

// HTML 代码如下
// <input id="test" type="text" value="Select me!" />

var elem = document.getElementById('test');
elem.addEventListener('select', function (e) {
  console.log(e.type); // "select"
}, false);

选中的文本可以通过 event.target 元素的 selectionDirection selectionEnd selectionStart value 属性拿到。

change 事件 #

change 事件当 <input> <select> <textarea> 的值发生变化时触发。它与 input 事件的最大不同,就是不会连续触发,只有当全部修改完成时才会触发,另一方面 input 事件必然伴随 change 事件。具体来说,分成以下几种情况。

  • 激活单选框(radio)或复选框(checkbox)时触发。
  • 用户提交时触发。比如,从下列列表(select)完成选择,在日期或文件输入框完成选择。
  • 当文本框或 <textarea> 元素的值发生改变,并且丧失焦点时触发。

下面是一个例子。

// HTML 代码如下
// <select size="1" onchange="changeEventHandler(event);">
//   <option>chocolate</option>
//   <option>strawberry</option>
//   <option>vanilla</option>
// </select>

function changeEventHandler(event) {
  console.log(event.target.value);
}

如果比较一下上面 input 事件的例子,你会发现对于 <select> 元素来说, input change 事件基本是等价的。

invalid 事件 #

用户提交表单时,如果表单元素的值不满足校验条件,就会触发 invalid 事件。

<form>
  <input type="text" required oninvalid="console.log('invalid input')" />
  <button type="submit">提交</button>
</form>

上面代码中,输入框是必填的。如果不填,用户点击按钮提交时,就会触发输入框的 invalid 事件,导致提交被取消。

reset 事件,submit 事件 #

这两个事件发生在表单对象 <form> 上,而不是发生在表单的成员上。

reset 事件当表单重置(所有表单成员变回默认值)时触发。

submit 事件当表单数据向服务器提交时触发。注意, submit 事件的发生对象是 <form> 元素,而不是 <button> 元素,因为提交的是表单,而不是按钮。

InputEvent 接口 #

InputEvent 接口主要用来描述 input 事件的实例。该接口继承了 Event 接口,还定义了一些自己的实例属性和实例方法。

浏览器原生提供 InputEvent() 构造函数,用来生成实例对象。

new InputEvent(type, options)

InputEvent 构造函数可以接受两个参数。第一个参数是字符串,表示事件名称,该参数是必需的。第二个参数是一个配置对象,用来设置事件实例的属性,该参数是可选的。配置对象的字段除了 Event 构造函数的配置属性,还可以设置下面的字段,这些字段都是可选的。

  • inputType :字符串,表示发生变更的类型(详见下文)。
  • data :字符串,表示插入的字符串。如果没有插入的字符串(比如删除操作),则返回 null 或空字符串。
  • dataTransfer :返回一个 DataTransfer 对象实例,该属性通常只在输入框接受富文本输入时有效。

InputEvent 的实例属性主要就是上面三个属性,这三个实例属性都是只读的。

(1)InputEvent.data

InputEvent.data 属性返回一个字符串,表示变动的内容。

// HTML 代码如下
// <input type="text" id="myInput">
var input = document.getElementById('myInput');
input.addEventListener('input', myFunction, false);

function myFunction(e) {
  console.log(e.data);
}

上面代码中,如果手动在输入框里面输入 abc ,控制台会先输出 a ,再在下一行输出 b ,再在下一行输出 c 。然后选中 abc ,一次性将它们删除,控制台会输出 null 或一个空字符串。

(2)InputEvent.inputType

InputEvent.inputType 属性返回一个字符串,表示字符串发生变更的类型。

对于常见情况,Chrome 浏览器的返回值如下。完整列表可以参考 文档

  • 手动插入文本: insertText
  • 粘贴插入文本: insertFromPaste
  • 向后删除: deleteContentBackward
  • 向前删除: deleteContentForward

(3)InputEvent.dataTransfer

InputEvent.dataTransfer 属性返回一个 DataTransfer 实例。该属性只在文本框接受粘贴内容(insertFromPaste)或拖拽内容( insertFromDrop )时才有效。