跳至主要內容

類別: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

表示按鈕是否處於啟用狀態的 布林值