@vaadin/a11y-base 25.3.0-alpha3 → 25.3.0-alpha5

package/index.d.ts

@@ -5,7 +5,7 @@ export { DisabledMixin } from './src/disabled-mixin.js';
 export { FieldAriaController } from './src/field-aria-controller.js';
 export { FocusMixin } from './src/focus-mixin.js';
 export {
-  getFocusableElements,
+  getTabbableElements,
   isElementFocusable,
   isElementFocused,
   isElementHidden,

package/index.js

@@ -7,7 +7,7 @@ export { FocusMixin } from './src/focus-mixin.js';
 export { FocusTrapController } from './src/focus-trap-controller.js';
 export { FocusRestorationController } from './src/focus-restoration-controller.js';
 export {
-  getFocusableElements,
+  getTabbableElements,
   isElementFocusable,
   isElementFocused,
   isElementHidden,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vaadin/a11y-base",
-  "version": "25.3.0-alpha3",
+  "version": "25.3.0-alpha5",
   "publishConfig": {
     "access": "public"
   },
@@ -32,15 +32,15 @@
   ],
   "dependencies": {
     "@open-wc/dedupe-mixin": "^1.3.0",
-    "@vaadin/component-base": "25.3.0-alpha3",
+    "@vaadin/component-base": "25.3.0-alpha5",
     "lit": "^3.0.0"
   },
   "devDependencies": {
-    "@vaadin/chai-plugins": "25.3.0-alpha3",
-    "@vaadin/test-runner-commands": "25.3.0-alpha3",
+    "@vaadin/chai-plugins": "25.3.0-alpha5",
+    "@vaadin/test-runner-commands": "25.3.0-alpha5",
     "@vaadin/testing-helpers": "^2.0.0",
     "sinon": "^22.0.0"
   },
   "customElements": "custom-elements.json",
-  "gitHead": "ba0c4c55ea219eadd9aefe244f53e87803a066c8"
+  "gitHead": "0be2142cd8b95a562d58735033f947f7109103ab"
 }

package/src/focus-trap-controller.js

@@ -3,7 +3,7 @@
  * Copyright (c) 2021 - 2026 Vaadin Ltd.
  * This program is available under Apache License Version 2.0, available at https://vaadin.com/license/
  */
-import { getFocusableElements, isElementFocused, isKeyboardActive } from './focus-utils.js';
+import { getTabbableElements, isElementFocused, isKeyboardActive } from './focus-utils.js';
 
 const instances = [];
 
@@ -57,7 +57,7 @@ export class FocusTrapController {
    * @private
    */
   get __focusableElements() {
-    return getFocusableElements(this.__trapNode);
+    return getTabbableElements(this.__trapNode);
   }
 
   /**

package/src/focus-utils.d.ts

@@ -26,7 +26,8 @@ export declare function isKeyboardActive(): boolean;
 export declare function isElementHidden(element: HTMLElement): boolean;
 
 /**
- * Returns true if the element is focusable, otherwise false.
+ * Returns true if the element is focusable, i.e. can be focused with a
+ * mouse click or a `focus()` call, otherwise false.
  *
  * The list of focusable elements is taken from http://stackoverflow.com/a/1600194/4228703.
  * However, there isn't a definite list, it's up to the browser.
@@ -54,4 +55,4 @@ export declare function isElementFocused(element: HTMLElement): boolean;
  *
  * The method traverses nodes in shadow DOM trees too if any.
  */
-export declare function getFocusableElements(element: HTMLElement): HTMLElement[];
+export declare function getTabbableElements(element: HTMLElement): HTMLElement[];

package/src/focus-utils.js

@@ -165,7 +165,8 @@ export function isElementHidden(element) {
 }
 
 /**
- * Returns true if the element is focusable, otherwise false.
+ * Returns true if the element is focusable, i.e. can be focused with a
+ * mouse click or a `focus()` call, otherwise false.
  *
  * The list of focusable elements is taken from http://stackoverflow.com/a/1600194/4228703.
  * However, there isn't a definite list, it's up to the browser.
@@ -184,11 +185,6 @@ export function isElementHidden(element) {
  * @return {boolean}
  */
 export function isElementFocusable(element) {
-  // The element cannot be focused if its `tabindex` attribute is set to `-1`.
-  if (element.matches('[tabindex="-1"]')) {
-    return false;
-  }
-
   // Elements that cannot be focused if they have a `disabled` attribute.
   if (element.matches('input, select, textarea, button, object')) {
     return element.matches(':not([disabled])');
@@ -271,7 +267,7 @@ function collectFocusableNodes(node, result) {
  * @param {HTMLElement} element
  * @return {HTMLElement[]}
  */
-export function getFocusableElements(element) {
+export function getTabbableElements(element) {
   const focusableElements = [];
   const needsSortByTabIndex = collectFocusableNodes(element, focusableElements);
   // If there is at least one element with tabindex > 0,

package/src/list-mixin.d.ts

@@ -35,6 +35,11 @@ export declare class ListMixinClass {
    */
   orientation: 'horizontal' | 'vertical';
 
+  /**
+   * Used for mixin detection because `instanceof` does not work with mixins.
+   */
+  protected _hasVaadinListMixin: boolean;
+
   /**
    * A read-only list of items from which a selection can be made.
    * It is populated from the elements passed to the light DOM,

package/src/list-mixin.js

@@ -77,6 +77,16 @@ export const ListMixin = (superClass) =>
       return ['_enhanceItems(items, orientation, selected, disabled)'];
     }
 
+    constructor() {
+      super();
+
+      /**
+       * Used for mixin detection because `instanceof` does not work with mixins.
+       * @protected
+       */
+      this._hasVaadinListMixin = true;
+    }
+
     /**
      * @return {boolean}
      * @protected