Class: TouchBarButton

Class: TouchBarButton

네이티브 macOS 애플리케이션을 위한 터치 바에 버튼을 생성한다.

프로세스: 메인
이 클래스는 'electron' 모듈에서 직접 내보내지 않는다. Electron API의 다른 메서드의 반환값으로만 사용할 수 있다.

new TouchBarButton(options)

• options Object
  • label string (선택 사항) - 버튼에 표시할 텍스트.
  • accessibilityLabel string (선택 사항) - VoiceOver와 같은 스크린 리더에서 사용할 버튼에 대한 간단한 설명.
  • backgroundColor string (선택 사항) - 버튼의 배경색을 16진수 형식으로 지정. 예: #ABCDEF.
  • icon NativeImage | string (선택 사항) - 버튼에 표시할 아이콘.
  • iconPosition string (선택 사항) - 아이콘의 위치를 지정. left, right, overlay 중 하나를 선택할 수 있으며, 기본값은 overlay.
  • click Function (선택 사항) - 버튼이 클릭되었을 때 호출할 함수.
  • enabled boolean (선택 사항) - 버튼의 활성화 상태를 지정. 기본값은 true.

accessibilityLabel을 정의할 때는 macOS의 모범 사례를 고려해야 한다.

인스턴스 속성

TouchBarButton 인스턴스에서 사용할 수 있는 속성은 다음과 같다:

touchBarButton.accessibilityLabel

화면 읽기 프로그램이 읽을 버튼 설명을 나타내는 문자열이다. 라벨이 설정되지 않은 경우에만 화면 읽기 프로그램이 이 값을 읽는다.

touchBarButton.label은 터치 바에 있는 버튼의 현재 텍스트를 나타내는 문자열이다. 이 값을 변경하면 터치 바의 버튼이 즉시 업데이트된다.

touchBarButton.backgroundColor

이 속성은 터치 바 버튼의 현재 배경색을 나타내는 16진수 코드 string 값이다. 이 값을 변경하면 터치 바의 버튼 배경색이 즉시 업데이트된다.

touchBarButton.icon은 버튼의 현재 아이콘을 나타내는 NativeImage 타입의 속성이다. 이 값을 변경하면 터치 바에 있는 버튼이 즉시 업데이트된다.

touchBarButton.iconPosition

string 타입으로, left, right, overlay 중 하나의 값을 가진다. 기본값은 overlay이다.

touchBarButton.enabled

버튼이 활성화된 상태인지 여부를 나타내는 불리언 값이다.