Capturar e liberar o foco

Em modos de interação especializados (como uma tela de desenho incorporada, uma superfície de controle de jogo ou uma caixa de diálogo de entrada modal), o app pode precisar bloquear temporariamente o foco em um único componente e impedir que as teclas Tab ou direcionais saiam da navegação.

Aviso: capturar o foco pode causar problemas de acessibilidade. Talvez os usuários não consigam navegar para outros componentes que podem receber foco.

Foco de captura

Para capturar o foco, invoque captureFocus() em um FocusRequester:

val focusRequester = remember { FocusRequester() }

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

Importante: o componente de destino já precisa ter o foco ativo (isFocused == true) ao chamar captureFocus(). Invocar captureFocus() em um elemento sem foco retorna false e não captura o foco.

Enquanto o foco é capturado, as teclas de navegação de foco padrão (como Tab) não movem o foco para componentes vizinhos.

Liberar o foco

Para sair do estado capturado e restaurar a navegação de foco normal na interface, chame freeFocus():

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