跳至主要內容

輔助功能

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