Skip to content

UITextField:beforefocus 事件 ​

beforefocus 事件在输入框即将成为 first responder 时派发:用户点了它,或者代码调了 becomeFirstResponder()。监听器里调 preventDefault(),输入框不进入编辑,键盘不弹出。

语法 ​

field.addEventListener('beforefocus', (event) => { })

事件对象 ​

Event。type 是事件名,target 是这个输入框。可以取消:event.cancelable 是 true,preventDefault() 起作用。

什么时候派发 ​

  • 用户点输入框,或者代码调 becomeFirstResponder() 时派发。代码调用时,监听器在这个调用返回之前就执行完了。
  • 调了 preventDefault():不进入编辑,键盘不弹出,becomeFirstResponder() 返回 false。
  • 没有调:照常聚焦,随后派发 focus。实测顺序是 beforefocus → focus。
  • 实测监听器抛了异常,输入框照常拿到焦点。
  • 监听器是当场执行的。系统派发事件之后等监听器全部执行完,再决定做不做。
  • 同一个事件有多个监听器时,只要有一个调了 preventDefault(),系统就不做。
  • 监听器里抛出异常时,同一事件的其他监听器照常执行。异常在 application 上派发 error。抛异常不等于 preventDefault()。
  • 最后一个监听器移除之后,系统不再派发这个事件。
  • 在 UITextField 和 UITextView 上有。在别的控件上监听不报错,但系统不会派发。

注意:监听器执行期间系统在等。在监听器里只做判断,不做耗时的事。

示例 ​

js
const field = new UITextField();
let locked = true;
field.addEventListener('beforefocus', (event) => {
  if (locked) event.preventDefault();
});
console.log(field.becomeFirstResponder());

结果:输出 false。输入框没有进入编辑。

对应的 iOS API ​

UITextFieldDelegate 的 textFieldShouldBeginEditing: 返回 NO,对应这里调 event.preventDefault()。

参见 ​