updatePanel() for Lightning Experience

Specifies a label and icon on the utility panel, and provides a height and width for the panel. This method is available for Lightning Web Components (LWC) only.

Optional parameters are passed into an object as the last argument of the method.

NameTypeDescription
utilityIdstringThe ID of the utility panel to update.
panelAttrsobjectOptional. Attributes that specify the appearance of the panel.
  • label—The label of the utility that’s displayed in the panel header.
  • icon—The Lightning Design System (SLDS) name of the icon in the format einstein, where einstein is the name of the SLDS utility icon. The icon is displayed in the utility panel header. See a full list of utility icon keys at the SLDS reference site. SLDS doctype, standard, custom, and action icons aren’t supported.
  • iconVariant—The variant changes the color of the utility panel icon. Available variants are success (green success color), warning (yellow warning color), and error (red error color).
  • height—The height of the utility panel in pixels.
  • heightTransition—An object that describes the CSS transition for the utility panel’s height. See the heightTransition section.
  • width—The width of the utility panel in pixels.
  • widthTransition—An object that describes the CSS transition for the utility panel’s width. See the widthTransition section.

An optional object that describes the CSS transition for the utility panel’s height. Pass this object to panelAttrs and use with height. Optional arguments include:

  • durationMs—The time in milliseconds. It takes for the height transition to complete. The default value is 0.
  • timingFunction—The transition timing function that sets the rate for panel height changes. Applies any CSS easing function that’s supported by your target browser. The default value is ease.
  • delayMs—The wait time in milliseconds before the height transition starts. The default value is 0.

An optional object that describes the CSS transition for the utility panel’s width. Pass this object to panelAttrs and use with width. Optional arguments include:

  • durationMs—The time in milliseconds. It takes for the width transition to complete. The default value is 0.
  • timingFunction—The transition timing function that sets the rate for panel width changes. Applies any CSS easing function that’s supported by your target browser. The default value is ease.
  • delayMs—The wait time in milliseconds before the width transition starts. The default value is 0.

This component opens a utility using the enclosing utility ID.

To make your component available for use in a utility bar, specify the lightning__UtilityBar target in the component’s configuration file.

Returns a promise that resolves to true if successful. The promise is rejected on error.