Indicates whether or not the settings have been modified since the last call to saveAsync.
Adds a new event listener to the object. If this object does not support the specified eventType,
the method throws an exception.
The following table shows the event types supported by objects.
| object | eventType |
|---|---|
| Worksheet | FilterChanged , MarkSelectionChanged, SummaryDataChanged |
| Parameter | ParameterChanged |
| Settings | SettingsChanged |
| Dashboard | DashboardLayoutChanged, WorkbookFormattingChanged |
The type of event to register for. The type of event is a TableauEventType enumeration.
The function which will be called when an event happens.
A helper function which can be called to remove this registration.
The following example sets up a listener in a worksheet for a mark selection event (MarkSelectionChanged).
When the event occurs, the data is reloaded. The addEventListener method returns a function that un-registers
the event handler. Call that function, in this case, unregisterEventHandlerFunction() to remove the registration.
// Add an event listener for the selection changed event on this sheet.
// Assigning the event to a variable just to make the example fit on the page here.
const markSelection = tableau.TableauEventType.MarkSelectionChanged;
//
unregisterEventHandlerFunction = worksheet.addEventListener(markSelection, function (selectionEvent) {
// When the selection changes, reload the data
loadSelectedMarks(worksheetName);
});
// remove the event listener when done
unregisterEventHandlerFunction();
Erases a settings key / value pair. If key isn't found, nothing happens.
The key of the pair to erase.
Gets a settings value or undefined if the value does not exist.
The key to retrieve.
The value or undefined if it does not exist.
Returns a copy of all the saved settings keys and values. Modifying this value will have no effect on the class.
All the saved settings keys and values in a dictionary.
Removes an event listener if a matching one is found. If no matching listener exists, the method does nothing.
The handler function must the handler function specified in the call to the addEventListener method. Alternatively, use the function
returned from the call to addEventListener to unregister the event listener.
For more information, see Events and Event Handling.
Whether or not an event listener was removed.
Attempts to persist any currently modified settings key-value pairs. The saveAsync() method
should only be called in authoring mode.
Promise containing the newly saved settings values.
tableau.extensions.settings.saveAsync().then(result => {
console.log('Settings saved.');
// ... process results
}).catch((error) => {
// ...
// ... code for error handling
});
Adds or updates a settings key / value pair.
The key to save.
The value to save.
The settings namespace is used to get and set settings values. You can use the settings to configure your extension. The setting values are be persisted in a workbook.