키보드 탐색 지원

Compose 방식 사용해 보기
Jetpack Compose는 Android의 권장 UI 도구 키트입니다. Compose에서 터치 및 입력을 사용하는 방법을 알아보세요.

Android는 터치 키보드와 같은 소프트 입력 방법 외에도 기기에 연결된 물리적 키보드도 지원합니다. 키보드는 편리한 텍스트 입력 방법을 제공할 뿐 아니라 사용자가 앱을 탐색하고 상호작용할 수 있는 방법도 됩니다. 스마트폰과 같은 대부분의 휴대기기는 터치를 기본 상호작용 모드로 사용하지만, 태블릿 및 이와 유사한 기기의 인기가 높아지면서 많은 사용자가 키보드 액세서리를 연결하기를 좋아합니다.

이러한 환경을 제공하는 Android 지원 기기가 늘어남에 따라 키보드를 통한 상호작용을 지원하도록 앱을 최적화하는 것이 중요합니다. 이 문서에서는 키보드를 사용하여 탐색을 개선하는 방법을 설명합니다.

앱 테스트

Android 시스템은 필요한 대부분의 동작을 기본적으로 사용 설정하므로 사용자가 키보드를 사용하여 앱을 탐색할 수 있습니다.

Android 프레임워크에서 제공하는 모든 대화형 위젯(예: ButtonEditText)에 포커스를 둘 수 있습니다. 따라서, 사용자는 D패드나 키보드 같은 컨트롤 기기를 사용해 탐색할 수 있으며 각 위젯은 입력 포커스를 받으면 발광하거나 모양이 바뀝니다.

앱을 테스트하려면 다음 절차를 따르세요.

  1. 하드웨어 키보드를 제공하는 기기에 앱을 설치합니다.

    키보드가 있는 하드웨어 기기가 없는 경우에는 블루투스 키보드나 USB 키보드를 연결하세요.

    다음과 같은 방법으로 Android 에뮬레이터를 사용할 수도 있습니다.

    1. AVD Manager에서 New Device 를 클릭하거나 기존 프로필을 선택한 후 Clone 을 클릭합니다.
    2. 창이 나타나면 KeyboardDPad 가 사용 설정되었는지 확인합니다.
  2. 앱을 테스트하려면 Tab 키만 사용하여 UI를 탐색합니다. 각 UI 컨트롤에 예상대로 포커스가 맞춰지는지 확인합니다.

    포커스가 예상치 못한 방식으로 이동하는 인스턴스를 찾습니다.

  3. 앱의 시작 부분부터 다시 시작하여 키보드의 화살표 키와 같은 방향 컨트롤을 사용하여 UI를 탐색합니다. UI의 각 포커스 요소에서 Up, Down, Left, Right를 누릅니다.

    포커스가 예상치 못한 방식으로 이동하는 인스턴스를 찾습니다.

Tab 키 또는 방향 컨트롤을 사용하여 탐색할 때 예상대로 작동하지 않는 인스턴스가 발생하면 다음 섹션에서 설명한 대로 레이아웃에서 포커스가 있어야 하는 위치를 지정합니다.

탭 탐색 처리하기

사용자가 키보드 Tab 키를 사용해 앱을 탐색할 때 시스템에서는 입력 포커스가 레이아웃에 나타나는 순서에 따라 입력 포커스를 요소 사이에 전달합니다. 예를 들어 상대적 레이아웃을 사용하는데 화면 요소의 순서가 파일에서의 순서와 다르면 수동으로 포커스 순서를 지정해야 할 수 있습니다.

예를 들어 다음 레이아웃에서 두 개의 버튼이 오른쪽에 정렬되고 텍스트 필드가 두 번째 버튼의 왼쪽에 정렬됩니다. 첫 번째 버튼에서 텍스트 필드로, 그런 다음 두 번째 버튼으로 포커스를 전달하기 위해서는 레이아웃에서 포커스 가능한 각 요소의 포커스 순서를 android:nextFocusForward 속성으로 명시적으로 정의해야 합니다.

<androidx.constraintlayout.widget.ConstraintLayout ...>
    <Button
        android:id="@+id/button1"
        android:nextFocusForward="@+id/editText1"
        app:layout_constraintRight_toRightOf="parent"
        app:layout_constraintTop_toTopOf="parent"
        ... />
    <Button
        android:id="@+id/button2"
        android:nextFocusForward="@+id/button1"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintTop_toBottomOf="@id/button1"
        ... />
    <EditText
        android:id="@id/editText1"
        android:nextFocusForward="@+id/button2"
        app:layout_constraintBottom_toBottomOf="@+id/button2"
        app:layout_constraintRight_toLeftOf="@id/button2
        ...  />
    ...
</androidx.constraintlayout.widget.ConstraintLayout>

이제 포커스가 button1에서 button2로, 그런 다음 editText1로 이동하는 대신 화면에 표시되는 대로 button1에서 editText1로, 그런 다음 button2로 적절하게 이동합니다.

방향 탐색 처리

사용자는 키보드의 화살표 키를 사용하여 앱을 탐색할 수도 있습니다. 이는 D패드나 트랙볼을 사용해 탐색할 때와 동일하게 동작합니다. 시스템에서는 특정 방향으로 포커스를 맞춰야 할 뷰와 관련하여 화면에 나타나는 뷰의 레이아웃에 기반하여 '최선의 추측'을 제공합니다. 하지만 시스템이 잘못 추측하는 경우도 있습니다.

특정 방향으로 탐색할 때 시스템이 적절한 뷰에 포커스를 전달하지 않으면 다음 속성을 사용하여 포커스를 받아야 하는 뷰를 지정합니다.

각 속성은 사용자가 특정 방향으로 탐색할 때 뷰 ID에 지정된 대로 포커스를 받을 다음 뷰를 지정합니다. 다음 예에 나와 있습니다.

<Button
    android:id="@+id/button1"
    android:nextFocusRight="@+id/button2"
    android:nextFocusDown="@+id/editText1"
    ... />
<Button
    android:id="@id/button2"
    android:nextFocusLeft="@id/button1"
    android:nextFocusDown="@id/editText1"
    ... />
<EditText
    android:id="@id/editText1"
    android:nextFocusUp="@id/button1"
    ...  />

추가 리소스

다음 관련 리소스를 참조하세요.