辅助功能

Electron 应用中有关辅助功能的开发和网站是相似的,因为两者最终使用的都是HTML.

手动启用辅助功能

当辅助技术存在时,Electron 应用程序将自动启用辅助功能(例如 Windows 上的 JAWS 或 macOS 上的 VoiceOver)。 有关详细信息, 请参阅 Chrome 的 辅助功能文档

还可以在 Electron 应用程序或在第三方本地软件中设置标志来手动切换这些功能。

使用 Electron 的 API

通过使用 app.setAccessibilitySupportEnabled(enabled) API,您可以在应用程序首选项中的手动向用户暴露Chrome的访问树。 请注意,用户的系统辅助工具优先于此设置并将覆盖它。

在第三方软件内

macOS

在 macOS 的 Electron 应用中,可以通过 AXManualAccessibility 来切换第三方的辅助功能:

使用 Objective-C:

  1. CFStringRef kAXManualAccessibility = CFSTR("AXManualAccessibility");
  2. + (void)enableAccessibility:(BOOL)enable inElectronApplication:(NSRunningApplication *)app
  3. {
  4. AXUIElementRef appRef = AXUIElementCreateApplication(app.processIdentifier);
  5. if (appRef == nil)
  6. return;
  7. CFBooleanRef value = enable ? kCFBooleanTrue : kCFBooleanFalse;
  8. AXUIElementSetAttributeValue(appRef, kAXManualAccessibility, value);
  9. CFRelease(appRef);
  10. }

使用 Swift:

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