很多人寫 $("#id").focus() 想讓輸入框自動聚焦,卻發現游標根本沒跳進去。原因在於:jQuery 選到的物件並不是原生的 DOM 元素。
對 jQuery 物件呼叫 focus(),只會幫它掛上 onFocus 的處理函式,並不會真的讓元素取得焦點。要讓元素獲得焦點,必須呼叫底層 DOM 元素的 focus 方法:
$("#id")[0].focus();
[0] 就是把 jQuery 集合中的第一個原生元素取出來。
$("#id").focus(); // 綁定 focus 事件處理器
$("#id")[0].focus(); // 讓 DOM 元素實際取得焦點
| 寫法 | 行為 |
|---|---|
$("#id").focus() | 不帶參數時觸發 focus 事件;帶函式參數時綁定事件 |
$("#id")[0].focus() | 呼叫原生 DOM 方法,真正讓元素聚焦 |
嚴格來說,不帶參數的 .focus() 是「觸發事件」,而 .focus(fn) 是「註冊事件」,兩者容易混淆,這也是建議改用 .on("focus", fn) 與 .trigger("focus") 以明確區分意圖的原因。
$("#id").get(0).focus(); // 用 get() 取原生元素,語意更清楚
$("#id").trigger("focus"); // 觸發 jQuery 的 focus 事件
// 原生寫法
document.getElementById("id").focus();
document.querySelector("#id").focus();
只有 <input>、<textarea>、<select>、<button>、<a href> 等元素能取得焦點。對 <div> 呼叫 focus() 不會有任何效果,除非它設定了 tabindex:
<div tabindex="0" id="box">可以聚焦了</div>
若元素在 display:none 狀態下呼叫 focus,會靜默失敗。順序必須是「先顯示、再聚焦」:
$("#dialog").show();
$("#dialog input").focus();
// 原生
document.querySelector("#id").focus();
// 延後到下一個事件迴圈,確保 DOM 已就緒
requestAnimationFrame(() => document.querySelector("#id").focus());
// 手動觸發鍵盤事件時注意:focus 屬性可用 document.activeElement 檢查
console.log(document.activeElement.id);
補充一個常被誤解的地方:程式呼叫 focus() 不會開啟手機上的虛擬鍵盤,因為瀏覽器基於安全考量,只允許「使用者操作」觸發的 focus 彈出鍵盤。若需要鍵盤自動彈出,仍需在 click 等使用者事件的同步流程中呼叫。