Skip to main content

Class: TouchBarScrubber

Class: TouchBarScrubber

스크러버(스크롤 가능한 선택기)를 생성한다.

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

new TouchBarScrubber(options)

  • options Object
    • items ScrubberItem[] - 이 스크러버에 배치할 아이템 배열.
    • select Function (선택 사항) - 사용자가 마지막으로 탭한 아이템이 아닌 다른 아이템을 탭할 때 호출되는 함수.
      • selectedIndex Integer - 사용자가 선택한 아이템의 인덱스.
    • highlight Function (선택 사항) - 사용자가 어떤 아이템을 탭할 때 호출되는 함수.
      • highlightedIndex Integer - 사용자가 탭한 아이템의 인덱스.
    • selectedStyle string (선택 사항) - 선택된 아이템의 스타일. background, outline, none 중 하나를 지정할 수 있다. 기본값은 none.
    • overlayStyle string (선택 사항) - 선택된 오버레이 아이템의 스타일. background, outline, none 중 하나를 지정할 수 있다. 기본값은 none.
    • showArrowButtons boolean (선택 사항) - 화살표 버튼을 표시할지 여부. 기본값은 false이며, items가 비어 있지 않은 경우에만 표시된다.
    • mode string (선택 사항) - fixed 또는 free로 설정할 수 있다. 기본값은 free.
    • continuous boolean (선택 사항) - 기본값은 true.

인스턴스 속성

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

touchBarScrubber.items

이 속성은 스크러버에 표시되는 항목들을 ScrubberItem[] 배열로 나타낸다. 이 값을 업데이트하면 즉시 터치 바의 컨트롤이 업데이트된다. 단, 이 배열 내부의 깊은 속성들을 업데이트해도 터치 바는 업데이트되지 않는다.

touchBarScrubber.selectedStyle

스크러버에서 선택된 항목의 스타일을 나타내는 문자열이다. 이 값을 업데이트하면 터치 바의 컨트롤이 즉시 변경된다. 가능한 값은 다음과 같다:

  • background - [NSScrubberSelectionStyle roundedBackgroundStyle]에 매핑된다.
  • outline - [NSScrubberSelectionStyle outlineOverlayStyle]에 매핑된다.
  • none - 모든 스타일을 제거한다.

touchBarScrubber.overlayStyle

스크러버에서 선택된 항목에 적용할 스타일을 나타내는 문자열이다. 이 스타일은 스크러버 항목 뒤가 아닌 위에 오버레이로 표시된다. 이 값을 업데이트하면 터치 바의 컨트롤이 즉시 업데이트된다. 가능한 값은 다음과 같다:

  • background - [NSScrubberSelectionStyle roundedBackgroundStyle]에 매핑된다.
  • outline - [NSScrubberSelectionStyle outlineOverlayStyle]에 매핑된다.
  • none - 모든 스타일을 제거한다.

touchBarScrubber.showArrowButtons

이 속성은 스크러버에 좌우 선택 화살표를 표시할지 여부를 나타내는 불리언 값이다. 이 값을 변경하면 터치 바의 컨트롤이 즉시 업데이트된다.

touchBarScrubber.mode

이 속성은 스크러버의 모드를 나타내는 문자열이다. 이 값을 업데이트하면 터치 바의 컨트롤이 즉시 변경된다. 가능한 값은 다음과 같다:

  • fixed - NSScrubberModeFixed에 매핑된다.
  • free - NSScrubberModeFree에 매핑된다.

touchBarScrubber.continuous는 스크러버가 연속적인지 여부를 나타내는 불리언 값이다. 이 값을 업데이트하면 즉시 터치 바의 컨트롤이 업데이트된다.