npm - html-validate - Versions diffs - 6.2.0 → 6.3.0 - Mend

html-validate 6.2.0 → 6.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (8) hide show

package/dist/es/core.d.ts CHANGED Viewed

@@ -1575,7 +1575,8 @@ declare class MetaTable {
      */
     loadFromFile(filename: string): void;
     /**
-     * Get [[MetaElement]] for the given tag or null if the element doesn't exist.
+     * Get [[MetaElement]] for the given tag. If no specific metadata is present
+     * the global metadata is returned or null if no global is present.
      *
      * @public
      * @returns A shallow copy of metadata.

package/dist/es/core.js CHANGED Viewed

@@ -933,14 +933,23 @@ class MetaTable {
         }
     }
     /**
-     * Get [[MetaElement]] for the given tag or null if the element doesn't exist.
+     * Get [[MetaElement]] for the given tag. If no specific metadata is present
+     * the global metadata is returned or null if no global is present.
      *
      * @public
      * @returns A shallow copy of metadata.
      */
     getMetaFor(tagName) {
+        /* try to locate by tagname */
         tagName = tagName.toLowerCase();
-        return this.elements[tagName] ? { ...this.elements[tagName] } : null;
+        if (this.elements[tagName]) {
+            return { ...this.elements[tagName] };
+        }
+        /* try to locate global element */
+        if (this.elements["*"]) {
+            return { ...this.elements["*"] };
+        }
+        return null;
     }
     /**
      * Find all tags which has enabled given property.
@@ -2936,7 +2945,7 @@ var TRANSFORMER_API;
 /** @public */
 const name = "html-validate";
 /** @public */
-const version = "6.2.0";
+const version = "6.3.0";
 /** @public */
 const homepage = "https://html-validate.org";
 /** @public */
@@ -3406,6 +3415,28 @@ class AllowedLinks extends Rule {
     }
 }
+class AriaHiddenBody extends Rule {
+    documentation() {
+        return {
+            description: "`aria-hidden` must not be used on the `<body>` element as it makes the page inaccessible to assistive technology such as screenreaders",
+            url: ruleDocumentationUrl("@/rules/aria-hidden-body.ts"),
+        };
+    }
+    setup() {
+        this.on("tag:ready", this.isRelevant, (event) => {
+            const { target } = event;
+            const attr = target.getAttribute("aria-hidden");
+            if (!attr || !attr.valueMatches("true", true)) {
+                return;
+            }
+            this.report(target, "aria-hidden must not be used on <body>", attr.keyLocation);
+        });
+    }
+    isRelevant(event) {
+        return event.target.is("body");
+    }
+}
 const whitelisted = [
     "main",
     "nav",
@@ -5033,8 +5064,9 @@ class ElementRequiredAttributes extends Rule {
 class ElementRequiredContent extends Rule {
     documentation(context) {
         if (context) {
+            const { element, missing } = context;
             return {
-                description: `The <${context.node} element requires a <${context.missing}> to be present as content.`,
+                description: `The \`${element}\` element requires a \`${missing}\` to be present as content.`,
                 url: ruleDocumentationUrl("@/rules/element-required-content.ts"),
             };
         }
@@ -5060,10 +5092,11 @@ class ElementRequiredContent extends Rule {
                 }
                 for (const missing of Validator.validateRequiredContent(node, rules)) {
                     const context = {
-                        node: node.tagName,
-                        missing,
+                        element: node.annotatedName,
+                        missing: `<${missing}>`,
                     };
-                    this.report(node, `${node.annotatedName} element must have <${missing}> as content`, null, context);
+                    const message = `${node.annotatedName} element must have <${missing}> as content`;
+                    this.report(node, message, null, context);
                 }
             });
         });
@@ -5146,7 +5179,14 @@ class EmptyHeading extends Rule {
 class EmptyTitle extends Rule {
     documentation() {
         return {
-            description: `The <title> element is used to describe the document and is shown in the browser tab and titlebar. WCAG and SEO requires a descriptive title and preferably unique within the site. Whitespace only is considered empty.`,
+            description: [
+                "The `<title>` element cannot be empty, it must have textual content.",
+                "",
+                "It is used to describe the document and is shown in the browser tab and titlebar.",
+                "WCAG and SEO requires a descriptive title and preferably unique within the site.",
+                "",
+                "Whitespace is ignored.",
+            ].join("\n"),
             url: ruleDocumentationUrl("@/rules/empty-title.ts"),
         };
     }
@@ -5162,7 +5202,10 @@ class EmptyTitle extends Rule {
                     break;
                 case TextClassification.EMPTY_TEXT:
                     /* no content or whitespace only */
-                    this.report(node, `<${node.tagName}> cannot be empty, must have text content`);
+                    {
+                        const message = `<${node.tagName}> cannot be empty, must have text content`;
+                        this.report(node, message, node.location);
+                    }
                     break;
             }
         });
@@ -9440,6 +9483,7 @@ const bundledRules$1 = {
 const bundledRules = {
     "allowed-links": AllowedLinks,
+    "aria-hidden-body": AriaHiddenBody,
     "aria-label-misuse": AriaLabelMisuse,
     "attr-case": AttrCase,
     "attr-delimiter": AttrDelimiter,
@@ -9510,6 +9554,7 @@ var defaultConfig = {};
 const config$3 = {
     rules: {
+        "aria-hidden-body": "error",
         "aria-label-misuse": "error",
         "deprecated-rule": "warn",
         "empty-heading": "error",
@@ -9544,6 +9589,7 @@ const config$2 = {
 const config$1 = {
     rules: {
+        "aria-hidden-body": "error",
         "aria-label-misuse": "error",
         "attr-case": "error",
         "attr-delimiter": "error",