65 lines
2.9 KiB
Markdown
65 lines
2.9 KiB
Markdown
## Class: TouchBarScrubber
|
|
|
|
> Create a scrubber (a scrollable selector)
|
|
|
|
Process: [Main](../tutorial/application-architecture.md#main-and-renderer-processes)
|
|
|
|
### `new TouchBarScrubber(options)` _Experimental_
|
|
|
|
* `options` Object
|
|
* `items` [ScrubberItem[]](structures/scrubber-item.md) - An array of items to place in this scrubber.
|
|
* `select` Function (optional) - Called when the user taps an item that was not the last tapped item.
|
|
* `selectedIndex` Integer - The index of the item the user selected.
|
|
* `highlight` Function (optional) - Called when the user taps any item.
|
|
* `highlightedIndex` Integer - The index of the item the user touched.
|
|
* `selectedStyle` String (optional) - Selected item style. Can be `background`, `outline` or `none`. Defaults to `none`.
|
|
* `overlayStyle` String (optional) - Selected overlay item style. Can be `background`, `outline` or `none`. Defaults to `none`.
|
|
* `showArrowButtons` Boolean (optional) - Defaults to `false`.
|
|
* `mode` String (optional) - Can be `fixed` or `free`. The default is `free`.
|
|
* `continuous` Boolean (optional) - Defaults to `true`.
|
|
|
|
### Instance Properties
|
|
|
|
The following properties are available on instances of `TouchBarScrubber`:
|
|
|
|
#### `touchBarScrubber.items`
|
|
|
|
A `ScrubberItem[]` array representing the items in this scrubber. Updating this value immediately
|
|
updates the control in the touch bar. Updating deep properties inside this array **does not update the touch bar**.
|
|
|
|
#### `touchBarScrubber.selectedStyle`
|
|
|
|
A `String` representing the style that selected items in the scrubber should have. Updating this value immediately
|
|
updates the control in the touch bar. Possible values:
|
|
|
|
* `background` - Maps to `[NSScrubberSelectionStyle roundedBackgroundStyle]`.
|
|
* `outline` - Maps to `[NSScrubberSelectionStyle outlineOverlayStyle]`.
|
|
* `none` - Removes all styles.
|
|
|
|
#### `touchBarScrubber.overlayStyle`
|
|
|
|
A `String` representing the style that selected items in the scrubber should have. This style is overlayed on top
|
|
of the scrubber item instead of being placed behind it. Updating this value immediately updates the control in the
|
|
touch bar. Possible values:
|
|
|
|
* `background` - Maps to `[NSScrubberSelectionStyle roundedBackgroundStyle]`.
|
|
* `outline` - Maps to `[NSScrubberSelectionStyle outlineOverlayStyle]`.
|
|
* `none` - Removes all styles.
|
|
|
|
#### `touchBarScrubber.showArrowButtons`
|
|
|
|
A `Boolean` representing whether to show the left / right selection arrows in this scrubber. Updating this value
|
|
immediately updates the control in the touch bar.
|
|
|
|
#### `touchBarScrubber.mode`
|
|
|
|
A `String` representing the mode of this scrubber. Updating this value immediately
|
|
updates the control in the touch bar. Possible values:
|
|
|
|
* `fixed` - Maps to `NSScrubberModeFixed`.
|
|
* `free` - Maps to `NSScrubberModeFree`.
|
|
|
|
#### `touchBarScrubber.continuous`
|
|
|
|
A `Boolean` representing whether this scrubber is continuous or not. Updating this value immediately
|
|
updates the control in the touch bar.
|