支援桌面無障礙功能

Compose Multiplatform 建構於 [Jetpack Compose](https://developer.android.com/jetpack/compose 之上，使得大多數無障礙功能可在所有平台上的共同程式碼中取得。目前桌面無障礙支援的狀態如下：

平台	無障礙支援狀態
MacOS	完全支援
Windows	透過 Java 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」文字：

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)
        }
    }
}

.semantics(mergeDescendants = true)"}

若要在 macOS 上測試應用程式中元素的無障礙資訊，您可以使用 Accessibility Inspector （Xcode | Open Developer Tool | Accessibility Inspector）：

在 Windows 上，您可以使用 JAWS 中的 Show Speech History 功能，或 NVDA 中的 Speech Viewer：

更多範例，請參考 Accessibility in Jetpack Compose 指南。

接下來？

探索關於其他桌面元件的教學。

支援桌面無障礙功能 ​

在 Windows 上啟用無障礙功能 ​

範例：具有語義規則的自訂按鈕 ​

接下來？ ​

支援桌面無障礙功能

在 Windows 上啟用無障礙功能

範例：具有語義規則的自訂按鈕

接下來？