@vaadin/select 24.8.4 → 25.0.0-alpha10

package/README.md

@@ -39,35 +39,6 @@ Install the component:
 npm i @vaadin/select
 ```
 
-Once installed, import the component in your application:
-
-```js
-import '@vaadin/select';
-```
-
-## Themes
-
-Vaadin components come with two built-in [themes](https://vaadin.com/docs/latest/styling), Lumo and Material.
-The [main entrypoint](https://github.com/vaadin/web-components/blob/main/packages/select/vaadin-select.js) of the package uses the Lumo theme.
-
-To use the Material theme, import the component from the `theme/material` folder:
-
-```js
-import '@vaadin/select/theme/material/vaadin-select.js';
-```
-
-You can also import the Lumo version of the component explicitly:
-
-```js
-import '@vaadin/select/theme/lumo/vaadin-select.js';
-```
-
-Finally, you can import the un-themed component from the `src` folder to get a minimal starting point:
-
-```js
-import '@vaadin/select/src/vaadin-select.js';
-```
-
 ## Contributing
 
 Read the [contributing guide](https://vaadin.com/docs/latest/contributing) to learn about our development process, how to propose bugfixes and improvements, and how to test your changes to Vaadin components.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vaadin/select",
-  "version": "24.8.4",
+  "version": "25.0.0-alpha10",
   "publishConfig": {
     "access": "public"
   },
@@ -23,6 +23,8 @@
     "lit.d.ts",
     "lit.js",
     "src",
+    "!src/styles/*-base-styles.d.ts",
+    "!src/styles/*-base-styles.js",
     "theme",
     "vaadin-*.d.ts",
     "vaadin-*.js",
@@ -33,35 +35,32 @@
     "Vaadin",
     "vaadin-select",
     "web-components",
-    "web-component",
-    "polymer"
+    "web-component"
   ],
   "dependencies": {
     "@open-wc/dedupe-mixin": "^1.3.0",
-    "@polymer/polymer": "^3.2.0",
-    "@vaadin/a11y-base": "~24.8.4",
-    "@vaadin/button": "~24.8.4",
-    "@vaadin/component-base": "~24.8.4",
-    "@vaadin/field-base": "~24.8.4",
-    "@vaadin/input-container": "~24.8.4",
-    "@vaadin/item": "~24.8.4",
-    "@vaadin/list-box": "~24.8.4",
-    "@vaadin/lit-renderer": "~24.8.4",
-    "@vaadin/overlay": "~24.8.4",
-    "@vaadin/vaadin-lumo-styles": "~24.8.4",
-    "@vaadin/vaadin-material-styles": "~24.8.4",
-    "@vaadin/vaadin-themable-mixin": "~24.8.4",
+    "@vaadin/a11y-base": "25.0.0-alpha10",
+    "@vaadin/button": "25.0.0-alpha10",
+    "@vaadin/component-base": "25.0.0-alpha10",
+    "@vaadin/field-base": "25.0.0-alpha10",
+    "@vaadin/input-container": "25.0.0-alpha10",
+    "@vaadin/item": "25.0.0-alpha10",
+    "@vaadin/list-box": "25.0.0-alpha10",
+    "@vaadin/lit-renderer": "25.0.0-alpha10",
+    "@vaadin/overlay": "25.0.0-alpha10",
+    "@vaadin/vaadin-lumo-styles": "25.0.0-alpha10",
+    "@vaadin/vaadin-themable-mixin": "25.0.0-alpha10",
     "lit": "^3.0.0"
   },
   "devDependencies": {
-    "@vaadin/chai-plugins": "~24.8.4",
-    "@vaadin/test-runner-commands": "~24.8.4",
-    "@vaadin/testing-helpers": "^1.1.0",
+    "@vaadin/chai-plugins": "25.0.0-alpha10",
+    "@vaadin/test-runner-commands": "25.0.0-alpha10",
+    "@vaadin/testing-helpers": "^2.0.0",
     "sinon": "^18.0.0"
   },
   "web-types": [
     "web-types.json",
     "web-types.lit.json"
   ],
-  "gitHead": "849e54e967563080a685965e2dced02060b3ab23"
+  "gitHead": "6cc6c94079e805fa5b2f0af4dbf3b2a7485e57d0"
 }

package/src/styles/vaadin-select-base-styles.js

@@ -0,0 +1,38 @@
+/**
+ * @license
+ * Copyright (c) 2017 - 2025 Vaadin Ltd.
+ * This program is available under Apache License Version 2.0, available at https://vaadin.com/license/
+ */
+import '@vaadin/component-base/src/style-props.js';
+import { css } from 'lit';
+
+export const selectStyles = css`
+  :host {
+    position: relative;
+  }
+
+  ::slotted([slot='value']) {
+    flex: 1;
+  }
+
+  ::slotted(div[slot='overlay']) {
+    display: contents;
+  }
+
+  :host(:not([focus-ring])) [part='input-field'] {
+    outline: none;
+  }
+
+  :host([readonly]:not([focus-ring])) [part='input-field'] {
+    --vaadin-input-field-border-color: inherit;
+  }
+
+  [part='input-field'],
+  :host(:not([readonly])) ::slotted([slot='value']) {
+    cursor: var(--vaadin-clickable-cursor);
+  }
+
+  [part='toggle-button']::before {
+    mask-image: var(--_vaadin-icon-chevron-down);
+  }
+`;

package/{theme/material/vaadin-lit-select.d.ts → src/styles/vaadin-select-core-styles.d.ts}

@@ -3,5 +3,6 @@
  * Copyright (c) 2017 - 2025 Vaadin Ltd.
  * This program is available under Apache License Version 2.0, available at https://vaadin.com/license/
  */
-import './vaadin-select-styles.js';
-import '../../src/vaadin-lit-select.js';
+import type { CSSResult } from 'lit';
+
+export const selectStyles: CSSResult;

package/src/{vaadin-select-core-styles.js → styles/vaadin-select-core-styles.js}

@@ -13,4 +13,8 @@ export const selectStyles = css`
   ::slotted([slot='value']) {
     flex-grow: 1;
   }
