Uchwyć i zwolnij fokus

W specjalnych trybach interakcji (takich jak wbudowany obszar roboczy do rysowania, powierzchnia kontrolera do gier lub modalne okno dialogowe wprowadzania danych) aplikacja może wymagać tymczasowego zablokowania zaznaczenia na jednym komponencie i uniemożliwienia nawigacji za pomocą klawisza Tab lub klawiszy kierunkowych.

Ostrzeżenie: przechwytywanie zaznaczenia może powodować problemy z ułatwieniami dostępu. Użytkownicy mogą nie być w stanie przejść do innych komponentów, które można zaznaczyć.

Ustawianie ostrości

Aby ustawić zaznaczenie, wywołaj captureFocus() na FocusRequester:

val focusRequester = remember { FocusRequester() }

Box(
    modifier = Modifier
        .focusRequester(focusRequester)
        .focusable()
        .onFocusChanged { focusState ->
            if (focusState.isFocused) {
                focusRequester.captureFocus()
            }
        }
)
CaptureFocus.kt

Ważne: komponent docelowy musi już być aktywny (isFocused == true) podczas wywoływania captureFocus(). Wywołanie captureFocus() na niezaznaczonym elemencie zwraca false i nie powoduje zaznaczenia.

Gdy fokus jest przechwycony, standardowe klawisze nawigacji fokusem (takie jak Tab) nie przenoszą fokusu na sąsiednie komponenty.

Zwolnienie nacisku

Aby wyjść ze stanu przechwycenia i przywrócić normalną nawigację przy użyciu zaznaczenia w interfejsie, wywołaj freeFocus():

IconButton(
    onClick = {
        focusRequester.freeFocus()
    }
) {
    Icon(Icons.Default.Close, contentDescription = "Exit focus lock")
}
CaptureFocus.kt