lightning-base-components 1.21.3-alpha → 1.21.5-alpha

package/metadata/raptor.json

@@ -672,10 +672,12 @@
     ]
   },
   "commerceApi": {},
+  "commerceCatalogManagementApi": {},
   "commerceChannelManagementApi": {},
   "commerceConfigurationApi": {},
   "commerceEsfApi": {},
   "commerceExtensionApi": {},
+  "commerceGoalsAndRecommendationsApi": {},
   "commerceManagementApi": {},
   "commerceStoreManagementApi": {},
   "communityInfoApi": {},
@@ -1025,6 +1027,9 @@
       }
     ],
     "methods": [
+      {
+        "name": "focus"
+      },
       {
         "name": "reportValidity"
       },
@@ -1746,6 +1751,7 @@
   "industriesNlpServiceApi": {},
   "industriesOmnianalyticsApi": {},
   "industriesPricingApi": {},
+  "industriesProgramMgmtApi": {},
   "industriesPublicSectorApi": {},
   "industriesRcgTenantmanagementApi": {},
   "industriesReminderApi": {},
@@ -1756,6 +1762,7 @@
   "industriesServiceExcellenceApi": {},
   "industriesServiceprocessApi": {},
   "industriesSustainabilityBeiApi": {},
+  "industriesSustainabilityCsvAttachApi": {},
   "industriesSustainabilityDgfApi": {},
   "industriesSustainabilityRecalculateApi": {},
   "industriesSustainabilityRecordLockUnlockApi": {},
@@ -2022,6 +2029,9 @@
       {
         "name": "showAddressLookup"
       },
+      {
+        "name": "showCompactAddress"
+      },
       {
         "name": "street"
       },
@@ -2031,6 +2041,15 @@
       {
         "name": "streetPlaceholder"
       },
+      {
+        "name": "subpremise"
+      },
+      {
+        "name": "subpremiseLabel"
+      },
+      {
+        "name": "subpremisePlaceholder"
+      },
       {
         "name": "validity"
       },
@@ -2476,6 +2495,12 @@
   "lookupAddress": {
     "slotNames": [],
     "properties": [
+      {
+        "name": "alwaysRender"
+      },
+      {
+        "name": "autocomplete"
+      },
       {
         "name": "disabled"
       },
@@ -2485,9 +2510,15 @@
       {
         "name": "label"
       },
+      {
+        "name": "name"
+      },
       {
         "name": "placeholder"
       },
+      {
+        "name": "required"
+      },
       {
         "name": "variant"
       }
@@ -3055,6 +3086,9 @@
   "platformShowToastEvent": {
     "minVersion": "45.0"
   },
+  "platformUtilityBarApi": {
+    "minVersion": "61.0"
+  },
   "platformWorkspaceApi": {
     "minVersion": "59.0"
   },
@@ -5149,6 +5183,11 @@
       {
         "name": "name"
       }
+    ],
+    "staticProperties": [
+      {
+        "name": "validationOptOut"
+      }
     ]
   },
   "verticalNavigationItemBadge": {
@@ -5170,6 +5209,11 @@
       {
         "name": "name"
       }
+    ],
+    "staticProperties": [
+      {
+        "name": "validationOptOut"
+      }
     ]
   },
   "verticalNavigationItemIcon": {
@@ -5188,6 +5232,11 @@
       {
         "name": "name"
       }
+    ],
+    "staticProperties": [
+      {
+        "name": "validationOptOut"
+      }
     ]
   },
   "verticalNavigationOverflow": {

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "lightning-base-components",
-    "version": "1.21.3-alpha",
+    "version": "1.21.5-alpha",
     "license": "MIT",
     "files": [
         "external",
@@ -70,6 +70,30 @@
                 "name": "@salesforce/label/LightningForm.reload",
                 "path": "scopedImports/@salesforce-label-LightningForm.reload.js"
             },
+            {
+                "name": "@salesforce/label/LightningForm.generalDependentFieldsMessage",
+                "path": "scopedImports/@salesforce-label-LightningForm.generalDependentFieldsMessage.js"
+            },
+            {
+                "name": "@salesforce/label/LightningForm.learnMore",
+                "path": "scopedImports/@salesforce-label-LightningForm.learnMore.js"
+            },
+            {
+                "name": "@salesforce/label/LightningForm.dependentFieldsListHeading",
+                "path": "scopedImports/@salesforce-label-LightningForm.dependentFieldsListHeading.js"
+            },
+            {
+                "name": "@salesforce/label/LightningForm.dependentFieldsHeader",
+                "path": "scopedImports/@salesforce-label-LightningForm.dependentFieldsHeader.js"
+            },
+            {
+                "name": "@salesforce/label/LightningForm.controllerFieldsMessage",
+                "path": "scopedImports/@salesforce-label-LightningForm.controllerFieldsMessage.js"
+            },
+            {
+                "name": "@salesforce/label/LightningForm.okButton",
+                "path": "scopedImports/@salesforce-label-LightningForm.okButton.js"
+            },
             {
                 "name": "@salesforce/label/LightningErrorMessage.validityBadInput",
                 "path": "scopedImports/@salesforce-label-LightningErrorMessage.validityBadInput.js"
@@ -478,6 +502,10 @@
                 "name": "@salesforce/label/LightningProgressIndicator.stageNotStarted",
                 "path": "scopedImports/@salesforce-label-LightningProgressIndicator.stageNotStarted.js"
             },
+            {
+                "name": "@salesforce/label/LightningProgressIndicator.errorStage",
+                "path": "scopedImports/@salesforce-label-LightningProgressIndicator.errorStage.js"
+            },
             {
                 "name": "@salesforce/label/LightningListView.loadMore",
                 "path": "scopedImports/@salesforce-label-LightningListView.loadMore.js"
@@ -950,6 +978,18 @@
                 "name": "@salesforce/label/LightningLookup.noAccess",
                 "path": "scopedImports/@salesforce-label-LightningLookup.noAccess.js"
             },
+            {
+                "name": "@salesforce/label/LightningLookup.modalSelect",
+                "path": "scopedImports/@salesforce-label-LightningLookup.modalSelect.js"
+            },
+            {
+                "name": "@salesforce/label/LightningLookup.modalCancel",
+                "path": "scopedImports/@salesforce-label-LightningLookup.modalCancel.js"
+            },
+            {
+                "name": "@salesforce/label/LightningLookup.messageWhenSearchTermTooShort",
+                "path": "scopedImports/@salesforce-label-LightningLookup.messageWhenSearchTermTooShort.js"
+            },
             {
                 "name": "@salesforce/label/LightningRecordPicker.invalidConfigurationErrorMessage",
                 "path": "scopedImports/@salesforce-label-LightningRecordPicker.invalidConfigurationErrorMessage.js"
@@ -1311,10 +1351,11 @@
                 "path": "scopedImports/@salesforce-internal-core.untrustedContentDomain.js"
             }
         ],
