CodePlayer

focusin()函数用于为每个匹配元素的focusin事件绑定处理函数。此外，你还可以为事件处理函数传递一些附加数据。

focusin事件就是获得焦点事件。与focus事件不同的是：focusin可以检测该元素的后代元素获得焦点的情况(换句话说，focusin事件支持冒泡)。

此外，你可以为同一元素多次调用该函数，从而绑定多个事件处理函数。触发focusin事件时，jQuery会按照绑定的先后顺序依次执行绑定的事件处理函数。

要删除通过focusin()绑定的事件，请使用unbind()函数。

该函数属于jQuery对象(实例)。

语法

jQuery 1.4 新增该函数。

jQueryObject.focusin( [ data ,]  handler )

参数

jQuery 1.4.3 新增支持：focusin()支持data参数。

参数handler中的this指向当前DOM元素。focusin()还会为handler传入一个参数：表示当前事件的Event对象。

如果函数handler的返回值为false，则表示阻止元素的默认事件行为，并停止事件在DOM树中冒泡。例如，<a>链接的click事件的处理函数返回false，可以阻止链接的默认URL跳转行为。<form>表单的submit事件的处理函数返回false，可以阻止表单默认的表单提交行为。

返回值

focusin()函数的返回值为jQuery类型，返回当前jQuery对象本身。

示例&说明

请参考下面这段初始HTML代码：

<p>
	<input id="t1" name="name" type="text" />
</p>
<p>
	<input id="t2" name="age" type="text" />
</p>
<div id="msg"></div>

现在，我们为所有p元素的focusin事件绑定处理函数(可以绑定多个，触发时按照绑定顺序依次执行)：

focusin是支持冒泡的，当我们把鼠标光标放入文本框时，该事件冒泡传递到父元素p上，因此可以在p元素上触发focusin事件。

var $ps = $("p");

//为所有p元素的focusin事件绑定处理函数
$ps.focusin( function(event){
	$(this).css("border", "1px solid blue");
} );

//为所有p元素的focusin事件绑定处理函数
$ps.focusin( function(event){
	$(this).css("border-radius", "3px");
} );

//触发所有p元素的focusin事件
//$ps.focusin( ); // 调用不带任何参数的focusin()函数，会触发每个匹配元素的focusin事件

运行代码(以下代码请自行复制到演示页面运行)

我们还可以为事件处理函数传递一些附加的数据。此外，通过jQuery为事件处理函数传入的参数Event对象，我们可以获取当前事件的相关信息(比如事件类型、触发事件的DOM元素、附加数据等)：

var inputMap = { "name": "姓名", "age": "年龄" };

//为所有text元素的focusin事件绑定处理函数
$("p").focusin( inputMap, function(event){
	var map = event.data;
	var inputName = $(this).children(":text:focus").attr("name");
	$("#msg").html( '请输入[' + map[inputName] + ']' );
} );