blockly > IFocusableTree > getRestoredFocusableNode

Méthode IFocusableTree.getRestoredFocusableNode()

Renvoie l'élément IFocusableNode de cet arbre qui doit recevoir la sélection active lorsque l'arbre lui-même est sélectionné.

Vous devez prendre en compte certaines remarques très importantes concernant le cycle de vie de la sélection d'un arbre lorsque vous implémentez une version de cette méthode qui ne renvoie pas la valeur null: 1. Un previousNode nul ne garantit pas l'état de focus initial, car les nœuds peuvent être supprimés. 2. Cette méthode n'est utilisée que lorsque l'arbre lui-même est sélectionné, soit via la navigation par onglet, soit via FocusManager.focusTree(). Dans de nombreux cas, le nœud précédemment sélectionné est directement sélectionné, ce qui contourne cette méthode. 3. Le comportement par défaut (c'est-à-dire renvoyer la valeur nulle ici) implique de restaurer le nœud précédent (previousNode) ou de mettre en surbrillance la racine de l'arborescence. 4. Le nœud fourni peut parfois ne plus être valide, par exemple lorsqu'une tentative est faite pour mettre en surbrillance un nœud qui a été récemment supprimé de son arbre parent. Les implémentations peuvent vérifier la validité du nœud afin de spécialiser le nœud auquel le focus doit revenir.

Cette méthode vise principalement à fournir aux implémentations d'arbres les moyens de spécifier un meilleur nœud par défaut que leur racine.

Signature :

getRestoredFocusableNode(previousNode: IFocusableNode | null): IFocusableNode | null;

Paramètres

Paramètre Type Description
previousNode IFocusableNode | null Nœud qui détenait auparavant la sélection passive pour cet arbre, ou valeur nulle si l'arbre n'a pas encore été sélectionné.

Renvoie :

IFocusableNode | null

IFocusableNode qui doit désormais recevoir la sélection, ou "null" si le comportement par défaut doit être utilisé à la place.