사용자가 수정 가능한 텍스트 구성요소(예: TextField)에 포커스를 맞추면 기기에 하드웨어 키보드가 연결되어 있는 경우 모든 입력은 시스템에 의해 처리됩니다. 주요 이벤트를 처리하여 단축키를 제공할 수 있습니다.
주요 이벤트
Compose에서는 다음을 사용하여 개별 키 입력을 처리할 수 있습니다. onKeyEvent 수정자 이 수정자는 다음과 같은 람다를 허용합니다. 수정된 구성요소가 키 이벤트를 수신하는 경우 주요 이벤트는 KeyEvent 객체로 설명됩니다. 객체를 참조하면 각 주요 이벤트의 정보를 가져올 수 onKeyEvent 수정자에 전달된 람다입니다.
키 입력은 두 가지 키 이벤트를 전송합니다. 하나는 사용자가 키를 누를 때 트리거됩니다. 다른 하나는 키가 해제될 때 트리거됩니다. KeyEvent 객체의 type 속성을 참조하여 두 가지 주요 이벤트를 구분할 수 있습니다.
onKeyEvent 람다의 반환 값은 키 이벤트가 처리되었는지 여부를 나타냅니다. 앱이 키 이벤트를 처리하는 경우 true를 반환하여 이벤트 전파를 중지합니다.
다음 스니펫은 doSomething() 함수를 호출하는 방법을 보여줍니다. 사용자가 Box 구성요소의 S 키를 놓을 때:
Box(
modifier = Modifier.focusable().onKeyEvent {
if(
it.type == KeyEventType.KeyUp &&
it.key == Key.S
) {
doSomething()
true
} else {
false
}
}
) {
Text("Press S key")
}
특수키
KeyEvent 객체에는 다음과 같습니다.
앱이 처리하는 주요 이벤트를 구체적으로 설명하세요. 다음 스니펫은 doSomething() 함수를 호출합니다. 사용자가 S 키만 놓는 경우에만 사용자가 Shift 키와 같은 수정자 키를 누르면 앱이 함수를 호출하지 않습니다.
Box(
modifier = Modifier.focusable().onKeyEvent{
if(
it.type == KeyEventType.KeyUp &&
it.key == Key.S &&
!it.isAltPressed &&
!it.isCtrlPressed &&
!it.isMetaPressed &&
!it.isShiftPressed
) {
doSomething()
true
} else {
false
}
}
) {
Text("Press S key with a modifier key")
}
스페이스바 및 Enter 키 클릭 이벤트
MoviePlayer(
modifier = Modifier.clickable { togglePausePlay() }
)
미소비 키 이벤트
소비되지 않은 키 이벤트가 구성요소에서 전파됨 이벤트를 발생한 위치를 주변을 둘러싼 외부 구성요소로 전달합니다. 아래 예에서 InnerComponent는 S 키가 해제될 때 키 이벤트를 소비하므로 OuterComponent는 S 키를 해제하여 트리거된 키 이벤트를 수신하지 않습니다. 따라서 actionB() 함수는 호출되지 않습니다.
InnerComponent의 다른 키 이벤트(예: D 키 해제)는 OuterComponent에서 처리할 수 있습니다. actionC() 함수가 호출됩니다. 이는 키 이벤트가 D 키를 놓으면 OuterComponent에 전파됩니다.
OuterComponent(
modifier = Modifier.onKeyEvent {
when {
it.type == KeyEventType.KeyUp && it.key == Key.S -> {
actionB() // This function is never called.
true
}
it.type == KeyEventType.KeyUp && it.key == Key.D -> {
actionC()
true
}
else -> false
}
}
) {
InnerComponent(
modifier = Modifier.onKeyEvent {
if(it.type == KeyEventType.KeyUp && it.key == Key.S) {
actionA()
true
} else {
false
}
}
)
}
on
경우에 따라 기본 작업을 트리거하기 전에 주요 이벤트를 가로채야 합니다. TextField에 맞춤 바로가기를 추가하는 것은 일반적인 작업입니다. 다음 스니펫을 사용하면 사용자가 탭 키를 눌러 포커스를 받을 수 있는 다음 구성요소로 이동할 수 있습니다.
val focusManager = LocalFocusManager.current
var textFieldValue by remember { mutableStateOf(TextFieldValue()) }
TextField(
textFieldValue,
onValueChange = {
textFieldValue = it
},
modifier = Modifier.onPreviewKeyEvent {
if (it.type == KeyEventType.KeyUp && it.key == Key.Tab) {
focusManager.moveFocus(FocusDirection.Next)
true
} else {
false
}
}
)
