html-validate 10.3.1 → 10.4.0

package/dist/cjs/core.js

@@ -863,8 +863,15 @@ const definitions = {
 								title: "Set to true if this attribute can optionally omit its value"
 							},
 							required: {
-								type: "boolean",
-								title: "Set to true if this attribute is required"
+								title: "Set to true or a function to evaluate if this attribute is required",
+								oneOf: [
+									{
+										type: "boolean"
+									},
+									{
+										"function": true
+									}
+								]
 							}
 						}
 					},
@@ -6287,10 +6294,30 @@ class ElementRequiredAncestor extends Rule {
   }
 }
 
+const defaultMessage = `{{ tagName }} is missing required "{{ attr }}" attribute`;
+function normalizeRequired(element, attr) {
+  const { required } = attr;
+  if (typeof required === "function") {
+    const result = required(element._adapter);
+    switch (result) {
+      case void 0:
+      case null:
+      case false:
+      case "":
+        return false;
+      case true:
+        return defaultMessage;
+      default:
+        return result;
+    }
+  } else {
+    return required ? defaultMessage : false;
+  }
+}
 class ElementRequiredAttributes extends Rule {
   documentation(context) {
     return {
-      description: `The \`<${context.element}>\` element is required to have a \`${context.attribute}\` attribute.`,
+      description: `The \`${context.tagName}\` element is required to have a \`${context.attr}\` attribute.`,
       url: "https://html-validate.org/rules/element-required-attributes.html"
     };
   }
@@ -6302,23 +6329,29 @@ class ElementRequiredAttributes extends Rule {
         return;
       }
       for (const [key, attr] of Object.entries(meta.attributes)) {
-        if (!attr.required) {
+        const required = normalizeRequired(node, attr);
+        if (!required) {
           continue;
         }
-        if (node.hasAttribute(key)) continue;
-        const context = {
-          element: node.tagName,
-          attribute: key
-        };
-        this.report(
-          node,
-          `${node.annotatedName} is missing required "${key}" attribute`,
-          node.location,
-          context
-        );
+        this.validateRequiredAttribute(node, key, required);
       }
     });
   }
+  validateRequiredAttribute(node, attr, message) {
+    if (node.hasAttribute(attr)) {
+      return;
+    }
+    const context = {
+      tagName: node.annotatedName,
+      attr
+    };
+    this.report({
+      node,
+      message,
+      location: node.location,
+      context
+    });
+  }
 }
 
 function isCategory(value) {
@@ -11945,7 +11978,7 @@ class EventHandler {
 }
 
 const name = "html-validate";
-const version = "10.3.1";
+const version = "10.4.0";
 const bugs = "https://gitlab.com/html-validate/html-validate/issues/new";
 
 function freeze(src) {