@siteimprove/alfa-dom 0.109.0 → 0.110.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @siteimprove/alfa-dom
 
+## 0.110.0
+
+### Patch Changes
+
+- **Added:** The `inert` attribute is now supported. ([#1964](https://github.com/Siteimprove/alfa/pull/1964))
+
 ## 0.109.0
 
 ### Patch Changes

package/dist/node/element/predicate/is-suggested-focusable.js

@@ -11,6 +11,9 @@ import { Element } from "../../element.js";
  * @public
  */
 export function isSuggestedFocusable(element) {
+    if (element.isInert()) {
+        return false;
+    }
     switch (element.name) {
         case "a":
         case "link":

package/dist/node/element.d.ts

@@ -60,9 +60,20 @@ export declare class Element<N extends string = string> extends Node<"element">
      * {@link https://html.spec.whatwg.org/#dom-tabindex}
      */
     tabIndex(): Option<number>;
+    /**
+     * Computes inertness of an element based on the `inert` attribute.
+     *
+     * {@link https://html.spec.whatwg.org/#the-inert-attribute}
+     *
+     * @privateRemarks
+     * According to {@link https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Global_attributes/inert}
+     * only open dialogs can escape inertness (except when they have the `inert` attribute).
+     */
+    isInert(): boolean;
     protected _inputType: helpers.InputType | undefined;
     protected _displaySize: number | undefined;
     protected _optionsList: Sequence<Element<"option">> | undefined;
+    private _isInert;
     /**
      * {@link https://dom.spec.whatwg.org/#dom-slotable-assignedslot}
      */

package/dist/node/element.js

@@ -17,7 +17,7 @@ import { Slot } from "./slot.js";
 import { Slotable } from "./slotable.js";
 import * as predicate from "./element/predicate.js";
 const { isEmpty } = Iterable;
-const { not } = Predicate;
+const { and, not, or, test } = Predicate;
 /**
  * @public
  */
@@ -171,6 +171,30 @@ export class Element extends Node {
         }
         return None;
     }
+    /**
+     * Computes inertness of an element based on the `inert` attribute.
+     *
+     * {@link https://html.spec.whatwg.org/#the-inert-attribute}
+     *
+     * @privateRemarks
+     * According to {@link https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Global_attributes/inert}
+     * only open dialogs can escape inertness (except when they have the `inert` attribute).
+     */
+    isInert() {
+        if (this._isInert === undefined) {
+            this._isInert = test(or(
+            // Explicitly inert;
+            Element.hasAttribute("inert"), and(
+            // or not an open dialog,
+            not(and(Element.hasName("dialog"), Element.hasAttribute("open"))), 
+            // and with an inert ancestor.
+            (element) => element
+                .parent(Node.flatTree)
+                .filter(Element.isElement)
+                .some((parent) => parent.isInert()))), this);
+        }
+        return this._isInert;
+    }
     /*
      * This collects caches for methods that are specific to some kind of elements.
      * The actual methods are declared in element/augment.ts to de-clutter this
@@ -181,6 +205,7 @@ export class Element extends Node {
     _inputType;
     _displaySize;
     _optionsList;
+    _isInert;
     /*
      * End of caches for methods specific to some kind of elements.
      */

package/package.json

@@ -2,7 +2,7 @@
   "$schema": "http://json.schemastore.org/package",
   "name": "@siteimprove/alfa-dom",
   "homepage": "https://alfa.siteimprove.com",
-  "version": "0.109.0",
+  "version": "0.110.0",
   "license": "MIT",
   "description": "Implementations of the core DOM and CSSOM node types",
   "repository": {
@@ -35,35 +35,35 @@
     "dist/**/*.d.ts"
   ],
   "dependencies": {
-    "@siteimprove/alfa-array": "^0.109.0",
-    "@siteimprove/alfa-cache": "^0.109.0",
-    "@siteimprove/alfa-comparable": "^0.109.0",
-    "@siteimprove/alfa-css": "^0.109.0",
-    "@siteimprove/alfa-css-feature": "^0.109.0",
-    "@siteimprove/alfa-device": "^0.109.0",
-    "@siteimprove/alfa-earl": "^0.109.0",
-    "@siteimprove/alfa-equatable": "^0.109.0",
-    "@siteimprove/alfa-flags": "^0.109.0",
-    "@siteimprove/alfa-iterable": "^0.109.0",
-    "@siteimprove/alfa-json": "^0.109.0",
-    "@siteimprove/alfa-lazy": "^0.109.0",
-    "@siteimprove/alfa-map": "^0.109.0",
-    "@siteimprove/alfa-option": "^0.109.0",
-    "@siteimprove/alfa-parser": "^0.109.0",
-    "@siteimprove/alfa-predicate": "^0.109.0",
-    "@siteimprove/alfa-rectangle": "^0.109.0",
-    "@siteimprove/alfa-refinement": "^0.109.0",
-    "@siteimprove/alfa-result": "^0.109.0",
-    "@siteimprove/alfa-sarif": "^0.109.0",
-    "@siteimprove/alfa-selective": "^0.109.0",
-    "@siteimprove/alfa-sequence": "^0.109.0",
-    "@siteimprove/alfa-slice": "^0.109.0",
-    "@siteimprove/alfa-string": "^0.109.0",
-    "@siteimprove/alfa-trampoline": "^0.109.0",
-    "@siteimprove/alfa-tree": "^0.109.0"
+    "@siteimprove/alfa-array": "^0.110.0",
+    "@siteimprove/alfa-cache": "^0.110.0",
+    "@siteimprove/alfa-comparable": "^0.110.0",
+    "@siteimprove/alfa-css": "^0.110.0",
+    "@siteimprove/alfa-css-feature": "^0.110.0",
+    "@siteimprove/alfa-device": "^0.110.0",
+    "@siteimprove/alfa-earl": "^0.110.0",
+    "@siteimprove/alfa-equatable": "^0.110.0",
+    "@siteimprove/alfa-flags": "^0.110.0",
+    "@siteimprove/alfa-iterable": "^0.110.0",
+    "@siteimprove/alfa-json": "^0.110.0",
+    "@siteimprove/alfa-lazy": "^0.110.0",
+    "@siteimprove/alfa-map": "^0.110.0",
+    "@siteimprove/alfa-option": "^0.110.0",
+    "@siteimprove/alfa-parser": "^0.110.0",
+    "@siteimprove/alfa-predicate": "^0.110.0",
+    "@siteimprove/alfa-rectangle": "^0.110.0",
+    "@siteimprove/alfa-refinement": "^0.110.0",
+    "@siteimprove/alfa-result": "^0.110.0",
+    "@siteimprove/alfa-sarif": "^0.110.0",
+    "@siteimprove/alfa-selective": "^0.110.0",
+    "@siteimprove/alfa-sequence": "^0.110.0",
+    "@siteimprove/alfa-slice": "^0.110.0",
+    "@siteimprove/alfa-string": "^0.110.0",
+    "@siteimprove/alfa-trampoline": "^0.110.0",
+    "@siteimprove/alfa-tree": "^0.110.0"
   },
   "devDependencies": {
-    "@siteimprove/alfa-test": "^0.109.0",
+    "@siteimprove/alfa-test": "^0.110.0",
     "@types/jsdom": "^27.0.0",
     "jsdom": "^27.4.0"
   },