New and Changed Lightning Components

We added several new components and made improvements to others so that you can create apps faster.

New Components

The following components are new.

force:recordData (Beta)
Access, modify, create, or delete records in a component using Lightning Data Service. This component replaces force:recordPreview. For more information, see Lightning Data Service (Beta).
force:utilityBarAPIAccess (Pilot)
Provides access to the Lightning Console JavaScript API’s utility bar library of methods.
force:workspaceAPIAccess (Pilot)
Provides access to the Lightning Console JavaScript API’s workspace library of methods.
forceCommunity:appLauncher
Displays App Launcher in a Lightning component. For more information, see Add App Launcher and Notifications Components to Lightning Components in Communities.
forceCommunity:notifications
Displays the Notifications icon in a Lightning component. For more information, see Add App Launcher and Notifications Components to Lightning Components in Communities.
forceCommunity:waveDashboard
Adds a Wave Analytics dashboard to a community page. For more information, see Embed Wave Dashboards in Communities the Easy Way with Community Builder.
lightning:breadcrumb
An item in the hierarchy path of the page that the user is on.
lightning:breadcrumbs
A hierarchy path of the page the user is visiting within the website or app.
lightning:buttonStateful
A button that toggles between states.
lightning:relativeDateTime
Displays the time difference between the source date-time and the provided date-time. This component was previously named lightning:formattedRelative.
lightning:tile
A grouping of related information associated with a record.

Changed Components

The following components have changed.

force:recordPreview
This component has been deprecated. Use force:recordData instead. For more information, see Lightning Data Service (Beta).
force:recordEdit
This component now uses the Lightning Design System styling. Extend force:slds if you’re using force:recordEdit in a standalone app for the component to be styled correctly.
force:recordView
This component now uses the Lightning Design System styling. Extend force:slds if you’re using force:recordView in a standalone app for the component to be styled correctly.
lightning:avatar
The following attributes are new.
  • fallbackIconName—The Lightning Design System name of the icon used as a fallback when the image fails to load and initials are not provided. Names are written in the format '\standard:account\' where standard is the category, and account is the icon to display. Only icons from the standard and custom categories are allowed. An error message is printed in the browser console if you’re using an icon that’s not part of the standard or custom category.
  • initials—If the record name contains two words, like first and last name, use the first capitalized letter of each. For records that only have a single word name, use the first two letters of that word using one capital and one lowercase letter.
lightning:buttonMenu (Beta)
The following attribute has changed.
  • menuAlignment—These values are new: bottom-left, bottom-center, and bottom-right.
lightning:card
The following attribute has changed.
  • title—The attribute type has been changed from Component[] to Object.
  • footer—The attribute type has been changed from Component[] to Object.
lightning:icon
The following attribute has changed.
  • variant—The bare variant has been renamed inverse. The bare variant still works, but it will be deprecated in the near future.
lightning:input (Beta)
The following attributes are new.
  • isLoading—Specifies whether the spinner is displayed to indicate that data is loading. The default is false.
  • messageToggleActive—Text shown for the active state of a toggle. The default is Active.
  • messageToggleInactive—Text shown for the inactive state of a toggle. The default is Inactive.
  • variant—The variant changes the appearance of an input field. The values are standard and label-hidden. The default is standard.
The following types have changed.
  • search—The onchange event is fired when you press the clear button.
lightning:inputRichText (Beta)
This component now supports HTML tags that correspond to the toolbar, including tags for formatting bold, underline, italics, and strikethrough text among others. Although the toolbar doesn’t support formatting for tables, links, and images, the corresponding HTML tags are supported.
The following attributes are new.
  • messageWhenBadInput—Error message that’s displayed when valid is false.
  • variant—The variant, bottom-toolbar, changes the appearance of the toolbar.
lightning:menuItem (Beta)
The following attribute has changed.
  • onactive—Deprecated. The onactive attribute still works, but it will no longer be usable in the near future. Use the onselect attribute in the lightning:buttonMenu component instead. event.getParam("value") returns the value of the selected menu item.
lightning:select
The following attribute is new.
  • variant—The variant changes the appearance of an input field. Accepted variants include standard and label-hidden. The default is standard.
lightning:textarea
The following attribute is new.
  • variant—The variant changes the appearance of an input field. Accepted variants include standard and label-hidden. The default is standard.
lightning:tile
The following attribute is new.
  • media—The icon or figure displayed next to the textual information.
ui:inputDate
The date picker displays the Today link. Press the link to set today’s date on the date field.
The langLocale attribute has been deprecated.
  • langLocale—Deprecated. The validation for the langLocale attribute has also been tightened to allow langLocale values to only match the user’s Language or Locale settings in Salesforce. If the langLocale attribute is set to another value, it defaults to the user’s Language setting.

    For related locale changes in several AuraLocalizationService methods, see Deprecated locale Parameter in AuraLocalizationService JavaScript API Methods.

ui:inputDateTime
The date picker displays the Today link. Press the link to set today’s date on the date field.
The langLocale attribute has been deprecated.
  • langLocale—Deprecated. The validation for the langLocale attribute has also been tightened to allow langLocale values to only match the user’s Language or Locale settings in Salesforce. If the langLocale attribute is set to another value, it defaults to the user’s Language setting.

    For related locale changes in several AuraLocalizationService methods, see Deprecated locale Parameter in AuraLocalizationService JavaScript API Methods.

ui:outputDate
The langLocale attribute has been deprecated.
  • langLocale—Deprecated. The validation for the langLocale attribute has also been tightened to allow langLocale values to only match the user’s Language or Locale settings in Salesforce. If the langLocale attribute is set to another value, it defaults to the user’s Language setting.

    For related locale changes in several AuraLocalizationService methods, see Deprecated locale Parameter in AuraLocalizationService JavaScript API Methods.

ui:outputDateTime
The langLocale attribute has been deprecated.
  • langLocale—Deprecated. The validation for the langLocale attribute has also been tightened to allow langLocale values to only match the user’s Language or Locale settings in Salesforce. If the langLocale attribute is set to another value, it defaults to the user’s Language setting.

    For related locale changes in several AuraLocalizationService methods, see Deprecated locale Parameter in AuraLocalizationService JavaScript API Methods.

ui:scrollerWrapper
The following method is new.
  • scrollTo(destination, xcoord, ycoord)—Scrolls the content to a specified location.
    • destination—The target location. Valid values: custom, top, bottom, left, and right. For custom destination, xcoord and ycoord are used to determine the target location.
    • xcoord—X coordinate for the custom destination. The default is 0.
    • ycoord—Y coordinate for the custom destination. The default is 0.