lightning-base-components 1.21.1-alpha → 1.21.2-alpha

package/src/lightning/helptext/form-element.slds.css

@@ -1,7 +1,31 @@
 
 /* Copyright (c) 2015-present, salesforce.com, inc. All rights reserved
   Licensed under BSD 3-Clause - see LICENSE.txt or git.io/sfdc-license */
-  @supports (--styling-hooks: '') {
+
+/**
+ * sldsFormElementUtils.css and form-element.css have many similarities
+ * however, they are used for very different use cases, and this is why
+ * they both exist, separate of each other. the 2 files are not 1:1.
+ *
+ * form-element.css is used for inclusion by LBC engineers (internal)
+ * in many of our lightning-input components, and is written with
+ * part attributes in mind. Some unneeded form element blueprint sections
+ * are not included in form-element.css, but could be added as needed later
+ *
+ * sldsFormElementUtils.css is used by customers (external) to get the
+ * specific layout styles that are provided by the form element blueprint
+ * https://www.lightningdesignsystem.com/components/form-element/
+ * there are no part attribute rules in this file
+ * the main use case of this utility is LightningModal for styling
+ * form layout for Form Element variants: Stacked, Horizontal, Compound
+ * sldsFormElementUtils.css is imported by customers via LWC CSS files:
+ * @import 'lightning/sldsFormElementUtils';
+ *
+ * **NOTE:** If you are updating this file, also check sldsFormElementUtils.css
+ * for any needed updates to keep these files in sync
+ */
+
+@supports (--styling-hooks: '') {
     /* TODO: Swap with utility classes */
     :host([data-render-mode="shadow"]) fieldset {
       border: 0;
@@ -20,11 +44,11 @@
         word-wrap: break-word;
         hyphens: auto;
         display: inline-block;
-        color: var(--sds-g-color-neutral-base-30, #444444);
-        font-size: var(--sds-g-font-scale-neg-3, 0.75rem);
-        padding-inline-end: var(--sds-g-spacing-2, 0.5rem);
-        padding-block-start: var(--sds-g-spacing-1, 0.25rem);
-        margin-block-end: calc(var(--sds-g-spacing-1, 0.25rem) / 2);
+        color: var(--slds-g-color-on-surface-2);
+        font-size: var(--slds-g-font-scale-neg-3);
+        padding-inline-end: var(--slds-g-spacing-2);
+        padding-block-start: var(--slds-g-spacing-1);
+        margin-block-end: calc(var(--slds-g-spacing-1) / 2);
     }
 
     :host([data-render-mode="shadow"]) .slds-form-element__label:empty {
@@ -36,12 +60,16 @@
         position: relative;
     }
 
+    :host([data-render-mode="shadow"]) .slds-form-element__control .slds-radio {
+      display: block;
+    }
+
     :host([data-render-mode="shadow"]) .slds-form-element__icon {
         display: inline-block;
         position: relative;
-        padding-block-start: var(--sds-g-spacing-1, 0.25rem);
+        padding-block-start: var(--slds-g-spacing-1);
         vertical-align: top;
-        line-height: var(--sds-g-font-lineheight-1, 1);
+        line-height: var(--slds-g-font-lineheight-1);
         z-index: 1;
     }
 
@@ -51,24 +79,24 @@
 
     :host([data-render-mode="shadow"]) .slds-form-element__help,:host([data-render-mode="shadow"]) 
     .slds-form-element__helper {
-        font-size: var(--sds-g-font-scale-neg-3, 0.75rem);
-        margin-block-start: calc(var(--sds-g-spacing-1, 0.25rem) / 2);
+        font-size: var(--slds-g-font-scale-neg-3);
+        margin-block-start: calc(var(--slds-g-spacing-1) / 2);
         display: block;
     }
 
     :host([data-render-mode="shadow"]) .slds-form-element_edit .slds-form-element__static {
-        width: calc(100% - var(--sds-g-sizing-7, 1.5rem));
+        width: calc(100% - var(--slds-g-sizing-7));
     }
 
     :host([data-render-mode="shadow"]) .slds-form-element_readonly {
         flex-basis: 0%;
-        border-bottom: var(--sds-g-sizing-border-1, 1px) solid var(--sds-g-color-neutral-base-90, #e5e5e5);
+        border-bottom: var(--slds-g-sizing-border-1) solid var(--slds-g-color-border-1);
         margin-block-end: 0;
     }
 
     :host([data-render-mode="shadow"]) .slds-form-element_readonly .slds-form-element__control {
-        padding-block-start: calc(var(--sds-g-spacing-1, 0.25rem) / 2);
-        padding-block-end: calc(var(--sds-g-spacing-1, 0.25rem) / 2);
+        padding-block-start: calc(var(--slds-g-spacing-1) / 2);
+        padding-block-end: calc(var(--slds-g-spacing-1) / 2);
     }
 
     :host([data-render-mode="shadow"]) .slds-form-element_readonly .slds-form-element__label {
@@ -76,7 +104,7 @@
     }
 
     :host([data-render-mode="shadow"]) .slds-form-element__legend {
-        font-weight: var(--sds-g-font-weight-7, 700);
+        font-weight: var(--slds-g-font-weight-7);
         float: left;
     }
 
@@ -84,8 +112,8 @@
         display: inline-block;
         margin-block-start: 0;
         margin-block-end: 0;
-        margin-inline-start: var(--sds-g-spacing-2, 0.5rem);
-        margin-inline-end: var(--sds-g-spacing-2, 0.5rem);
+        margin-inline-start: var(--slds-g-spacing-2);
+        margin-inline-end: var(--slds-g-spacing-2);
         align-self: center;
     }
 
@@ -94,9 +122,9 @@
         word-wrap: break-word;
         word-break: break-word;
         display: inline-block;
-        font-size: var(--sds-g-font-scale-neg-1, 0.875rem);
-        font-weight: var(--sds-g-font-weight-4, 400);
-        color: var(--sds-g-color-neutral-base-10, #181818);
+        font-size: var(--slds-g-font-scale-neg-1);
+        font-weight: var(--slds-g-font-weight-4);
+        color: var(--slds-g-color-neutral-base-10);
         width: 100%;
     }
 
@@ -105,28 +133,28 @@
     }
 
     :host([data-render-mode="shadow"]) .slds-form-element__static:empty {
-        min-height: calc(var(--sds-g-sizing-6, 1.25rem) + 1px);
+        min-height: calc(var(--slds-g-sizing-6) + 1px);
         vertical-align: bottom;
     }
 
     :host([data-render-mode="shadow"]) .slds-form-element__static--edit {
-        width: calc(100% - var(--sds-g-sizing-7, 1.5rem));
+        width: calc(100% - var(--slds-g-sizing-7));
     }
 
     :host([data-render-mode="shadow"]) .slds-required {
-        color: var(--sds-g-color-error-base-50, #ea001e);
+        color: var(--slds-g-color-error-base-50);
         margin-block-start: 0;
         margin-block-end: 0;
-        margin-inline-start: calc(var(--sds-g-spacing-1, 0.25rem) / 2);
-        margin-inline-end: calc(var(--sds-g-spacing-1, 0.25rem) / 2);
+        margin-inline-start: calc(var(--slds-g-spacing-1) / 2);
+        margin-inline-end: calc(var(--slds-g-spacing-1) / 2);
     }
 
     :host([data-render-mode="shadow"]) .slds-has-error .slds-form-element__help {
-        color: var(--sds-g-color-error-base-50, #ea001e);
+        color: var(--slds-g-color-error-1);
     }
 
     :host([data-render-mode="shadow"][invalid]) .slds-form-element__help {
-        color: var(--sds-g-color-error-base-50, #ea001e);
+        color: var(--slds-g-color-error-1);
     }
 
     /* --------------------------------------- */
@@ -140,11 +168,11 @@
     /* TODO: Using `:not` is currently not working, and it could break the build because of issues with the dist script */
 
     /* :host([variant='label-stacked']):not(.slds-form-element_readonly) {
-        margin-block-end: var(--sds-g-spacing-2);
+        margin-block-end: var(--slds-g-spacing-2);
     }
 
     :host([variant='label-stacked']):not(.slds-is-editing) {
-        padding: 0 var(--sds-g-spacing-1);
+        padding: 0 var(--slds-g-spacing-1);
     } */
 
     /* :host([variant='label-stacked']):not([class*="slds-size"]) {
@@ -170,7 +198,7 @@
 
     :host([data-render-mode="shadow"][variant='label-stacked']) .slds-form-element__icon {
         float: none;
-        padding-block-start: var(--sds-g-spacing-1, 0.25rem);
+        padding-block-start: var(--slds-g-spacing-1);
     }
 
     /* --------------------------------------- */
@@ -188,14 +216,14 @@
     */
 
     :host([data-render-mode="shadow"][variant='label-inline'].slds-form-element_horizontal) {
-        padding: var(--sds-g-spacing-1, 0.25rem);
-        margin-block-end: var(--sds-g-spacing-2, 0.5rem);
+        padding: var(--slds-g-spacing-1);
+        margin-block-end: var(--slds-g-spacing-2);
     }
 
     /* TODO: Using `:not` is currently not working, and it could break the build because of issues with the dist script */
 
     /* :host([variant='label-inline']):not(.slds-form-element_readonly) {
-        margin-block-end: var(--sds-g-spacing-2);
+        margin-block-end: var(--slds-g-spacing-2);
     }
 
     :host([variant='label-inline']):not([class*="slds-size"]) {
@@ -204,18 +232,17 @@
     }
 
     :host([variant='label-inline']:not(.slds-is-editing)) {
-        padding: var(--sds-g-spacing-1);
+        padding: var(--slds-g-spacing-1);
     } */
 
     :host([data-render-mode="shadow"][variant='label-inline']).slds-is-edited {
-        padding-block-start: var(--sds-g-sizing-6, 1.25rem)
+        padding-block-start: var(--slds-g-sizing-6)
     }
 
     @media (width >= 48em) {
         :host([data-render-mode="shadow"][variant='label-inline']) .slds-form-element__label {
-          float: left;
-          max-width: calc(33% - var(--sds-g-sizing-6, 1.25rem)); /* Removing icon width for when the help-text icon is present */
-          flex-basis: calc(33% - var(--sds-g-sizing-6, 1.25rem)); /* Some form element controls are set to display:flex */
+          max-width: calc(33% - var(--slds-g-sizing-6)); /* Removing icon width for when the help-text icon is present */
+          flex-basis: calc(33% - var(--slds-g-sizing-6)); /* Some form element controls are set to display:flex */
           flex-grow: 1; /* For IE and Safari which didn't auto expand to the available space */
           margin-block-end: 0;
           position: relative;
@@ -260,9 +287,9 @@
 
     :host([data-render-mode="shadow"]) .slds-form-element_compound .slds-form-element__row {
       display: flex;
-      margin-bottom: var(--sds-g-spacing-1, 0.25rem);
-      margin-left: calc(var(--sds-g-spacing-1, 0.25rem) * -1);
-      margin-right: calc(var(--sds-g-spacing-1, 0.25rem) * -1);
+      margin-bottom: var(--slds-g-spacing-1);
+      margin-left: calc(var(--slds-g-spacing-1) * -1);
+      margin-right: calc(var(--slds-g-spacing-1) * -1);
     }
 
     :host([data-render-mode="shadow"]) .slds-form-element_compound .slds-form-element__row .slds-form-element__label {
@@ -270,8 +297,8 @@
     }
 
     :host([data-render-mode="shadow"]) .slds-form-element_compound .slds-form-element {
-      padding-left: var(--sds-g-spacing-1, 0.25rem);
-      padding-right: var(--sds-g-spacing-1, 0.25rem);
+      padding-left: var(--slds-g-spacing-1);
+      padding-right: var(--slds-g-spacing-1);
     }
 
     :host([data-render-mode="shadow"]) .slds-form-element_address .slds-form-element__row {