2017-03-03 09:54:46 -08:00
|
|
|
## Class: TouchBarButton
|
|
|
|
|
|
|
|
|
|
> Create a button in the touch bar for native macOS applications
|
|
|
|
|
|
2018-04-09 17:58:10 -03:00
|
|
|
Process: [Main](../tutorial/application-architecture.md#main-and-renderer-processes)
|
2017-03-03 09:54:46 -08:00
|
|
|
|
2017-03-17 10:38:15 -07:00
|
|
|
### `new TouchBarButton(options)` _Experimental_
|
2017-03-03 09:54:46 -08:00
|
|
|
|
|
|
|
|
* `options` Object
|
|
|
|
|
* `label` String (optional) - Button text.
|
|
|
|
|
* `backgroundColor` String (optional) - Button background color in hex format,
|
|
|
|
|
i.e `#ABCDEF`.
|
2019-07-25 11:30:42 -07:00
|
|
|
* `icon` [NativeImage](native-image.md) | String (optional) - Button icon.
|
2019-08-01 16:59:26 +02:00
|
|
|
* `iconPosition` String (optional) - Can be `left`, `right` or `overlay`. Defaults to `overlay`.
|
2017-03-03 09:54:46 -08:00
|
|
|
* `click` Function (optional) - Function to call when the button is clicked.
|
|
|
|
|
|
|
|
|
|
### Instance Properties
|
|
|
|
|
|
|
|
|
|
The following properties are available on instances of `TouchBarButton`:
|
|
|
|
|
|
|
|
|
|
#### `touchBarButton.label`
|
|
|
|
|
|
2017-03-04 16:14:41 +11:00
|
|
|
A `String` representing the button's current text. Changing this value immediately updates the button
|
2017-03-03 09:54:46 -08:00
|
|
|
in the touch bar.
|
|
|
|
|
|
|
|
|
|
#### `touchBarButton.backgroundColor`
|
|
|
|
|
|
2017-03-04 16:14:41 +11:00
|
|
|
A `String` hex code representing the button's current background color. Changing this value immediately updates
|
2017-03-03 09:54:46 -08:00
|
|
|
the button in the touch bar.
|
|
|
|
|
|
|
|
|
|
#### `touchBarButton.icon`
|
|
|
|
|
|
2017-03-04 16:14:41 +11:00
|
|
|
A `NativeImage` representing the button's current icon. Changing this value immediately updates the button
|
2017-03-03 09:54:46 -08:00
|
|
|
in the touch bar.
|