+
+  ::slotted(div[slot='overlay']) {
+    display: contents;
+  }
 `;

package/src/styles/vaadin-select-overlay-base-styles.js

@@ -0,0 +1,21 @@
+/**
+ * @license
+ * Copyright (c) 2017 - 2025 Vaadin Ltd.
+ * This program is available under Apache License Version 2.0, available at https://vaadin.com/license/
+ */
+import { css } from 'lit';
+
+export const selectOverlayStyles = css`
+  :host {
+    align-items: flex-start;
+    justify-content: flex-start;
+  }
+
+  :host(:not([phone])) [part='overlay'] {
+    min-width: var(--vaadin-select-overlay-width, var(--_vaadin-select-overlay-default-width));
+  }
+
+  [part='content'] {
+    padding: var(--vaadin-item-overlay-padding, 4px);
+  }
+`;

package/src/{vaadin-select-overlay-core-styles.js → styles/vaadin-select-overlay-core-styles.js}

@@ -12,7 +12,7 @@ export const selectOverlayStyles = css`
   }
 
   :host(:not([phone])) [part='overlay'] {
-    min-width: var(--vaadin-select-overlay-width, var(--vaadin-select-text-field-width));
+    min-width: var(--vaadin-select-overlay-width, var(--_vaadin-select-overlay-default-width));
   }
 
   @media (forced-colors: active) {

package/src/styles/vaadin-select-value-button-base-styles.js

@@ -0,0 +1,30 @@
+/**
+ * @license
+ * Copyright (c) 2017 - 2025 Vaadin Ltd.
+ * This program is available under Apache License Version 2.0, available at https://vaadin.com/license/
+ */
+import { css } from 'lit';
+
+export const valueButton = css`
+  :host {
+    min-height: 1lh;
+    outline: none;
+    overflow: hidden;
+    white-space: nowrap;
+    width: 100%;
+  }
+
+  ::slotted(*) {
+    padding: 0;
+    cursor: inherit;
+  }
+
+  .vaadin-button-container,
+  [part='label'] {
+    display: contents;
+  }
+
+  :host([disabled]) {
+    pointer-events: none;
+  }
+`;

package/src/vaadin-select-base-mixin.js

@@ -63,6 +63,7 @@ export const SelectBaseMixin = (superClass) =>
           type: Boolean,
           value: false,
           notify: true,
+          observer: '_openedChanged',
           reflectToAttribute: true,
           sync: true,
         },
