Salesforce Console Developer Guide
j
No Results
Search Tips:
- Please consider misspellings
- Try different search keywords
updateUtility() for Lightning Experience
Specifies a label and icon on the utility bar, and sets a utility as highlighted.
This method is available for Lightning Web Components (LWC) only.
Arguments
Optional parameters are passed into an object as the last argument of the method.
| Name | Type | Description |
|---|---|---|
| utilityId | string | The ID of the utility to update. |
| utilityAttrs | object | Optional. Attributes that specify the appearance of the icon.
|
), warning (
), and error (
).LWC Sample Code
Before you can use the LWC utility bar API, Lightning Web Security must be enabled.
This component opens a utility using the enclosing utility ID.
import { LightningElement, wire } from 'lwc';
import { updateUtility, EnclosingUtilityId } from 'lightning/platformUtilityBarApi';
export default class UpdatePanelExample extends LightningElement {
@wire(EnclosingUtilityId) utilityId;
utilityAttrs = {
label: 'Account Insights',
icon: 'einstein',
iconVariant: 'success',
highlighted: true
}
handleUpdate() {
if (this.utilityId) {
return updateUtility(this.utilityId, this.utilityAttrs);
}
}
}To make your component available for use in a utility bar, specify the lightning__UtilityBar target in the component’s configuration file.
Response
Returns a promise that resolves to true if successful. The promise is rejected on error.