Skip to content

데스크톱 접근성 기능 지원 ​

Compose Multiplatform은 Jetpack Compose를 기반으로 구축되어, 대부분의 접근성 기능을 모든 플랫폼의 공통 코드에서 사용할 수 있게 해줍니다. 현재 데스크톱의 접근성 지원 상태는 다음과 같습니다:

플랫폼접근성 상태
MacOS완전 지원
WindowsJava Access Bridge를 통해 지원
Linux지원되지 않음

Windows에서 접근성 사용 설정하기 ​

Windows의 접근성은 기본적으로 비활성화되어 있는 Java Access Bridge를 통해 제공됩니다. Windows에서 접근성 기능을 개발하려면 다음 명령어로 Java Access Bridge를 활성화하세요:

Console
%\JAVA_HOME%\bin\jabswitch.exe /enable

접근성 기능이 포함된 네이티브 배포판을 만들려면 modules DSL 메서드를 사용하여 jdk.accessibility 모듈을 추가하세요:

kotlin
compose.desktop {
    application {
        nativeDistributions {
            modules("jdk.accessibility")
        }
    }
}

예제: 시맨틱 규칙이 적용된 커스텀 버튼 ​

커스텀 버튼이 있는 간단한 앱을 만들고 스크린 리더 도구를 위한 설명 텍스트를 지정해 보겠습니다. 스크린 리더가 활성화된 상태에서 버튼 설명에 지정된 "Click to increment value" 텍스트를 들을 수 있습니다:

.clickable { count += 1 } .semantics(mergeDescendants = true) {...}
kotlin
import androidx.compose.foundation.*
import androidx.compose.foundation.layout.*
import androidx.compose.material.Text
import androidx.compose.runtime.*
import androidx.compose.ui.*
import androidx.compose.ui.graphics.Color
import androidx.compose.ui.semantics.*
import androidx.compose.ui.unit.*
import androidx.compose.ui.window.*

fun main() = singleWindowApplication(
    title = "Custom Button", state = WindowState(size = DpSize(300.dp, 200.dp))
) {
    var count by remember { mutableStateOf(0) }

    Box(modifier = Modifier.padding(50.dp)) {
        Box(modifier = Modifier
            .background(Color.LightGray)
            .fillMaxSize()
            .clickable { count += 1 }
            // 콘텐츠의 텍스트를 사용합니다
            .semantics(mergeDescendants = true) {
                // UI 요소의 유형을 할당합니다
                role = Role.Button
                // 버튼에 도움말 텍스트를 추가합니다
                contentDescription = "Click to increment value"
            }
        ) {
            val text = when (count) {
                0 -> "Click Me!"
                1 -> "Clicked"
                else -> "Clicked $count times"
            }
            Text(text, modifier = Modifier.align(Alignment.Center), fontSize = 24.sp)
        }
    }
}

macOS에서 애플리케이션 요소의 접근성 정보를 테스트하려면 Accessibility Inspector (Xcode | Open Developer Tool | Accessibility Inspector)를 사용할 수 있습니다:

Accessibility inspector on mcOS

Windows에서는 JAWS의 Show Speech History 기능이나 NVDA의 Speech Viewer를 사용할 수 있습니다:

Accessibility on Windows

더 많은 예제는 Accessibility in Jetpack Compose 가이드를 참고하세요.

다음 단계 ​

기타 데스크톱 컴포넌트에 대한 튜토리얼을 살펴보세요.