2017-03-03 17:54:46 +00:00
## Class: TouchBarLabel
> Create a label in the touch bar for native macOS applications
2021-06-15 20:50:31 +00:00
Process: [Main ](../glossary.md#main-process )< br />
_This class is not exported from the `'electron'` module. It is only available as a return value of other methods in the Electron API._
2017-03-03 17:54:46 +00:00
2020-04-02 16:32:18 +00:00
### `new TouchBarLabel(options)`
2017-03-03 17:54:46 +00:00
* `options` Object
2021-11-16 04:13:18 +00:00
* `label` string (optional) - Text to display.
* `accessibilityLabel` string (optional) - A short description of the button for use by screenreaders like VoiceOver.
* `textColor` string (optional) - Hex color of text, i.e `#ABCDEF` .
2017-03-03 17:54:46 +00:00
2019-10-08 15:13:57 +00:00
When defining `accessibilityLabel` , ensure you have considered macOS [best practices ](https://developer.apple.com/documentation/appkit/nsaccessibilitybutton/1524910-accessibilitylabel?language=objc ).
2017-03-03 17:54:46 +00:00
### Instance Properties
The following properties are available on instances of `TouchBarLabel` :
#### `touchBarLabel.label`
2021-11-16 04:13:18 +00:00
A `string` representing the label's current text. Changing this value immediately updates the label in
2017-03-03 17:54:46 +00:00
the touch bar.
2017-03-03 23:14:51 +00:00
2019-10-08 15:13:57 +00:00
#### `touchBarLabel.accessibilityLabel`
2021-11-16 04:13:18 +00:00
A `string` representing the description of the label to be read by a screen reader.
2019-10-08 15:13:57 +00:00
2017-03-03 23:14:51 +00:00
#### `touchBarLabel.textColor`
2021-11-16 04:13:18 +00:00
A `string` hex code representing the label's current text color. Changing this value immediately updates the
2017-03-03 23:14:51 +00:00
label in the touch bar.