可访问性
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")")