blockly > FocusManager > takeEphemeralFocus

FocusManager.takeEphemeralFocus() メソッド

返されたラムダが呼び出されるまでの間、特定の要素のフォーカスを一時的にキャプチャします。これは、ダイアログなどのエフェメラル UI フローで特に役立つと予想されます。

重要: 返されたラムダは呼び出す必要があります。呼び出さないと、ページ上のどこでも自動フォーカスが機能しなくなります。ラムダ呼び出しを対応する UI のクローズに関連付けることを強くおすすめします。これにより、入力がエフェメラル UI 外の要素に手動で変更された場合、UI が閉じて自動入力が復元されます。このラムダは 1 回だけ呼び出す必要があり、それ以降の呼び出しはエラーをスローします。

エフェメラル フォーカスが有効になっている場合でも、マネージャーは DOM 入力シグナルを引き続き追跡しますが、返されたラムダが呼び出されるまでノード状態は実際には変更されません。また、一度にアクティブにできるエフェメラル フォーカス コンテキストは 1 つのみです(複数を同時に有効にしようとすると、エラーがスローされます)。

署名:

takeEphemeralFocus(focusableElement: HTMLElement | SVGElement): ReturnEphemeralFocus;

パラメータ

パラメータ 説明
focusableElement HTMLElement | SVGElement

戻り値:

ReturnEphemeralFocus