blockly > IFocusableNode > getFocusableElement

Méthode IFocusableNode.getFocusableElement()

Renvoie l'élément DOM qui peut être explicitement demandé pour recevoir le focus.

IMPORTANT : Veuillez noter que cet élément doit être visible sur la page, car il sera explicitement sélectionné et son style sera modifié en fonction de son état de sélection actuel (c'est-à-dire flou, activement sélectionné et passivement sélectionné). L'élément sera associé à l'un des deux styles suivants (l'absence de style indique que l'élément est flou ou non sélectionné) : - blocklyActiveFocus - blocklyPassiveFocus

L'élément renvoyé doit également avoir un ID valide spécifié, et cet ID doit être unique sur l'ensemble de la page. Si l'ID n'est pas suffisamment unique, il est possible que la tentative de sélection d'un nœud (par exemple, par un clic de souris) entraîne la sélection d'un autre nœud portant le même ID par FocusManager.

L'élément renvoyé doit être visible si le nœud est ciblé via FocusManager.focusNode() ou FocusManager.focusTree(). Un élément peut être masqué jusqu'à ce que onNodeFocus() soit appelé, ou devenir masqué avec un appel à onNodeBlur().

L'élément renvoyé ne devrait pas changer pendant toute la durée de vie du nœud (c'est-à-dire que ses propriétés peuvent changer, mais un nouvel élément ne devrait jamais être renvoyé). De plus, la valeur tabindex de l'élément renvoyé sera écrasée tout au long du cycle de vie de ce nœud et de FocusManager.

Si un nœud doit pouvoir être sélectionné directement sans l'être d'abord via FocusManager, il doit définir son propre index de tabulation.

Signature :

getFocusableElement(): HTMLElement | SVGElement;

Renvoie :

HTMLElement | SVGElement

HTMLElement ou SVGElement qui peuvent tous deux recevoir le focus et être représentés visuellement comme étant activement ou passivement sélectionnés pour ce nœud.