lightning-base-components 1.16.3-alpha → 1.16.5-alpha

package/src/lightning/colorPickerPanel/color-picker-panel.slds.css

@@ -1,421 +1,12 @@
 /* Copyright (c) 2015-present, salesforce.com, inc. All rights reserved
 Licensed under BSD 3-Clause - see LICENSE.txt or git.io/sfdc-license */
 
-/* Document
- * --------------------- */
-
-/**
- * Normalize box sizing to border box for all browsers.
- */
-
-*,
-::before,
-::after {
-  box-sizing: border-box;
-}
-
-/* Grouping Content
- * --------------------- */
-
-/**
- * Add the correct display in IE.
- */
-
-main {
-  display: block;
-}
-
-/**
- * 1. Remove the margin in all browsers.
- * 2. Remove the padding in all browsers.
- * 3. Normalize font sizes in all browsers.
- * 4. Normalize font weight in all browsers.
- */
-
-h1,
-h2,
-h3,
-h4,
-h5,
-h6 {
-  font-size: 0.875rem; /* 3 */
-  font-weight: normal; /* 4 */
-  margin: 0; /* 1 */
-  padding: 0; /* 2 */
-}
-
-/**
- * Remove the margin in all browsers.
- */
-
-p {
-  margin: 0;
-}
-
-/**
- * 1. Remove the margin in all browsers.
- * 2. Normalize border styles in all browsers.
- */
-
-hr {
-  margin: 0; /* 1 */
-  border: 0; /* 2 */
-  border-top-width: 1px; /* 2 */
-  border-style: solid; /* 2 */
-  border-color: inherit; /* 2 */
-}
-
-/**
- * 1. Remove the margin in all browsers.
- * 2. Remove the padding in all browsers.
- * 3. Remove the list-style in all browsers, sub-system dependant.
- */
-
-ol,
-ul {
-  list-style: none; /* 3 */
-  padding: 0; /* 2 */
-  margin: 0; /* 1 */
-}
-
-/**
- * Remove the margin in all browsers.
- */
-
-dl,
-dt,
-dd {
-  margin: 0;
-}
-
-/* Form Controls
- * --------------------- */
-
-/**
- * Remove the margin in all browsers.
- */
-
-form {
-  margin: 0;
-}
-
-/**
- * 1. Correct font properties not being inherited.
- * 2. Remove the margin in Firefox and Safari.
- * 3. Fix correct color not being inherited.
- */
-
-button,
-input,
-optgroup,
-select,
-textarea {
-  font: inherit; /* 1 */
-  margin: 0; /* 2 */
-  color: inherit; /* 3 */
-}
-
-/**
- * Address inconsistent `text-transform` inheritance for `button` and `select`.
- */
-
-button,
-select {
-  text-transform: none;
-}
-
-/**
- * 1. Correct inability to style clickable `input` types in iOS.
- * 2. Normalizes cursor indicator on clickable elements.
- */
-
-button,:host([data-render-mode="shadow"]) 
-[type='button'],:host([data-render-mode="shadow"]) 
-[type='reset'],:host([data-render-mode="shadow"]) 
-[type='submit'] {
-  -webkit-appearance: button; /* 1 */
-  appearance: button; /* 1 */
-  cursor: pointer; /* 2 */
-}
-
-/**
- * Prevent option or optgroup to increase the width of a select.
- */
-
-select {
-  max-width: 100%;
-}
-
-/**
- * Correct the outline style in Safari.
- */
-
-input:focus,
-button:focus,
-select:focus,
-textarea:focus {
-  outline-offset: 0;
-}
-
-/**
- * Remove the inner border and padding in Firefox.
- */
-
-::-moz-focus-inner {
-  border-style: none;
-  padding: 0;
-}
-
-/**
- * 1. Correct the text wrapping in Edge 18- and IE.
- * 2. Correct the color inheritance from `fieldset` elements in IE.
- * 3. Remove the padding so developers are not caught out when they zero out 'fieldset' elements in all browsers.
- */
-
-legend {
-  color: inherit; /* 2 */
-  display: table; /* 1 */
-  max-width: 100%; /* 1 */
-  white-space: normal; /* 1 */
-  padding: 0; /* 3 */
-}
-
-/**
- * Add the correct vertical alignment in Chrome and Firefox.
- */
-
-progress {
-  vertical-align: baseline;
-}
-
-/**
- * Correct the cursor style of increment and decrement buttons in Safari.
- */
-
-::-webkit-inner-spin-button,
-::-webkit-outer-spin-button {
-  height: auto;
-}
-
-/**
- * 1. Correct the odd appearance in Chrome and Safari.
- * 2. Correct the outline style in Safari.
- */
-
-:host([data-render-mode="shadow"]) [type='search'] {
-  -webkit-appearance: textfield; /* 1 */
-  outline-offset: -2px; /* 2 */
-}
-
-/**
- * Remove the inner padding in Chrome and Safari on macOS.
- */
-
-::-webkit-search-decoration {
-  -webkit-appearance: none;
-}
-
-/**
- * 1. Correct the inability to style clickable types in iOS and Safari.
- * 2. Change font properties to 'inherit' in Safari.
- */
-
-::-webkit-file-upload-button {
-  -webkit-appearance: button; /* 1 */
-  font: inherit; /* 2 */
-}
-
-/**
- * Restore the focus styles unset by the previous rule.
- */
-
-:-moz-focusring {
-  outline: 1px dotted ButtonText;
-}
-
-/**
- * Remove the additional ':invalid' styles in Firefox.
- * See: https://github.com/mozilla/gecko-dev/blob/2f9eacd9d3d995c937b4251a5557d95d494c9be1/layout/style/res/forms.css#L728-L737
- */
-
-:-moz-ui-invalid {
-  box-shadow: none;
-}
-
-/* Text-level semantics
- * --------------------- */
-
-/**
- * Normalizes cursor indicator on clickable elements.
- */
-
-a {
-  cursor: pointer;
-}
-
-/**
- * Add the correct text decoration in Chrome, Edge, and Safari.
- */
-
-abbr[title] {
-  text-decoration: underline dotted;
-  cursor: help;
-}
-
-/**
- * Add the correct font weight in Edge and Safari.
- */
-
-b,
-strong {
-  font-weight: bolder;
-}
-
-/**
- * 1. Improve consistency of default fonts in all browsers. (https://github.com/sindresorhus/modern-normalize/issues/3)
- * 2. Correct the odd 'em' font sizing in all browsers.
- * 3. Remove the margin in all browsers.
- */
-
-code,
-kbd,
-samp,
-pre {
-  font-family: ui-monospace, SFMono-Regular, Consolas, 'Liberation Mono', Menlo, monospace; /* 1 */
-  font-size: 1em; /* 2 */
-  margin: 0; /* 3 */
-}
-
-/**
- * Prevent overflow of the container in all browsers
- */
-
-pre {
-  overflow: auto;
-  -ms-overflow-style: scrollbar;
-}
-
-/**
- * Add the correct font size in all browsers.
- */
-
-small {
-  font-size: 80%;
-}
-
-/**
- * Prevent 'sub' and 'sup' elements from affecting the line height in all browsers.
- */
-
-sub,
-sup {
-  font-size: 75%;
-  line-height: 0;
-  position: relative;
-  vertical-align: baseline;
-}
-
-sub {
-  bottom: -0.25em;
-}
-
-sup {
-  top: -0.5em;
-}
-
-/* Embedded content
- * --------------------- */
-
-/**
- * Change the alignment on media elements in all browsers.
- */
-
-audio,
-canvas,
-iframe,
-img,
-svg,
-video {
-  vertical-align: middle;
-}
-
-/**
- * Make images responsive by default.
- */
-
-img,:host([data-render-mode="shadow"]) 
-[type='image'] {
-  max-width: 100%;
-  height: auto;
-}
-
-/**
- * Remove the border on iframes in all browsers.
- */
-
-iframe {
-  border-style: none;
-}
-
-/**
- * Change the fill color to match the text color in all browsers.
- */
-
-svg:not([fill]) {
-  fill: currentColor;
-}
-
-/* Tabular data
- * --------------------- */
-
-/**
- * 1. Remove text indentation from table contents in Chrome and Safari. [Chromium Bug 999088](https://bugs.chromium.org/p/chromium/issues/detail?id=999088), [Webkit Bug 201297](https://bugs.webkit.org/show_bug.cgi?id=201297)
- * 2. Correct table border color inheritance in all Chrome and Safari. [Chromium Bug 935729](https://bugs.chromium.org/p/chromium/issues/detail?id=935729), [Webkit Bug 195016](https://bugs.webkit.org/show_bug.cgi?id=195016)
- * 3. Collapse border spacing in all browsers
- */
-
-table {
-  text-indent: 0; /* 1 */
-  border-color: inherit; /* 2 */
-  border-collapse: collapse; /* 3 */
-}
-
-/* Shadow host
- * --------------------- */
-
-/**
- * 1. Change the line height in all browsers
- * 2. Change the base font size in all browsers, inherit 100% from `html`
- * 3. Prevent adjustments of font size after orientation changes in IE on Windows Phone and in iOS
- * 4. Remove the grey highlight on links in iOS
- * 5. Font Stack:
- *   a. Safari for OS X and iOS (San Francisco)
- *   b. Chrome < 56 for OS X (San Francisco)
- *   c. Windows
- *   d. Android
- *   e. Web Fallback
- *   f. Emoji font stack [Mac, Windows, Linux]
- */
-
-:host([data-render-mode="shadow"]) {
-  line-height: 1.5;
-  font-size: 0.875rem;
-  -webkit-tap-highlight-color: transparent;
-  -ms-text-size-adjust: 100%;
-  -webkit-text-size-adjust: 100%;
-  font-family: -apple-system, BlinkMacSystemFont, Segoe UI, Roboto, 'Helvetica Neue', Arial, sans-serif,
-    'Apple Color Emoji', 'Segoe UI Emoji', 'Segoe UI Symbol';
-}
-
-/* Copyright (c) 2015-present, salesforce.com, inc. All rights reserved
-Licensed under BSD 3-Clause - see LICENSE.txt or git.io/sfdc-license */
-
 :host([data-render-mode="shadow"]:focus) {
   outline: 0;
 }
 
 :host([data-render-mode="shadow"]) [part~='button'] {
-  display: var(--sds-c-button-display, inline-flex);
+  display: inline-flex;
   position: relative;
   background: none;
   background-color: var(--sds-c-button-color-background, var(--sds-s-button-color-background, transparent));
@@ -440,14 +31,56 @@ Licensed under BSD 3-Clause - see LICENSE.txt or git.io/sfdc-license */
   border-width: var(--sds-c-button-sizing-border, var(--sds-s-button-sizing-border, 1px));
   border-style: solid;
   border-color: var(--sds-c-button-color-border, var(--sds-s-button-color-border, transparent));
-  border-radius: var(--sds-c-button-radius-border, var(--sds-c-button-radius-border, 0.25rem));
+  border-start-start-radius: var(
+    --sds-c-button-radius-border-startstart,
+    var(
+      --sds-c-button-radius-border,
+      var(
+        --sds-s-button-radius-border-startstart,
+        var(--sds-s-button-radius-border, var(--sds-g-radius-border-2, 0.25rem))
+      )
+    )
+  );
+  border-start-end-radius: var(
+    --sds-c-button-radius-border-startend,
+    var(
+      --sds-c-button-radius-border,
+      var(
+        --sds-s-button-radius-border-startend,
+        var(--sds-s-button-radius-border, var(--sds-g-radius-border-2, 0.25rem))
+      )
+    )
+  );
+  border-end-start-radius: var(
+    --sds-c-button-radius-border-endstart,
+    var(
+      --sds-c-button-radius-border,
+      var(
+        --sds-s-button-radius-border-endstart,
+        var(--sds-s-button-radius-border, var(--sds-g-radius-border-2, 0.25rem))
+      )
+    )
+  );
+  border-end-end-radius: var(
+    --sds-c-button-radius-border-endend,
+    var(
+      --sds-c-button-radius-border,
+      var(
+        --sds-s-button-radius-border-endend,
+        var(--sds-s-button-radius-border, var(--sds-g-radius-border-2, 0.25rem))
+      )
+    )
+  );
   box-shadow: var(--sds-c-button-shadow, var(--sds-s-button-shadow));
-  width: var(--sds-c-button-width);
+  width: var(--sds-c-button-sizing-width);
+
+  /* this line height hook is incorrect but is used in core - need to get teams to change */
+  /* stylelint-disable-next-line sds-stylelint-plugin/styling-hooks-pattern */
   line-height: var(--sds-c-button-line-height);
   white-space: normal;
   user-select: none;
   align-items: center;
-  text-decoration: var(--sds-c-button-text-decoration, none);
+  text-decoration: var(--sds-c-button-font-decoration, none);
   appearance: none;
 }
 

