experiment: add dashboard base styles and visual tests (#9679)

* chore: copy existing core styles as base styles

* experiment: dashboard widget styles and controls icons

* experiment: dashboard section border and outline styles

* test: add visual tests for base styles

* chore: do not publish base styles to npm

* dashboard button text color

* use em instead of rem for default values

* reduce default gap

* remove redundant fallback value

* add header gap

* remove unnecessary margin from title

* fix icon fallback size

* add properties to customize widget title styles

* remove redundant custom property

not used anywhere else

* simplify widget and section border and outline styles

* add custom property to customize widget header padding

* allow widget header to overflow

* fix drag icon size

* fix resizing styles

* test: update reference screenshots

* disable lint error

* fix forced color mode

---------

Co-authored-by: Jouni Koivuviita <jouni@vaadin.com>

Author: web-padawan

packages/component-base/src/style-props.js

@@ -21,6 +21,8 @@
   "type": "module",
   "files": [
     "src",
+    "!src/styles/*-base-styles.d.ts",
+    "!src/styles/*-base-styles.js",
     "theme",
     "vaadin-*.d.ts",
     "vaadin-*.js",

packages/dashboard/package.json

@@ -0,0 +1,13 @@
+/**
+ * @license
+ * Copyright (c) 2000 - 2025 Vaadin Ltd.
+ *
+ * This program is available under Vaadin Commercial License and Service Terms.
+ *
+ *
+ * See https://vaadin.com/commercial-license-and-service-terms for the full
+ * license.
+ */
+import type { CSSResult } from 'lit';
+
+export const dashboardStyles: CSSResult;

packages/dashboard/src/styles/vaadin-dashboard-base-styles.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @license
+ * Copyright (c) 2000 - 2025 Vaadin Ltd.
+ *
+ * This program is available under Vaadin Commercial License and Service Terms.
+ *
+ *
+ * See https://vaadin.com/commercial-license-and-service-terms for the full
+ * license.
+ */
+import { css } from 'lit';
+import { dashboardLayoutStyles } from './vaadin-dashboard-layout-core-styles.js';
+
+const dashboard = css`
+  #grid[item-resizing] {
+    -webkit-user-select: none;
+    user-select: none;
+  }
+
+  ::slotted(vaadin-dashboard-widget-wrapper) {
+    display: contents;
+  }
+`;
+
+export const dashboardStyles = [dashboardLayoutStyles, dashboard];

packages/dashboard/src/styles/vaadin-dashboard-base-styles.js

@@ -0,0 +1,13 @@
+/**
+ * @license
+ * Copyright (c) 2000 - 2025 Vaadin Ltd.
+ *
+ * This program is available under Vaadin Commercial License and Service Terms.
+ *
+ *
+ * See https://vaadin.com/commercial-license-and-service-terms for the full
+ * license.
+ */
+import type { CSSResult } from 'lit';
+
+export const dashboardButtonStyles: CSSResult;

packages/dashboard/src/styles/vaadin-dashboard-button-base-styles.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @license
+ * Copyright (c) 2000 - 2025 Vaadin Ltd.
+ *
+ * This program is available under Vaadin Commercial License and Service Terms.
+ *
+ *
+ * See https://vaadin.com/commercial-license-and-service-terms for the full
+ * license.
+ */
+import { css } from 'lit';
+import { buttonStyles } from '@vaadin/button/src/styles/vaadin-button-core-styles.js';
+
+const dashboardButton = css`
+  :host {
+    min-width: 1em;
+  }
+
+  :host([theme~='tertiary']) {
+    color: var(--vaadin-dashboard-button-text-color, var(--vaadin-color-subtle));
+  }
+`;
+
+export const dashboardButtonStyles = [buttonStyles, dashboardButton];

packages/dashboard/src/styles/vaadin-dashboard-button-base-styles.js

@@ -0,0 +1,13 @@
+/**
+ * @license
+ * Copyright (c) 2000 - 2025 Vaadin Ltd.
+ *
+ * This program is available under Vaadin Commercial License and Service Terms.
+ *
+ *
+ * See https://vaadin.com/commercial-license-and-service-terms for the full
+ * license.
+ */
+import type { CSSResult } from 'lit';
+
+export const dashboardLayoutStyles: CSSResult;

packages/dashboard/src/styles/vaadin-dashboard-layout-base-styles.d.ts

@@ -0,0 +1,85 @@
+/**
+ * @license
+ * Copyright (c) 2000 - 2025 Vaadin Ltd.
+ *
+ * This program is available under Vaadin Commercial License and Service Terms.
+ *
+ *
+ * See https://vaadin.com/commercial-license-and-service-terms for the full
+ * license.
+ */
+import { css } from 'lit';
+
+export const dashboardLayoutStyles = css`
+  :host {
+    display: block;
+    overflow: auto;
+    box-sizing: border-box;
+    width: 100%;
+  }
+
+  :host([hidden]) {
+    display: none !important;
+  }
+
+  :host([dense-layout]) #grid {
+    grid-auto-flow: dense;
+  }
+
+  #grid {
+    box-sizing: border-box;
+
+    /* Padding around dashboard edges */
+    --_default-padding: 1em;
+    --_padding: max(0px, var(--vaadin-dashboard-padding, var(--_default-padding)));
+    padding: var(--_padding);
+
+    /* Gap between widgets */
+    --_default-gap: 0.5em;
+    --_gap: max(0px, var(--vaadin-dashboard-gap, var(--_default-gap)));
+    gap: var(--_gap);
+
+    /* Default min and max column widths */
+    --_default-col-min-width: 25em;
+    --_default-col-max-width: 1fr;
+
+    /* Effective min and max column widths */
+    --_col-min-width: var(--vaadin-dashboard-col-min-width, var(--_default-col-min-width));
+    --_col-max-width: var(--vaadin-dashboard-col-max-width, var(--_default-col-max-width));
+
+    /* Effective max column count */
+    --_col-max-count: var(--vaadin-dashboard-col-max-count, var(--_col-count));
+
+    /* Effective column count */
+    --_effective-col-count: min(var(--_col-count), var(--_col-max-count));
+
+    /* Default row min height */
+    --_default-row-min-height: 12em;
+    /* Effective row min height */
+    --_row-min-height: var(--vaadin-dashboard-row-min-height, var(--_default-row-min-height));
+    /* Effective row height */
+    --_row-height: minmax(var(--_row-min-height, auto), auto);
+
+    display: grid;
+    overflow: hidden;
+    min-width: calc(var(--_col-min-width) + var(--_padding) * 2);
+
+    grid-template-columns: repeat(
+      var(--_effective-col-count, auto-fill),
+      minmax(var(--_col-min-width), var(--_col-max-width))
+    );
+
+    grid-auto-rows: var(--_row-height);
+  }
+
+  ::slotted(*) {
+    /* The grid-column value applied to children */
+    --_item-column: span min(var(--vaadin-dashboard-widget-colspan, 1), var(--_effective-col-count, var(--_col-count)));
+
+    grid-column: var(--_item-column);
+
+    /* The grid-row value applied to children */
+    --_item-row: span var(--vaadin-dashboard-widget-rowspan, 1);
+    grid-row: var(--_item-row);
+  }
+`;

packages/dashboard/src/styles/vaadin-dashboard-layout-base-styles.js

@@ -0,0 +1,13 @@
+/**
+ * @license
+ * Copyright (c) 2000 - 2025 Vaadin Ltd.
+ *
+ * This program is available under Vaadin Commercial License and Service Terms.
+ *
+ *
+ * See https://vaadin.com/commercial-license-and-service-terms for the full
+ * license.
+ */
+import type { CSSResult } from 'lit';
+
+export const dashboardSectionStyles: CSSResult;

packages/dashboard/src/styles/vaadin-dashboard-section-base-styles.d.ts

@@ -0,0 +1,66 @@
+/**
+ * @license
+ * Copyright (c) 2000 - 2025 Vaadin Ltd.
+ *
+ * This program is available under Vaadin Commercial License and Service Terms.
+ *
+ *
+ * See https://vaadin.com/commercial-license-and-service-terms for the full
+ * license.
+ */
+import '@vaadin/component-base/src/style-props.js';
+import { css } from 'lit';
+import { dashboardWidgetAndSectionStyles } from './vaadin-dashboard-widget-section-core-styles.js';
+
+const sectionStyles = css`
+  /* stylelint-disable length-zero-no-unit */
+
+  :host {
+    display: grid;
+    position: relative;
+    grid-template-columns: subgrid;
+    --_section-column: 1 / calc(var(--_effective-col-count) + 1);
+    grid-column: var(--_section-column) !important;
+    gap: var(--_gap);
+    /* Dashboard section header height */
+    grid-template-rows: minmax(0, auto) repeat(auto-fill, var(--_row-height));
+    grid-auto-rows: var(--_row-height);
+    border: var(--_widget-border-width) solid var(--_widget-border-color);
+    border-radius: var(--vaadin-dashboard-section-border-radius, var(--vaadin-radius-l));
+    padding: calc(var(--_gap) - var(--_widget-border-width));
+    margin-inline: calc(var(--_gap) * -1);
+    margin-block: var(--_gap);
+  }
+
+  :host([hidden]) {
+    display: none !important;
+  }
+
+  ::slotted(*) {
+    --_item-column: span min(var(--vaadin-dashboard-widget-colspan, 1), var(--_effective-col-count, var(--_col-count)));
+
+    grid-column: var(--_item-column);
+    --_item-row: span var(--vaadin-dashboard-widget-rowspan, 1);
+    grid-row: var(--_item-row);
+  }
+
+  header {
+    grid-column: var(--_section-column);
+  }
+
+  :host::before {
+    z-index: 2 !important;
+  }
+
+  ::slotted(vaadin-dashboard-widget-wrapper) {
+    display: contents;
+  }
+
+  /* Section states */
+
+  :host(:not([editable])) {
+    --_widget-border-width: 0px;
+  }
+`;
+
+export const dashboardSectionStyles = [sectionStyles, dashboardWidgetAndSectionStyles];