blockly > FocusableTreeTraverser > findFocusableNodeFor
FocusableTreeTraverser.findFocusableNodeFor() 方法
如果指定的 HTML 或 SVG 元素是根元素,或是指定 IFocusableTree 的根元素後代,則傳回對應的 IFocusableNode。
如果元素存在於指定樹狀結構的 DOM 結構中,但並未直接對應至節點,系統會傳回最接近的父項節點 (或樹狀結構的根),代表提供的元素。
如果樹狀結構包含另一個巢狀 IFocusableTree,系統可能會遍歷巢狀樹狀結構,但根據 IFocusableTree.lookUpFocusableNode 的合約,系統絕不會在此傳回巢狀樹狀結構的節點。
提供的元素必須具有非空值、非空白的 ID,且符合 IFocusableNode 中提及的合約。
Signature:
static findFocusableNodeFor(element: HTMLElement | SVGElement, tree: IFocusableTree): IFocusableNode | null;
參數
參數 | 類型 | 說明 |
---|---|---|
元素 | HTMLElement | SVGElement | 要尋找的 HTML 或 SVG 元素。 |
樹 | IFocusableTree | 所提供元素可能為後代的樹狀結構。 |
傳回:
IFocusableNode | null
相符的 IFocusableNode,如果沒有相符項目,則為空值。