跳转到主要内容

辅助功能

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