blockly > FocusManager > takeEphemeralFocus

FocusManager.takeEphemeralFocus() 方法

暫時擷取特定元素的焦點,直到呼叫傳回的 lambda 為止。這項功能特別適合用於對話方塊等暫時性 UI 流程。

重要事項:您 *必須* 呼叫傳回的 lambda,否則頁面上的任何位置都無法再使用自動對焦功能。強烈建議您將 lambda 呼叫與對應 UI 的結束函式繫結,這樣一來,如果輸入內容手動變更為暫時性 UI 以外的元素,UI 就會關閉,並還原自動輸入內容。請注意,這個 lambda 必須呼叫一次,後續的呼叫會擲回錯誤。

請注意,即使暫時性焦點處於啟用狀態,管理員仍會繼續追蹤 DOM 輸入信號,但在呼叫傳回的 lambda 之前,實際上不會變更節點狀態。此外,在任何特定時間點,系統只能啟用 1 個暫時性焦點背景資訊 (嘗試同時啟用多個焦點背景資訊會導致發生錯誤)。

Signature:

takeEphemeralFocus(focusableElement: HTMLElement | SVGElement): ReturnEphemeralFocus;

參數

參數 類型 說明
focusableElement HTMLElement | SVGElement

退貨:

ReturnEphemeralFocus