blockly > IFocusableTree > getRestoredFocusableNode
IFocusableTree.getRestoredFocusableNode() メソッド
ツリー自体にフォーカスが戻されたときにアクティブなフォーカスを受け取る必要がある、このツリーの IFocusableNode を返します。
null を返さないバージョンのこのメソッドを実装する際は、ツリーのフォーカス ライフサイクルについて、次の点に注意してください。1. ノードは削除される可能性があるため、previousNode が null の場合、最初のフォーカス状態が保証されるわけではありません。2. このメソッドは、タブ ナビゲーションまたは FocusManager.focusTree() のいずれかによってツリー自体にフォーカスが当てられている場合にのみ使用されます。多くの場合、以前にフォーカスされていたノードが直接フォーカスされるため、このメソッドはバイパスされます。3. デフォルトの動作（ここでは null を返す）では、前のノード（previousNode）を復元するか、ツリーのルートにフォーカスを合わせます。4. 指定されたノードが有効でなくなることがあります。たとえば、親ツリーから最近削除されたノードをフォーカスしようとした場合などです。実装では、フォーカスがフォールバックするノードを特殊化するために、ノードの有効性を確認できます。
このメソッドは主に、ルートよりも優れたデフォルト ノードを指定する手段をツリー実装に提供する目的で用意されています。
署名:
getRestoredFocusableNode(previousNode: IFocusableNode | null): IFocusableNode | null;
パラメータ
| パラメータ | 型 | 説明 |
|---|---|---|
| previousNode | IFocusableNode | null | このツリーで以前にパッシブ フォーカスを保持していたノード。ツリーにフォーカスが設定されていない場合は null です。 |
戻り値:
IFocusableNode | null
フォーカスを受け取る IFocusableNode。デフォルトの動作を使用する場合は null。