-        "ssrEnabledComponents": [
+        "ssrRenderedComponents": [
             "lightning-accordion",
             "lightning-accordion-section",
-            "lightning-alert",
+            "lightning-avatar",
+            "lightning-badge",
             "lightning-avatar",
             "lightning-badge",
             "lightning-base-combobox",
@@ -1328,59 +1369,49 @@
             "lightning-button-icon-stateful",
             "lightning-button-menu",
             "lightning-button-stateful",
+            "lightning-card",
             "lightning-calendar",
             "lightning-color-picker-custom",
             "lightning-color-picker-panel",
             "lightning-combobox",
-            "lightning-confirm",
             "lightning-datepicker",
             "lightning-datetimepicker",
             "lightning-dual-listbox",
             "lightning-dynamic-icon",
+            "lightning-file-upload",
             "lightning-focus-trap",
             "lightning-formatted-address",
             "lightning-formatted-date-time",
             "lightning-formatted-email",
             "lightning-formatted-location",
+            "lightning-formatted-name",
+            "lightning-formatted-number",
             "lightning-formatted-phone",
-            "lightning-formatted-rich-text",
             "lightning-formatted-text",
             "lightning-formatted-time",
             "lightning-formatted-url",
             "lightning-grouped-combobox",
             "lightning-helptext",
-            "lightning-icon",
             "lightning-input-address",
             "lightning-input-location",
-            "lightning-input-rich-text",
-            "lightning-interactive-dialog-base",
             "lightning-layout",
             "lightning-layout-item",
             "lightning-lookup-address",
             "lightning-menu-divider",
             "lightning-menu-item",
             "lightning-menu-subheader",
-            "lightning-modal",
-            "lightning-modal-base",
-            "lightning-modal-body",
-            "lightning-modal-footer",
-            "lightning-modal-header",
-            "lightning-overlay",
-            "lightning-overlay-container",
             "lightning-picklist",
             "lightning-pill",
             "lightning-pill-container",
-            "lightning-popup",
-            "lightning-popup-source",
             "lightning-progress-bar",
             "lightning-progress-ring",
             "lightning-primitive-bubble",
             "lightning-primitive-button",
-            "lightning-primitive-icon",
-            "lightning-primitive-iframe",
+            "primitive-file-droppable-zone",
             "lightning-primitive-input-checkbox",
             "lightning-primitive-input-checkbox-button",
             "lightning-primitive-input-color",
+            "lightning-primitive-colorpicker-button",
             "lightning-primitive-input-file",
             "lightning-primitive-input-simple",
             "lightning-primitive-input-toggle",
@@ -1390,10 +1421,45 @@
             "lightning-rich-text-toolbar-button-group",
             "lightning-select",
             "lightning-spinner",
+            "lightning-tab",
+            "lightning-tab-bar",
+            "lightning-tab-set",
+            "lightning-textarea",
+            "lightning-timepicker",
+            "lightning-vertical-navigation",
+            "lightning-vertical-navigation-item",
+            "lightning-vertical-navigation-item-badge",
+            "lightning-vertical-navigation-item-icon",
+            "lightning-vertical-navigation-overflow",
+            "lightning-vertical-navigation-section"
+        ],
+        "ssrSafeComponents": [
+            "lightning-alert",
+            "lightning-confirm",
+            "lightning-formatted-rich-text",
+            "lightning-icon",
+            "lightning-input-rich-text",
+            "lightning-interactive-dialog-base",
+            "lightning-modal",
+            "lightning-modal-base",
+            "lightning-modal-body",
+            "lightning-modal-footer",
+            "lightning-modal-header",
+            "lightning-overlay",
+            "lightning-overlay-container",
+            "lightning-popup",
+            "lightning-popup-source",
+            "lightning-primitive-icon",
+            "lightning-primitive-iframe",
+            "lightning-static-map",
             "lightning-toast",
             "lightning-toast-container",
-            "lightning-textarea",
-            "lightning-timepicker"
+            "lightning-vertical-navigation",
+            "lightning-vertical-navigation-item",
+            "lightning-vertical-navigation-item-badge",
+            "lightning-vertical-navigation-item-icon",
+            "lightning-vertical-navigation-overflow",
+            "lightning-vertical-navigation-section"
         ],
         "nativeShadowEnabledComponents": [
             "lightning-accordion",
@@ -1423,11 +1489,14 @@
             "lightning-datetimepicker",
             "lightning-dual-listbox",
             "lightning-dynamic-icon",
+            "lightning-file-upload",
             "lightning-focus-trap",
             "lightning-formatted-address",
             "lightning-formatted-date-time",
             "lightning-formatted-email",
             "lightning-formatted-location",
+            "lightning-formatted-name",
+            "lightning-formatted-number",
             "lightning-formatted-phone",
             "lightning-formatted-rich-text",
             "lightning-formatted-text",
@@ -1462,6 +1531,7 @@
             "lightning-primitive-bubble",
             "lightning-primitive-button",
             "lightning-primitive-color-picker-button",
+            "primitive-file-droppable-zone",
             "lightning-primitive-icon",
             "lightning-primitive-input-checkbox",
             "lightning-primitive-input-checkbox-button",
@@ -1477,6 +1547,7 @@
             "lightning-rich-text-toolbar-button-group",
             "lightning-select",
             "lightning-spinner",
+            "lightning-static-map",
             "lightning-tab",
             "lightning-tab-bar",
             "lightning-tabset",
@@ -1484,6 +1555,10 @@
             "lightning-toast-container",
             "lightning-timepicker",
             "lightning-vertical-navigation",
+            "lightning-vertical-navigation-item",
+            "lightning-vertical-navigation-item-badge",
+            "lightning-vertical-navigation-item-icon",
+            "lightning-vertical-navigation-overflow",
             "lightning-vertical-navigation-section"
         ],
         "bestPerformanceTests": [

package/scopedImports/@salesforce-label-LightningDatatable.showActions.js

@@ -1 +1 @@
-export default 'Show actions';
+export default 'Show {0} column actions';

package/scopedImports/@salesforce-label-LightningForm.controllerFieldsMessage.js

@@ -0,0 +1 @@
+export default 'A dependent field\'s value can change when you update the value of its controlling field.';

package/scopedImports/@salesforce-label-LightningForm.dependentFieldsHeader.js

@@ -0,0 +1 @@
+export default 'Dependent Fields';

package/scopedImports/@salesforce-label-LightningForm.dependentFieldsListHeading.js

@@ -0,0 +1 @@
+export default 'The dependent fields are:';

package/scopedImports/@salesforce-label-LightningForm.generalDependentFieldsMessage.js

@@ -0,0 +1 @@
+export default 'This form contains dependent fields.';

package/scopedImports/@salesforce-label-LightningForm.learnMore.js

@@ -0,0 +1 @@
+export default 'Learn more';

package/scopedImports/@salesforce-label-LightningForm.okButton.js

@@ -0,0 +1 @@
+export default 'Got It';

package/scopedImports/@salesforce-label-LightningLookup.messageWhenSearchTermTooShort.js

@@ -0,0 +1 @@
+export default 'Type at least 2 characters to perform a search.';

package/scopedImports/@salesforce-label-LightningLookup.modalCancel.js

@@ -0,0 +1 @@
+export default 'Cancel';

package/scopedImports/@salesforce-label-LightningLookup.modalSelect.js

@@ -0,0 +1 @@
+export default 'Select';

package/scopedImports/@salesforce-label-LightningProgressIndicator.currentStage.js

@@ -1 +1 @@
-export default 'Current Stage';
+export default '{0} - Current Stage';

package/scopedImports/@salesforce-label-LightningProgressIndicator.errorStage.js

@@ -0,0 +1 @@
+export default '{0} - Error';

package/scopedImports/@salesforce-label-LightningProgressIndicator.stageComplete.js

@@ -1 +1 @@
-export default 'Stage Complete';
+export default '{0} - Stage Complete';

package/scopedImports/@salesforce-label-LightningProgressIndicator.stageNotStarted.js

@@ -1 +1 @@
-export default 'Stage Not Started';
+export default '{0} - Stage Not Started';

package/src/lightning/accordion/__docs__/accordion.md

@@ -272,7 +272,3 @@ The event properties are as follows.
 | bubbles    | false | This event does not bubble.                                                                               |
 | cancelable | false | This event has no default behavior that can be canceled. You can't call `preventDefault()` on this event. |
 | composed   | false | This event does not propagate outside the template in which it was dispatched.                            |
-
-#### Source Code
-
-`lightning-accordion` is available in the [Base Components Recipes GitHub repository](https://github.com/salesforce/base-components-recipes#documentation). It's transpiled into the `c` namespace so that you can use it in your own projects.

package/src/lightning/accordionSection/__docs__/accordionSection.md

@@ -91,7 +91,3 @@ renders with `aria-expanded="true"`. When a section is collapsed, the button ren
 Additionally, the button uses the `aria-controls` attribute to identify the content that relates to the controlling button on the accordion section.
 
 To expand or collapse a section using the keyboard, press the Tab key to set focus on the toggle button or header text and press Enter.
-
-#### Source Code
-
-`lightning-accordion-section` is available in the [Base Components Recipes GitHub repository](https://github.com/salesforce/base-components-recipes#documentation). It's transpiled into the `c` namespace so that you can use it in your own projects.

package/src/lightning/avatar/__docs__/avatar.md

@@ -153,7 +153,3 @@ To understand how we implemented SLDS in `lightning-avatar`, see the **Source Co
 #### Accessibility
 
 Use the `alternative-text` attribute to describe the avatar, such as a user's initials or name. This description provides the value for the `alt` attribute in the `img` HTML tag.
-
-#### Source Code
-
-`lightning-avatar` is available in the [Base Components Recipes GitHub repository](https://github.com/salesforce/base-components-recipes#documentation). It's transpiled into the `c` namespace so that you can use it in your own projects.

package/src/lightning/avatar/avatar.html

@@ -18,6 +18,7 @@
             icon-name={fallbackIconName}
             alternative-text={alternativeText}
             title={alternativeText}
+            exportparts="icon"
         ></lightning-icon>
     </span>
 </template>

package/src/lightning/badge/__docs__/badge.md

@@ -97,7 +97,3 @@ To understand how we implemented SLDS in `lightning-badge`, see the **Source Cod
 #### Usage Considerations
 
 Badges with nested elements are not supported. To create a label that can contain links, use `lightning-pill` instead.
-
-#### Source Code
-
-`lightning-badge` is available in the [Base Components Recipes GitHub repository](https://github.com/salesforce/base-components-recipes#documentation). It's transpiled into the `c` namespace so that you can use it in your own projects.

package/src/lightning/badge/badge.html

@@ -1,9 +1,9 @@
 <template>
-    <span part="badge">
+    <span part="badge" exportparts="icon">
         <template if:false={isIconBeforeLabel}>
             {label}
         </template>
-    
+
         <template if:true={iconName}>
             <span class={computedClass}>
                 <span class="slds-icon_container slds-current-color" title={iconAlternativeText}>
@@ -11,7 +11,7 @@
                 </span>
             </span>
         </template>
-        
+
         <template if:true={isIconBeforeLabel}>
             {label}
         </template>

package/src/lightning/barcodeScanner/__docs__/barcodeScanner.md

@@ -116,7 +116,3 @@ The `errors` event has these properties.
 | bubbles    | false | This event does not bubble.                                                                                          |
 | cancelable | true  | This event can be canceled. You can call `preventDefault()` on this event to prevent firing the click event. |
 | composed   | false | This event does not propagate outside the template in which it was dispatched.                                               |
-
-#### Source Code
-
-`lightning-barcode-scanner` is available in the [Base Components Recipes GitHub repository](https://github.com/salesforce/base-components-recipes#documentation). It's transpiled into the `c` namespace so that you can use it in your own projects.

package/src/lightning/baseCombobox/baseCombobox.html

@@ -29,6 +29,7 @@
                                 placeholder={computedPlaceholder}
                                 maxlength={inputMaxlength}
                                 disabled={disabled}
+                                aria-disabled={disabled}
                                 aria-readonly={_inputAriaReadOnly}
                                 aria-autocomplete={computedAriaAutocomplete}
                                 aria-owns="dropdown-element"
@@ -54,7 +55,8 @@
                         role={customRole}
                         data-value={computedInputValue}
                         disabled={disabled}
-                        aria-label={computedButtonTriggerAriaLabel}
+                        aria-disabled={disabled}
+                        aria-label={inputLabel}
                         aria-required={required}
                         onfocus={handleFocus}
                         onkeydown={handleInputKeyDown}
@@ -115,6 +117,7 @@
                                 item={item}
                                 id={item.id}
                                 data-item-id={item.id}
+                                exportparts="option"
                                 aria-checked={item.checked}
                                 key={item.value}
                                 data-value={item.value}

package/src/lightning/baseCombobox/baseCombobox.js

@@ -5,10 +5,10 @@ import labelPillCloseButtonAlternativeText from '@salesforce/label/LightningComb
 import labelPlaceholder from '@salesforce/label/LightningCombobox.placeholder';
 import { api, track } from 'lwc';
 import LightningShadowBaseClass from 'lightning/shadowBaseClassPrivate';
-import labelCurrentSelection from '@salesforce/label/LightningCombobox.currentSelection';
+// import labelCurrentSelection from '@salesforce/label/LightningCombobox.currentSelection';
 import { handleKeyDownOnInput } from './keyboard';
 import { BaseComboboxEvents } from './baseComboboxEvents';
-import { classSet, formatLabel } from 'lightning/utils';
+import { classSet } from 'lightning/utils';
 import {
     assert,
     computeAriaInvalid,
@@ -450,9 +450,7 @@ export default class LightningBaseCombobox extends LightningShadowBaseClass {
             return;
         }
         synchronizeAttrs(input, {
-            [ARIA_LABEL]: this.isUserInputDisabled
-                ? this.computedButtonTriggerAriaLabel
-                : this.inputLabel,
+            [ARIA_LABEL]: this.inputLabel,
             [ARIA_INVALID]: this.computedAriaInvalid,
             [ARIA_ACTIVEDESCENDANT]: this.computedAriaActiveDescendant,
         });
@@ -586,17 +584,6 @@ export default class LightningBaseCombobox extends LightningShadowBaseClass {
         return this.hasInputPill ? this.inputPill.label : this.inputText;
     }
 
-    get computedButtonTriggerAriaLabel() {
-        const label = this.inputLabel;
-        const value = this.computedInputValue || this.computedPlaceholder;
-
-        if (!label) {
-            return value;
-        }
-
-        return formatLabel(labelCurrentSelection, label, value);
-    }
-
     handleListboxScroll(event) {
         // We don't want this to bubble up to the modal which due to event retargeting wouldn't be able
         // to know what is actually being scrolled and thus may lead to the scrolling of the modal
@@ -869,7 +856,7 @@ export default class LightningBaseCombobox extends LightningShadowBaseClass {
     highlightOption(option) {
         this.removeHighlight();
         if (option) {
-            option.highlight(option.ariaChecked);
+            option.highlight();
             this._highlightedOptionElement = option;
             this._highlightedOptionElementId =
                 option.getAttribute('data-item-id');
@@ -890,7 +877,7 @@ export default class LightningBaseCombobox extends LightningShadowBaseClass {
     removeHighlight() {
         const option = this._highlightedOptionElement;
         if (option) {
-            option.removeHighlight(option.ariaChecked);
+            option.removeHighlight();
             this._highlightedOptionElement = null;
             this._highlightedOptionElementId = null;
             this._activeElementDomId = null;

package/src/lightning/baseComboboxItem/baseComboboxItem.js

@@ -43,22 +43,18 @@ export default class LightningBaseComboboxItem extends LightningShadowBaseClass
     }
 
     @api
-    highlight(isSelected) {
-        this.toggleHighlight(true, isSelected);
+    highlight() {
+        this.toggleHighlight(true);
     }
 
     @api
-    removeHighlight(isSelected) {
-        this.toggleHighlight(false, isSelected);
+    removeHighlight() {
+        this.toggleHighlight(false);
     }
 
-    toggleHighlight(highlighted, isSelected) {
+    toggleHighlight(highlighted) {
         if (this.item.selectable) {
-            //Only announce the selected item from the list, not the hovered or focused ones.
-            this.setAttribute(
-                'aria-selected',
-                isSelected === 'true' ? true : false
-            );
+            this.setAttribute('aria-selected', highlighted ? 'true' : 'false');
             this.classList.toggle('slds-has-focus', highlighted);
         }
     }

package/src/lightning/button/__docs__/button.md

@@ -104,15 +104,15 @@ Use the `variant` attribute with one of these values to apply styling and animat
 -   `inverse` uses the background color and light text, useful for dark backgrounds.
 -   `success` is a green button used to indicate a successful action.
 
-##### Animation 
+##### Animation
 
-Buttons are animated by default. For the `base` variant, an underline is drawn when you mouse over the button. For the other variants, a ripple of contrasting color displays when you click the button. 
+Buttons are animated by default. For the `base` variant, an underline is drawn when you mouse over the button. For the other variants, a ripple of contrasting color displays when you click the button.
 
 When a button is disabled, the animation is disabled as well.
 
 If your browser or operating system is set to reduce animation, the button animations don't display.
 
-To prevent animation for a button, use the `disable-animation` attribute. 
+To prevent animation for a button, use the `disable-animation` attribute.
 
 ```html
 <template>
@@ -274,11 +274,8 @@ Use the following accessibility and `aria` attributes on `lightning-button`.
 | aria-expanded    | boolean           | Indicates whether a collapsible element that's controlled by the button is expanded or collapsed. To reference the controlled element, use `aria-controls`.                                                                                                                                                                                          |
 | aria-haspopup    | token             | Indicates that the button has an interactive popup element. Valid values are 'true', 'dialog', 'menu', 'listbox', 'tree', and 'grid'.                                                                                                                                                                                                                |
 | aria-label       | string            | Provides an assistive label where a visible label cannot be used.                                                                                                                                                                                                                                                                                    |
-| aria-labelledby  | ID reference list | Specifies the ID or list of IDs of the element or elements that contain visible descriptive text to describe the button.  |
+| aria-labelledby  | ID reference list | Specifies the ID or list of IDs of the element or elements that contain visible descriptive text to describe the button.                                                                                                                                                                                                                             |
 | aria-live        | token             | Indicates the button can dynamically update without a page reload, and specifies how the change is announced by assistive technologies. Possible values include `off`, `polite`, and `assertive`. The default is `off`. For the screen reader to announce changes when the user is idle, use `polite`. For immediate notifications, use `assertive`. |
+| tabindex         | integer           | Specifies whether the button is focusable during tab navigation. Set tab index to -1 to prevent focus on the button during tab navigation. The default value is 0, which makes the button focusable during tab navigation. For more information see [tabindex](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/tabindex).                      |
 
 For more information, see the [WAI-ARIA Specification](https://www.w3.org/TR/wai-aria/).
-
-#### Source Code
-
-`lightning-button` is available in the [Base Components Recipes GitHub repository](https://github.com/salesforce/base-components-recipes#documentation). It's transpiled into the `c` namespace so that you can use it in your own projects.