跳到主要內容

無障礙功能

Electron 應用程式中的無障礙功能考量與網站類似，因為它們最終都是 HTML。

手動啟用無障礙功能​

當輔助技術存在時（例如 Windows 上的 JAWS 或 macOS 上的 VoiceOver），Electron 應用程式將自動啟用無障礙功能。有關更多詳細資訊，請參閱 Chrome 的 無障礙功能文件。

您也可以在 Electron 應用程式內或通過在第三方原生軟體中設定標誌來手動切換這些功能。

使用 Electron 的 API​

通過使用 app.setAccessibilitySupportEnabled(enabled) API，您可以手動在應用程式偏好設定中向使用者公開 Chrome 的無障礙功能樹狀結構。請注意，使用者的系統輔助工具優先於此設定，並將覆蓋它。

在第三方軟體中​

macOS​

在 macOS 上，第三方輔助技術可以通過程式化設定 AXManualAccessibility 屬性來切換 Electron 應用程式內的無障礙功能

使用 Objective-C

CFStringRef kAXManualAccessibility = CFSTR("AXManualAccessibility");

+ (void)enableAccessibility:(BOOL)enable inElectronApplication:(NSRunningApplication *)app
{
    AXUIElementRef appRef = AXUIElementCreateApplication(app.processIdentifier);
    if (appRef == nil)
        return;

    CFBooleanRef value = enable ? kCFBooleanTrue : kCFBooleanFalse;
    AXUIElementSetAttributeValue(appRef, kAXManualAccessibility, value);
    CFRelease(appRef);
}

使用 Swift

import Cocoa
let name = CommandLine.arguments.count >= 2 ? CommandLine.arguments[1] : "Electron"
let pid = NSWorkspace.shared.runningApplications.first(where: {$0.localizedName == name})!.processIdentifier
let axApp = AXUIElementCreateApplication(pid)
let result = AXUIElementSetAttributeValue(axApp, "AXManualAccessibility" as CFString, true as CFTypeRef)
print("Setting 'AXManualAccessibility' \(error.rawValue == 0 ? "succeeded" : "failed")")