@@ -160,11 +161,7 @@ export const SelectBaseMixin = (superClass) =>
     }
 
     static get observers() {
-      return [
-        '_updateAriaExpanded(opened, focusElement)',
-        '_updateSelectedItem(value, _items, placeholder)',
-        '_openedChanged(opened, _overlayElement)',
-      ];
+      return ['_updateAriaExpanded(opened, focusElement)', '_updateSelectedItem(value, _items, placeholder)'];
     }
 
     constructor() {
@@ -207,6 +204,15 @@ export const SelectBaseMixin = (superClass) =>
       this.addController(this._tooltipController);
     }
 
+    /** @protected */
+    updated(props) {
+      super.updated(props);
+
+      if (props.has('_phone')) {
+        this.toggleAttribute('phone', this._phone);
+      }
+    }
+
     /**
      * Requests an update for the content of the select.
      * While performing the update, it invokes the renderer passed in the `renderer` property.
@@ -219,10 +225,6 @@ export const SelectBaseMixin = (superClass) =>
       }
 
       this._overlayElement.requestContentUpdate();
-
-      if (this._menuElement && this._menuElement.items) {
-        this._updateSelectedItem(this.value, this._menuElement.items);
-      }
     }
 
     /**
@@ -283,6 +285,12 @@ export const SelectBaseMixin = (superClass) =>
         // Store the menu element reference
         this.__lastMenuElement = menuElement;
       }
+
+      // When the renderer was re-assigned so that menu element is preserved
+      // but its items have changed, make sure selected property is updated.
+      if (this._menuElement && this._menuElement.items) {
+        this._updateSelectedItem(this.value, this._menuElement.items);
+      }
     }
 
     /** @private */
