@vaadin/checkbox 24.4.0-dev.b3e1d14600 → 24.5.0-alpha1

package/theme/lumo/vaadin-checkbox-styles.js

@@ -26,6 +26,13 @@ registerStyles(
       --_focus-ring-color: var(--vaadin-focus-ring-color, var(--lumo-primary-color-50pct));
       --_focus-ring-width: var(--vaadin-focus-ring-width, 2px);
       --_selection-color: var(--vaadin-selection-color, var(--lumo-primary-color));
+      --_invalid-background: var(--vaadin-input-field-invalid-background, var(--lumo-error-color-10pct));
+    }
+
+    [part='label'] {
+      display: flex;
+      position: relative;
+      max-width: max-content;
     }
 
     :host([has-label]) ::slotted(label) {
@@ -35,6 +42,14 @@ registerStyles(
       );
     }
 
+    :host([dir='rtl'][has-label]) ::slotted(label) {
+      padding: var(--lumo-space-xs) var(--lumo-space-xs) var(--lumo-space-xs) var(--lumo-space-s);
+    }
+
+    :host([has-label][required]) ::slotted(label) {
+      padding-inline-end: var(--lumo-space-m);
+    }
+
     [part='checkbox'] {
       width: var(--_checkbox-size);
       height: var(--_checkbox-size);
@@ -77,6 +92,27 @@ registerStyles(
       opacity: 1;
     }
 
+    :host([readonly]:not([checked]):not([indeterminate])) {
+      color: var(--lumo-secondary-text-color);
+    }
+
+    :host([readonly]:not([checked]):not([indeterminate])) [part='checkbox'] {
+      background: transparent;
+      box-shadow: none;
+    }
+
+    :host([readonly]:not([checked]):not([indeterminate])) [part='checkbox']::after {
+      content: '';
+      box-sizing: border-box;
+      width: 100%;
+      height: 100%;
+      border-radius: inherit;
+      top: 0;
+      left: 0;
+      opacity: 1;
+      border: var(--vaadin-input-field-readonly-border, 1px dashed var(--lumo-contrast-50pct));
+    }
+
     /* Indeterminate checkmark */
     :host([indeterminate]) [part='checkbox']::after {
       content: var(--vaadin-checkbox-checkmark-char-indeterminate, '');
@@ -96,10 +132,13 @@ registerStyles(
         inset 0 0 0 var(--_input-border-width, 0) var(--_input-border-color);
     }
 
+    :host([focus-ring][readonly]:not([checked]):not([indeterminate])) [part='checkbox'] {
+      box-shadow: 0 0 0 1px var(--lumo-base-color), 0 0 0 calc(var(--_focus-ring-width) + 1px) var(--_focus-ring-color);
+    }
+
     /* Disabled */
     :host([disabled]) {
       pointer-events: none;
-      color: var(--lumo-disabled-text-color);
       --vaadin-input-field-border-color: var(--lumo-contrast-20pct);
     }
 
@@ -115,13 +154,19 @@ registerStyles(
       color: var(--lumo-contrast-30pct);
     }
 
+    :host([disabled]) [part='label'],
+    :host([disabled]) [part='helper-text'] {
+      color: var(--lumo-disabled-text-color);
+      -webkit-text-fill-color: var(--lumo-disabled-text-color);
+    }
+
     :host([indeterminate][disabled]) [part='checkbox']::after {
       background-color: var(--lumo-contrast-30pct);
     }
 
-    /* RTL specific styles */
-    :host([dir='rtl'][has-label]) ::slotted(label) {
-      padding: var(--lumo-space-xs) var(--lumo-space-xs) var(--lumo-space-xs) var(--lumo-space-s);
+    :host([readonly][checked]) [part='checkbox'],
+    :host([readonly][indeterminate]) [part='checkbox'] {
+      background-color: var(--vaadin-checkbox-readonly-checked-background, var(--lumo-contrast-70pct));
     }
 
     /* Used for activation "halo" */
@@ -139,13 +184,14 @@ registerStyles(
     }
 
     /* Hover */
-    :host(:not([checked]):not([indeterminate]):not([disabled]):hover) [part='checkbox'] {
+    :host(:not([checked]):not([indeterminate]):not([disabled]):not([readonly]):not([invalid]):hover) [part='checkbox'] {
       background: var(--vaadin-checkbox-background-hover, var(--lumo-contrast-30pct));
     }
 
     /* Disable hover for touch devices */
     @media (pointer: coarse) {
-      :host(:not([checked]):not([indeterminate]):not([disabled]):hover) [part='checkbox'] {
+      /* prettier-ignore */
+      :host(:not([checked]):not([indeterminate]):not([disabled]):not([readonly]):not([invalid]):hover) [part='checkbox'] {
         background: var(--vaadin-checkbox-background, var(--lumo-contrast-20pct));
       }
     }
@@ -165,6 +211,94 @@ registerStyles(
       transform: scale(0);
       opacity: 0.4;
     }
+
+    /* Required */
+    :host([required]) [part='required-indicator'] {
+      position: absolute;
+      top: var(--lumo-space-xs);
+      right: var(--lumo-space-xs);
+    }
+
+    :host([required][dir='rtl']) [part='required-indicator'] {
+      right: auto;
+      left: var(--lumo-space-xs);
+    }
+
+    :host([required]) [part='required-indicator']::after {
+      content: var(--lumo-required-field-indicator, '\\2022');
+      transition: opacity 0.2s;
+      color: var(--lumo-required-field-indicator-color, var(--lumo-primary-text-color));
+      width: 1em;
+      text-align: center;
+    }
+
+    /* Invalid */
+    :host([invalid]) {
+      --vaadin-input-field-border-color: var(--lumo-error-color);
+    }
+
+    :host([invalid]) [part='checkbox'] {
+      background: var(--_invalid-background);
+      background-image: linear-gradient(var(--_invalid-background) 0%, var(--_invalid-background) 100%);
+    }
+
+    :host([invalid]:hover) [part='checkbox'] {
+      background-image: linear-gradient(var(--_invalid-background) 0%, var(--_invalid-background) 100%),
+        linear-gradient(var(--_invalid-background) 0%, var(--_invalid-background) 100%);
+    }
+
+    :host([invalid][focus-ring]) {
+      --_focus-ring-color: var(--lumo-error-color-50pct);
+    }
+
+    :host([invalid]) [part='required-indicator']::after {
+      color: var(--lumo-required-field-indicator-color, var(--lumo-error-text-color));
+    }
+
+    /* Error message */
+    [part='error-message'] {
+      font-size: var(--vaadin-input-field-error-font-size, var(--lumo-font-size-xs));
+      line-height: var(--lumo-line-height-xs);
+      font-weight: var(--vaadin-input-field-error-font-weight, 400);
+      color: var(--vaadin-input-field-error-color, var(--lumo-error-text-color));
+      will-change: max-height;
+      transition: 0.4s max-height;
+      max-height: 5em;
+      padding-inline-start: var(--lumo-space-xs);
+    }
+
+    :host([has-error-message]) [part='error-message']::after,
+    :host([has-helper]) [part='helper-text']::after {
+      content: '';
+      display: block;
+      height: 0.4em;
+    }
+
+    :host(:not([invalid])) [part='error-message'] {
+      max-height: 0;
+      overflow: hidden;
+    }
+
+    /* Helper */
+    [part='helper-text'] {
+      display: block;
+      color: var(--vaadin-input-field-helper-color, var(--lumo-secondary-text-color));
+      font-size: var(--vaadin-input-field-helper-font-size, var(--lumo-font-size-xs));
+      line-height: var(--lumo-line-height-xs);
+      font-weight: var(--vaadin-input-field-helper-font-weight, 400);
+      margin-left: calc(var(--lumo-border-radius-m) / 4);
+      transition: color 0.2s;
+      padding-inline-start: var(--lumo-space-xs);
+    }
+
+    :host(:hover:not([readonly])) [part='helper-text'] {
+      color: var(--lumo-body-text-color);
+    }
+
+    :host([has-error-message]) ::slotted(label),
+    :host([has-helper]) ::slotted(label) {
+      padding-bottom: 0;
+    }
   `,
   { moduleId: 'lumo-checkbox' },
 );

package/theme/lumo/vaadin-checkbox.d.ts

@@ -0,0 +1,2 @@
+import './vaadin-checkbox-styles.js';
+import '../../src/vaadin-checkbox.js';

package/theme/lumo/vaadin-lit-checkbox.d.ts

@@ -0,0 +1,2 @@
+import './vaadin-checkbox-styles.js';
+import '../../src/vaadin-lit-checkbox.js';

package/theme/material/vaadin-checkbox-styles.d.ts

@@ -0,0 +1 @@
+import '@vaadin/vaadin-material-styles/color.js';

package/theme/material/vaadin-checkbox-styles.js

@@ -15,6 +15,12 @@ registerStyles(
       --_checkbox-size: var(--vaadin-checkbox-size, 16px);
     }
 
+    [part='label'] {
+      display: flex;
+      position: relative;
+      max-width: max-content;
+    }
+
     :host([has-label]) ::slotted(label) {
       padding: 3px 12px 3px 6px;
     }
@@ -118,10 +124,62 @@ registerStyles(
       background-color: var(--material-disabled-color);
     }
 
+    :host([readonly][checked]) [part='checkbox'],
+    :host([readonly][indeterminate]) [part='checkbox'],
+    :host([readonly]) [part='checkbox']::before {
+      background-color: var(--material-secondary-text-color);
+    }
+
     /* RTL specific styles */
     :host([dir='rtl'][has-label]) ::slotted(label) {
       padding: 3px 6px 3px 12px;
     }
+
+    /* Required */
+    :host([required]) [part='required-indicator'] {
+      position: absolute;
+      top: 3px;
+      right: 2px;
+    }
+
+    :host([dir='rtl'][required]) [part='required-indicator'] {
+      right: auto;
+      left: 2px;
+    }
+
+    :host([required]:not([disabled])) [part='required-indicator'] {
+      color: var(--material-secondary-text-color);
+    }
+
+    :host([required]) [part='required-indicator']::after {
+      content: '*';
+    }
+
+    :host([invalid]) [part='required-indicator']::after {
+      color: var(--material-error-text-color);
+    }
+
+    [part='error-message'],
+    [part='helper-text'] {
+      font-size: 0.75em;
+      line-height: 1;
+      padding-left: 6px;
+    }
+
+    [part='error-message'] {
+      color: var(--material-error-text-color);
+    }
+
+    [part='helper-text'] {
+      color: var(--material-secondary-text-color);
+    }
+
+    :host([has-error-message]) [part='error-message']::before,
+    :host([has-helper]) [part='helper-text']::before {
+      content: '';
+      display: block;
+      height: 6px;
+    }
   `,
   { moduleId: 'material-checkbox' },
 );

package/theme/material/vaadin-checkbox.d.ts

@@ -0,0 +1,2 @@
+import './vaadin-checkbox-styles.js';
+import '../../src/vaadin-checkbox.js';

package/theme/material/vaadin-lit-checkbox.d.ts

@@ -0,0 +1,2 @@
+import './vaadin-checkbox-styles.js';
+import '../../src/vaadin-lit-checkbox.js';

package/web-types.json

@@ -0,0 +1,355 @@
+{
+  "$schema": "https://json.schemastore.org/web-types",
+  "name": "@vaadin/checkbox",
+  "version": "24.5.0-alpha1",
+  "description-markup": "markdown",
+  "contributions": {
+    "html": {
+      "elements": [
+        {
+          "name": "vaadin-checkbox",
+          "description": "`<vaadin-checkbox>` is an input field representing a binary choice.\n\n```html\n<vaadin-checkbox label=\"I accept the terms and conditions\"></vaadin-checkbox>\n```\n\n### Styling\n\nThe following shadow DOM parts are available for styling:\n\nPart name            | Description\n---------------------|-------------\n`checkbox`           | The element representing a stylable custom checkbox\n`label`              | The slotted label element wrapper\n`helper-text`        | The slotted helper text element wrapper\n`error-message`      | The slotted error message element wrapper\n`required-indicator` | The `required` state indicator element\n\nThe following state attributes are available for styling:\n\nAttribute            | Description\n---------------------|-------------\n`active`             | Set when the checkbox is activated with mouse, touch or the keyboard.\n`checked`            | Set when the checkbox is checked.\n`disabled`           | Set when the checkbox is disabled.\n`readonly`           | Set when the checkbox is readonly.\n`focus-ring`         | Set when the checkbox is focused using the keyboard.\n`focused`            | Set when the checkbox is focused.\n`indeterminate`      | Set when the checkbox is in the indeterminate state.\n`invalid`            | Set when the checkbox is invalid.\n`has-label`          | Set when the checkbox has a label.\n`has-helper`         | Set when the checkbox has helper text.\n`has-error-message`  | Set when the checkbox has an error message.\n\nSee [Styling Components](https://vaadin.com/docs/latest/styling/styling-components) documentation.",
+          "attributes": [
+            {
+              "name": "disabled",
+              "description": "If true, the user cannot interact with this element.",
+              "value": {
+                "type": [
+                  "boolean",
+                  "null",
+                  "undefined"
+                ]
+              }
+            },
+            {
+              "name": "value",
+              "description": "The value of the field.",
+              "value": {
+                "type": [
+                  "string",
+                  "null",
+                  "undefined"
+                ]
+              }
+            },
+            {
+              "name": "checked",
+              "description": "True if the element is checked.",
+              "value": {
+                "type": [
+                  "boolean"
+                ]
+              }
+            },
+            {
+              "name": "autofocus",
+              "description": "Specify that this control should have input focus when the page loads.",
+              "value": {
+                "type": [
+                  "boolean",
+                  "null",
+                  "undefined"
+                ]
+              }
+            },
+            {
+              "name": "label",
+              "description": "The label text for the input node.\nWhen no light dom defined via [slot=label], this value will be used.",
+              "value": {
+                "type": [
+                  "string",
+                  "null",
+                  "undefined"
+                ]
+              }
+            },
+            {
+              "name": "invalid",
+              "description": "Set to true when the field is invalid.",
+              "value": {
+                "type": [
+                  "boolean",
+                  "null",
+                  "undefined"
+                ]
+              }
+            },
+            {
+              "name": "required",
+              "description": "Specifies that the user must fill in a value.",
+              "value": {
+                "type": [
+                  "boolean",
+                  "null",
+                  "undefined"
+                ]
+              }
+            },
+            {
+              "name": "error-message",
+              "description": "Error to show when the field is invalid.",
+              "value": {
+                "type": [
+                  "string",
+                  "null",
+                  "undefined"
+                ]
+              }
+            },
+            {
+              "name": "helper-text",
+              "description": "String used for the helper text.",
+              "value": {
+                "type": [
+                  "string",
+                  "null",
+                  "undefined"
+                ]
+              }
+            },
+            {
+              "name": "accessible-name",
+              "description": "String used to label the component to screen reader users.",
+              "value": {
+                "type": [
+                  "string",
+                  "null",
+                  "undefined"
+                ]
+              }
+            },
+            {
+              "name": "accessible-name-ref",
+              "description": "Id of the element used as label of the component to screen reader users.",
+              "value": {
+                "type": [
+                  "string",
+                  "null",
+                  "undefined"
+                ]
+              }
+            },
+            {
+              "name": "indeterminate",
+              "description": "True if the checkbox is in the indeterminate state which means\nit is not possible to say whether it is checked or unchecked.\nThe state is reset once the user switches the checkbox by hand.\n\nhttps://developer.mozilla.org/en-US/docs/Web/HTML/Element/input/checkbox#Indeterminate_state_checkboxes",
+              "value": {
+                "type": [
+                  "boolean"
+                ]
+              }
+            },
+            {
+              "name": "name",
+              "description": "The name of the checkbox.",
+              "value": {
+                "type": [
+                  "string"
+                ]
+              }
+            },
+            {
+              "name": "readonly",
+              "description": "When true, the user cannot modify the value of the checkbox.\nThe difference between `disabled` and `readonly` is that the\nread-only checkbox remains focusable, is announced by screen\nreaders and its value can be submitted as part of the form.",
+              "value": {
+                "type": [
+                  "boolean",
+                  "null",
+                  "undefined"
+                ]
+              }
+            },
+            {
+              "name": "theme",
+              "description": "The theme variants to apply to the component.",
+              "value": {
+                "type": [
+                  "string",
+                  "null",
+                  "undefined"
+                ]
+              }
+            }
+          ],
+          "js": {
+            "properties": [
+              {
+                "name": "disabled",
+                "description": "If true, the user cannot interact with this element.",
+                "value": {
+                  "type": [
+                    "boolean",
+                    "null",
+                    "undefined"
+                  ]
+                }
+              },
+              {
+                "name": "value",
+                "description": "The value of the field.",
+                "value": {
+                  "type": [
+                    "string",
+                    "null",
+                    "undefined"
+                  ]
+                }
+              },
+              {
+                "name": "checked",
+                "description": "True if the element is checked.",
+                "value": {
+                  "type": [
+                    "boolean"
+                  ]
+                }
+              },
+              {
+                "name": "autofocus",
+                "description": "Specify that this control should have input focus when the page loads.",
+                "value": {
+                  "type": [
+                    "boolean",
+                    "null",
+                    "undefined"
+                  ]
+                }
+              },
+              {
+                "name": "label",
+                "description": "The label text for the input node.\nWhen no light dom defined via [slot=label], this value will be used.",
+                "value": {
+                  "type": [
+                    "string",
+                    "null",
+                    "undefined"
+                  ]
+                }
+              },
+              {
+                "name": "invalid",
+                "description": "Set to true when the field is invalid.",
+                "value": {
+                  "type": [
+                    "boolean",
+                    "null",
+                    "undefined"
+                  ]
+                }
+              },
+              {
+                "name": "required",
+                "description": "Specifies that the user must fill in a value.",
+                "value": {
+                  "type": [
+                    "boolean",
+                    "null",
+                    "undefined"
+                  ]
+                }
+              },
+              {
+                "name": "errorMessage",
+                "description": "Error to show when the field is invalid.",
+                "value": {
+                  "type": [
+                    "string",
+                    "null",
+                    "undefined"
+                  ]
+                }
+              },
+              {
+                "name": "helperText",
+                "description": "String used for the helper text.",
+                "value": {
+                  "type": [
+                    "string",
+                    "null",
+                    "undefined"
+                  ]
+                }
+              },
+              {
+                "name": "accessibleName",
+                "description": "String used to label the component to screen reader users.",
+                "value": {
+                  "type": [
+                    "string",
+                    "null",
+                    "undefined"
+                  ]
+                }
+              },
+              {
+                "name": "accessibleNameRef",
+                "description": "Id of the element used as label of the component to screen reader users.",
+                "value": {
+                  "type": [
+                    "string",
+                    "null",
+                    "undefined"
+                  ]
+                }
+              },
+              {
+                "name": "indeterminate",
+                "description": "True if the checkbox is in the indeterminate state which means\nit is not possible to say whether it is checked or unchecked.\nThe state is reset once the user switches the checkbox by hand.\n\nhttps://developer.mozilla.org/en-US/docs/Web/HTML/Element/input/checkbox#Indeterminate_state_checkboxes",
+                "value": {
+                  "type": [
+                    "boolean"
+                  ]
+                }
+              },
+              {
+                "name": "name",
+                "description": "The name of the checkbox.",
+                "value": {
+                  "type": [
+                    "string"
+                  ]
+                }
+              },
+              {
+                "name": "readonly",
+                "description": "When true, the user cannot modify the value of the checkbox.\nThe difference between `disabled` and `readonly` is that the\nread-only checkbox remains focusable, is announced by screen\nreaders and its value can be submitted as part of the form.",
+                "value": {
+                  "type": [
+                    "boolean",
+                    "null",
+                    "undefined"
+                  ]
+                }
+              }
+            ],
+            "events": [
+              {
+                "name": "validated",
+                "description": "Fired whenever the field is validated."
+              },
+              {
+                "name": "change",
+                "description": "Fired when the checkbox is checked or unchecked by the user."
+              },
+              {
+                "name": "value-changed",
+                "description": "Fired when the `value` property changes."
+              },
+              {
+                "name": "checked-changed",
+                "description": "Fired when the `checked` property changes."
+              },
+              {
+                "name": "invalid-changed",
+                "description": "Fired when the `invalid` property changes."
+              },
+              {
+                "name": "indeterminate-changed",
+                "description": "Fired when the `indeterminate` property changes."
+              }
+            ]
+          }
+        }
+      ]
+    }
+  }
+}