package/src/lightning/datatable/datatable.js

@@ -1542,9 +1542,9 @@ export default class LightningDatatable extends LightningElement {
 
     /************************ EVENT DISPATCHERS **************************/
 
-    fireSelectedRowsChange(selectedRows) {
+    fireSelectedRowsChange(selectedRows, config) {
         const event = new CustomEvent('rowselection', {
-            detail: { selectedRows },
+            detail: { selectedRows, config: config || {} },
         });
 
         this.dispatchEvent(event);

package/src/lightning/datatable/rowSelection.js

@@ -32,6 +32,13 @@ export {
 
 const MAX_ROW_SELECTION_DEFAULT = undefined;
 
+const ROWS_ACTION = {
+    SELECT_ALL_ROWS: 'selectAllRows',
+    DESELECT_ALL_ROWS: 'deselectAllRows',
+    ROW_SELECT: 'rowSelect',
+    ROW_DESELECT: 'rowDeselect',
+};
+
 /************************** EVENT HANDLERS **************************/
 
 /**
@@ -43,7 +50,9 @@ const MAX_ROW_SELECTION_DEFAULT = undefined;
 export function handleSelectAllRows(event) {
     event.stopPropagation();
     markAllRowsSelected(this.state);
-    this.fireSelectedRowsChange(this.getSelectedRows());
+    this.fireSelectedRowsChange(this.getSelectedRows(), {
+        selection: ROWS_ACTION.SELECT_ALL_ROWS,
+    });
 }
 
 /**
@@ -54,7 +63,9 @@ export function handleSelectAllRows(event) {
 export function handleDeselectAllRows(event) {
     event.stopPropagation();
     markAllRowsDeselected(this.state);
-    this.fireSelectedRowsChange(this.getSelectedRows());
+    this.fireSelectedRowsChange(this.getSelectedRows(), {
+        selection: ROWS_ACTION.DESELECT_ALL_ROWS,
+    });
 }
 
 /**
@@ -77,7 +88,10 @@ export function handleSelectRow(event) {
 
     markSelectedRowsInterval(this.state, fromRowKey, rowKeyValue);
     setLastRowSelection(this.state, rowKeyValue);
-    this.fireSelectedRowsChange(this.getSelectedRows());
+    this.fireSelectedRowsChange(this.getSelectedRows(), {
+        selection: ROWS_ACTION.ROW_SELECT,
+        value: rowKeyValue,
+    });
 }
 
 /**
@@ -100,7 +114,10 @@ export function handleDeselectRow(event) {
 
     markDeselectedRowsInterval(this.state, fromRowKey, rowKeyValue);
     setLastRowSelection(this.state, rowKeyValue);
-    this.fireSelectedRowsChange(this.getSelectedRows());
+    this.fireSelectedRowsChange(this.getSelectedRows(), {
+        selection: ROWS_ACTION.ROW_DESELECT,
+        value: rowKeyValue,
+    });
 }
 
 /**

package/src/lightning/datetimepicker/datetimepicker.html

@@ -48,9 +48,7 @@
                     </div>
                 </div>
             </div>
-            <template if:true={customErrorMessage}>
-                <div data-error-message id="errormessage" class="slds-form-element__help" aria-live="assertive">{customErrorMessage}</div>
-            </template>
+                <div data-error-message id="errormessage" class={computedClass} aria-live="assertive">{customErrorMessage}</div>
 
         </fieldset>
     </div>

package/src/lightning/datetimepicker/datetimepicker.js

@@ -335,6 +335,11 @@ export default class LightningDateTimePicker extends LightningElement {
         return this._dateMax;
     }
 
+    get computedClass() {
+        let displayClass = this._customErrorMessage ? 'slds-show' : 'slds-hide';
+        return 'slds-form-element__help ' + displayClass;
+    }
+
     get errorMessageElementId() {
         return getRealDOMId(
             this.template.querySelector('[data-error-message]')

package/src/lightning/fileDownload/__docs__/fileDownload.md

@@ -0,0 +1,41 @@
+Add file downloads to Experience Cloud sites that use the Build Your Own (LWR) template.
+
+To create a component that downloads a file, import `generateUrl` from `lightning/fileDownload`. Use the `generateUrl` function and pass in the record ID number of the files that you want to download. This function supports Content Document, Content Version, Attachment, or Document record IDs.
+
+This example returns a download URL that you can pass into `window.open` to download the file.
+
+```javascript
+import { generateUrl } from 'lightning/fileDownload';
+const url = generateUrl(recordId);
+window.open(url);
+```
+
+In this example, clicking a download button on a record generates a URL and uses it to download the record's files.
+
+```HTML
+<template>
+  <div>
+      <lightning-input type="text" label="File download for the record" value={recordId}></lightning-input>
+      <lightning-button label="Download" onclick={handleClick} class="slds-m-left_x-small"></lightning-button>
+  </div>
+</template>
+```
+
+```Javascript
+import { LightningElement } from 'lwc';
+import { generateUrl } from 'lightning/fileDownload';
+export default class Download extends LightningElement {
+    recordId;
+    url;
+    handleClick() {
+        this.url = generateUrl(this.recordId);
+        window.open(this.url)
+    }
+}
+```
+
+#### Considerations
+
+- Authenticated users can download any files they have access to. Unauthenticated users can only download Content Document files that they can access with a Library membership.
+
+- The `recordId` parameter in `generateUrl` accepts IDs for Content Document, Content Version, Attachment, or Document files.