跳到主要内容

类: TouchBarButton

类: TouchBarButton

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

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

new TouchBarButton(options)

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

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

实例属性

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

touchBarButton.accessibilityLabel

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

touchBarButton.label

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

touchBarButton.backgroundColor

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

touchBarButton.icon

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

touchBarButton.iconPosition

一个 字符串 - 可以是 leftrightoverlay。默认为 overlay

touchBarButton.enabled

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