跳到主要内容

类: TouchBarButton

类: TouchBarButton

在原生 macOS 应用程序的触控栏中创建一个按钮

进程: 主进程
此类不是从 'electron' 模块导出的。它仅作为 Electron API 中其他方法的返回值提供。

new TouchBarButton(options)

  • options 对象
    • label string (可选) - 按钮文本。
    • accessibilityLabel string (可选) - 按钮的简短描述,供 VoiceOver 等屏幕阅读器使用。
    • backgroundColor string (可选) - 十六进制格式的按钮背景颜色,例如 #ABCDEF
    • icon NativeImage | string (可选) - 按钮图标。
    • iconPosition string (可选) - 可以是 leftrightoverlay。 默认为 overlay
    • click 函数 (可选) - 单击按钮时调用的函数。
    • enabled boolean (可选) - 按钮是否处于启用状态。 默认为 true

定义 accessibilityLabel 时,请确保您已考虑 macOS 最佳实践

实例属性

以下属性在 TouchBarButton 的实例上可用

touchBarButton.accessibilityLabel

一个 string,表示屏幕阅读器要读取的按钮描述。 仅当未设置标签时,屏幕阅读器才会读取。

touchBarButton.label

一个 string,表示按钮的当前文本。 更改此值会立即更新触控栏中的按钮。

touchBarButton.backgroundColor

一个 string 十六进制代码,表示按钮的当前背景颜色。 更改此值会立即更新触控栏中的按钮。

touchBarButton.icon

一个 NativeImage,表示按钮的当前图标。 更改此值会立即更新触控栏中的按钮。

touchBarButton.iconPosition

一个 string - 可以是 leftrightoverlay。 默认为 overlay

touchBarButton.enabled

一个 boolean,表示按钮是否处于启用状态。