@@ -364,17 +372,21 @@ export const SelectBaseMixin = (superClass) =>
      * @protected
      */
     _onKeyDownInside(e) {
-      if (/^(Tab)$/u.test(e.key)) {
+      if (e.key === 'Tab') {
+        // Temporarily set tabindex to prevent moving focus
+        // to the value button element on item Shift + Tab
+        this.focusElement.setAttribute('tabindex', '-1');
+        this._overlayElement.restoreFocusOnClose = false;
         this.opened = false;
+        setTimeout(() => {
+          this.focusElement.setAttribute('tabindex', '0');
+          this._overlayElement.restoreFocusOnClose = true;
+        });
       }
     }
 
     /** @private */
-    _openedChanged(opened, overlayElement) {
-      if (!overlayElement) {
-        return;
-      }
-
+    _openedChanged(opened, oldOpened) {
       if (opened) {
         if (this.disabled || this.readonly) {
           // Disallow programmatic opening when disabled or readonly
@@ -385,8 +397,6 @@ export const SelectBaseMixin = (superClass) =>
         // Avoid multiple announcements when a value gets selected from the dropdown
         this._updateAriaLive(false);
 
-        overlayElement.style.setProperty('--vaadin-select-text-field-width', `${this._inputContainer.offsetWidth}px`);
-
         // Preserve focus-ring to restore it later
         const hasFocusRing = this.hasAttribute('focus-ring');
         this._openedWithFocusRing = hasFocusRing;
@@ -395,7 +405,7 @@ export const SelectBaseMixin = (superClass) =>
         if (hasFocusRing) {
           this.removeAttribute('focus-ring');
         }
-      } else if (this.__oldOpened) {
+      } else if (oldOpened) {
         if (this._openedWithFocusRing) {
           this.setAttribute('focus-ring', '');
         }
@@ -407,8 +417,6 @@ export const SelectBaseMixin = (superClass) =>
           this._requestValidation();
         }
       }
-
-      this.__oldOpened = opened;
     }
 
     /** @private */
@@ -596,8 +604,8 @@ export const SelectBaseMixin = (superClass) =>
      * @protected
      * @override
      */
-    _shouldRemoveFocus() {
-      return !this.opened;
+    _shouldRemoveFocus(event) {
+      return !this.contains(event.relatedTarget);
     }
 
     /**
@@ -650,13 +658,7 @@ export const SelectBaseMixin = (superClass) =>
     }
 
     /** @private */
-    async __dispatchChange() {
-      // Wait for the update complete to guarantee that value-changed is fired
-      // before validated and change events when using the Lit version of the component.
-      if (this.updateComplete) {
-        await this.updateComplete;
-      }
-
+    __dispatchChange() {
       this._requestValidation();
       this.dispatchEvent(new CustomEvent('change', { bubbles: true }));
       this.__dispatchChangePending = false;

package/src/vaadin-select-item.js

@@ -3,14 +3,14 @@
  * Copyright (c) 2017 - 2025 Vaadin Ltd.
  * This program is available under Apache License Version 2.0, available at https://vaadin.com/license/
  */
-import { html, PolymerElement } from '@polymer/polymer/polymer-element.js';
+import { html, LitElement } from 'lit';
 import { defineCustomElement } from '@vaadin/component-base/src/define.js';
 import { DirMixin } from '@vaadin/component-base/src/dir-mixin.js';
-import { itemStyles } from '@vaadin/item/src/vaadin-item-core-styles.js';
+import { PolylitMixin } from '@vaadin/component-base/src/polylit-mixin.js';
+import { itemStyles } from '@vaadin/item/src/styles/vaadin-item-core-styles.js';
 import { ItemMixin } from '@vaadin/item/src/vaadin-item-mixin.js';
-import { registerStyles, ThemableMixin } from '@vaadin/vaadin-themable-mixin/vaadin-themable-mixin.js';
-
-registerStyles('vaadin-select-item', itemStyles, { moduleId: 'vaadin-select-item-styles' });
+import { LumoInjectionMixin } from '@vaadin/vaadin-themable-mixin/lumo-injection-mixin.js';
+import { ThemableMixin } from '@vaadin/vaadin-themable-mixin/vaadin-themable-mixin.js';
 
 /**
  * An element used internally by `<vaadin-select>`. Not intended to be used separately.
@@ -22,12 +22,35 @@ registerStyles('vaadin-select-item', itemStyles, { moduleId: 'vaadin-select-item
  * @mixes ThemableMixin
  * @protected
  */
-class SelectItem extends ItemMixin(ThemableMixin(DirMixin(PolymerElement))) {
+class SelectItem extends ItemMixin(ThemableMixin(DirMixin(PolylitMixin(LumoInjectionMixin(LitElement))))) {
   static get is() {
     return 'vaadin-select-item';
   }
 
-  static get template() {
+  static get styles() {
+    return itemStyles;
+  }
+
+  static get properties() {
+    return {
+      /**
+       * Use property instead of setting an attribute in `ready()`
+       * for cloning the selected item attached to the value button:
+       * in this case, `role` attribute is removed synchronously, and
+       * using `ready()` would incorrectly restore the attribute.
+       *
+       * @protected
+       */
+      role: {
+        type: String,
+        value: 'option',
+        reflectToAttribute: true,
+      },
+    };
+  }
+
+  /** @protected */
+  render() {
     return html`
       <span part="checkmark" aria-hidden="true"></span>
       <div part="content">
@@ -35,13 +58,6 @@ class SelectItem extends ItemMixin(ThemableMixin(DirMixin(PolymerElement))) {
       </div>
     `;
   }
-
-  /** @protected */
-  ready() {
-    super.ready();
-
-    this.setAttribute('role', 'option');
-  }
 }
 
 defineCustomElement(SelectItem);

package/src/vaadin-select-list-box.d.ts

@@ -4,14 +4,13 @@
  * This program is available under Apache License Version 2.0, available at https://vaadin.com/license/
  */
 import { ListMixin } from '@vaadin/a11y-base/src/list-mixin.js';
-import { ControllerMixin } from '@vaadin/component-base/src/controller-mixin.js';
 import { DirMixin } from '@vaadin/component-base/src/dir-mixin.js';
 import { ThemableMixin } from '@vaadin/vaadin-themable-mixin/vaadin-themable-mixin.js';
 
 /**
  * An element used internally by `<vaadin-select>`. Not intended to be used separately.
  */
-declare class SelectListBox extends ListMixin(DirMixin(ThemableMixin(ControllerMixin(HTMLElement)))) {}
+declare class SelectListBox extends ListMixin(DirMixin(ThemableMixin(HTMLElement))) {}
 
 declare global {
   interface HTMLElementTagNameMap {

package/src/vaadin-select-list-box.js

@@ -3,38 +3,32 @@
  * Copyright (c) 2017 - 2025 Vaadin Ltd.
  * This program is available under Apache License Version 2.0, available at https://vaadin.com/license/
  */
-import { html, PolymerElement } from '@polymer/polymer/polymer-element.js';
+import { html, LitElement } from 'lit';
 import { ListMixin } from '@vaadin/a11y-base/src/list-mixin.js';
-import { ControllerMixin } from '@vaadin/component-base/src/controller-mixin.js';
 import { defineCustomElement } from '@vaadin/component-base/src/define.js';
 import { DirMixin } from '@vaadin/component-base/src/dir-mixin.js';
-import { listBoxStyles } from '@vaadin/list-box/src/vaadin-list-box-core-styles.js';
-import { registerStyles, ThemableMixin } from '@vaadin/vaadin-themable-mixin/vaadin-themable-mixin.js';
-
-registerStyles('vaadin-select-list-box', listBoxStyles, { moduleId: 'vaadin-select-list-box-styles' });
+import { PolylitMixin } from '@vaadin/component-base/src/polylit-mixin.js';
+import { listBoxStyles } from '@vaadin/list-box/src/styles/vaadin-list-box-core-styles.js';
+import { LumoInjectionMixin } from '@vaadin/vaadin-themable-mixin/lumo-injection-mixin.js';
+import { ThemableMixin } from '@vaadin/vaadin-themable-mixin/vaadin-themable-mixin.js';
 
 /**
  * An element used internally by `<vaadin-select>`. Not intended to be used separately.
  *
  * @customElement
  * @extends HTMLElement
- * @mixes ControllerMixin
  * @mixes DirMixin
  * @mixes ListMixin
  * @mixes ThemableMixin
  * @protected
  */
-class SelectListBox extends ListMixin(ThemableMixin(DirMixin(ControllerMixin(PolymerElement)))) {
+class SelectListBox extends ListMixin(ThemableMixin(DirMixin(PolylitMixin(LumoInjectionMixin(LitElement))))) {
   static get is() {
     return 'vaadin-select-list-box';
   }
 
-  static get template() {
-    return html`
-      <div part="items">
-        <slot></slot>
-      </div>
-    `;
+  static get styles() {
+    return listBoxStyles;
   }
 
   static get properties() {
@@ -57,6 +51,15 @@ class SelectListBox extends ListMixin(ThemableMixin(DirMixin(ControllerMixin(Pol
     return this.shadowRoot.querySelector('[part="items"]');
   }
 
+  /** @protected */
+  render() {
+    return html`
+      <div part="items">
+        <slot></slot>
+      </div>
+    `;
+  }
+
   /** @protected */
   ready() {
     super.ready();

package/src/vaadin-select-overlay-mixin.js

@@ -16,7 +16,7 @@ import { PositionMixin } from '@vaadin/overlay/src/vaadin-overlay-position-mixin
 export const SelectOverlayMixin = (superClass) =>
   class SelectOverlayMixin extends PositionMixin(OverlayMixin(DirMixin(superClass))) {
     static get observers() {
-      return ['_updateOverlayWidth(opened, owner)'];
+      return ['_updateOverlayWidth(opened, positionTarget)'];
     }
 
     /** @protected */
@@ -26,6 +26,21 @@ export const SelectOverlayMixin = (superClass) =>
       this.restoreFocusOnClose = true;
     }
 
+    /**
+     * @override
+     * @protected
+     */
+    get _contentRoot() {
+      if (!this.__savedRoot) {
+        const root = document.createElement('div');
+        root.setAttribute('slot', 'overlay');
+        this.owner.appendChild(root);
+        this.__savedRoot = root;
+      }
+
+      return this.__savedRoot;
+    }
+
     /**
      * Override method inherited from `Overlay` to always close on outside click,
      * in order to avoid problem when using inside of the modeless dialog.
@@ -38,22 +53,26 @@ export const SelectOverlayMixin = (superClass) =>
       return true;
     }
 
+    /**
+     * @protected
+     * @override
+     */
+    _mouseDownListener(event) {
+      super._mouseDownListener(event);
+
+      // Prevent global mousedown event to avoid losing focus on outside click
+      event.preventDefault();
+    }
+
     /** @protected */
     _getMenuElement() {
-      return Array.from(this.children).find((el) => el.localName !== 'style');
+      return Array.from(this._contentRoot.children).find((el) => el.localName !== 'style');
     }
 
     /** @private */
-    _updateOverlayWidth(opened, owner) {
-      if (opened && owner) {
-        const widthProperty = '--vaadin-select-overlay-width';
-        const customWidth = getComputedStyle(owner).getPropertyValue(widthProperty);
-
-        if (customWidth === '') {
-          this.style.removeProperty(widthProperty);
-        } else {
-          this.style.setProperty(widthProperty, customWidth);
-        }
+    _updateOverlayWidth(opened, positionTarget) {
+      if (opened && positionTarget) {
+        this.style.setProperty('--_vaadin-select-overlay-default-width', `${positionTarget.offsetWidth}px`);
       }
     }
 

package/src/vaadin-select-overlay.js

@@ -3,17 +3,15 @@
  * Copyright (c) 2017 - 2025 Vaadin Ltd.
  * This program is available under Apache License Version 2.0, available at https://vaadin.com/license/
  */
-import { html, PolymerElement } from '@polymer/polymer/polymer-element.js';
+import { html, LitElement } from 'lit';
 import { defineCustomElement } from '@vaadin/component-base/src/define.js';
-import { overlayStyles } from '@vaadin/overlay/src/vaadin-overlay-styles.js';
-import { registerStyles, ThemableMixin } from '@vaadin/vaadin-themable-mixin/vaadin-themable-mixin.js';
-import { selectOverlayStyles } from './vaadin-select-overlay-core-styles.js';
+import { PolylitMixin } from '@vaadin/component-base/src/polylit-mixin.js';
+import { overlayStyles } from '@vaadin/overlay/src/styles/vaadin-overlay-core-styles.js';
+import { LumoInjectionMixin } from '@vaadin/vaadin-themable-mixin/lumo-injection-mixin.js';
+import { ThemableMixin } from '@vaadin/vaadin-themable-mixin/vaadin-themable-mixin.js';
+import { selectOverlayStyles } from './styles/vaadin-select-overlay-core-styles.js';
 import { SelectOverlayMixin } from './vaadin-select-overlay-mixin.js';
 
-registerStyles('vaadin-select-overlay', [overlayStyles, selectOverlayStyles], {
-  moduleId: 'vaadin-select-overlay-styles',
-});
-
 /**
  * An element used internally by `<vaadin-select>`. Not intended to be used separately.
  *
@@ -23,21 +21,35 @@ registerStyles('vaadin-select-overlay', [overlayStyles, selectOverlayStyles], {
  * @mixes ThemableMixin
  * @private
  */
-export class SelectOverlay extends SelectOverlayMixin(ThemableMixin(PolymerElement)) {
+export class SelectOverlay extends SelectOverlayMixin(ThemableMixin(PolylitMixin(LumoInjectionMixin(LitElement)))) {
   static get is() {
     return 'vaadin-select-overlay';
   }
 
-  static get template() {
+  static get styles() {
+    return [overlayStyles, selectOverlayStyles];
+  }
+
+  /** @protected */
+  render() {
     return html`
-      <div id="backdrop" part="backdrop" hidden$="[[!withBackdrop]]"></div>
-      <div part="overlay" id="overlay" tabindex="0">
+      <div id="backdrop" part="backdrop" ?hidden="${!this.withBackdrop}"></div>
+      <div part="overlay" id="overlay">
         <div part="content" id="content">
           <slot></slot>
         </div>
       </div>
     `;
   }
+
+  /** @protected */
+  updated(props) {
+    super.updated(props);
+
+    if (props.has('renderer')) {
+      this.requestContentUpdate();
+    }
+  }
 }
 
 defineCustomElement(SelectOverlay);