Inline configuration

Configuration can be changed inline using directives (as HTML comments).

<!-- html-validate-ACTION OPTIONS -- COMMENT -->

alternatively:

<!-- [html-validate-ACTION OPTIONS -- COMMENT] -->

ACTION is an action such as enable, disable etc and OPTIONS is arguments to the action. Comment is optional but encouraged.

<!-- [html-validate-ACTION OPTIONS -- COMMENT] -->

Multiple rules can be enabled/disabled at once by using a comma-separated list:

<!-- html-validate-disable-next void-style, deprecated -- disable both rules -->

Comments can be entered using both -- and : as delimiter:

<!-- html-validate-disable-next deprecated -- justification for disabling -->
<blink>Blinking text</blink>
<!-- html-validate-disable-next deprecated: justification for disabling -->
<blink>Blinking text</blink>

enable

<!-- html-validate-enable element-permitted-content -->

Enables a rule. If the severity is set to off it will be raised to error, i.e a previously disabled warning will remain a warning after enabling it again.

disable

<!-- html-validate-disable deprecated -->

Disable a rule for the rest of the file or until re-enabled using enable directive.

disable-block

<!-- html-validate-disable-block attribute-allowed-values -->

Disables a rule for a block of elements. All siblings and descendants following the directive will not trigger any errors.

<div>
  <button type="foo">Invalid button</button>
  <!-- html-validate-disable-block attribute-allowed-values -- will be disabled until the parent div is closed -->
  <button type="bar">Invalid but ignored</button>
  <button type="baz">Still ignored</button>
</div>
<button type="spam">Another invalid</button>

error: Attribute "type" has invalid value "foo" (attribute-allowed-values) at inline:2:17:
  1 | <div>
> 2 |   <button type="foo">Invalid button</button>
    |                 ^^^
  3 |   <!-- html-validate-disable-block attribute-allowed-values -- will be disabled until the parent div is closed -->
  4 |   <button type="bar">Invalid but ignored</button>
  5 |   <button type="baz">Still ignored</button>


error: Attribute "type" has invalid value "spam" (attribute-allowed-values) at inline:7:15:
  5 |   <button type="baz">Still ignored</button>
  6 | </div>
> 7 | <button type="spam">Another invalid</button>
    |               ^^^^


2 errors found.

disable-next

<!-- html-validate-disable-next deprecated -->

Disables the rule for the next element.

<!-- html-validate-disable-next deprecated -- the next occurrence will not trigger an error -->
<blink>This will not trigger an error</blink>
<blink>But this line will</blink>

error: <blink> is deprecated (deprecated) at inline:3:2:
  1 | <!-- html-validate-disable-next deprecated -- the next occurrence will not trigger an error -->
  2 | <blink>This will not trigger an error</blink>
> 3 | <blink>But this line will</blink>
    |  ^^^^^


1 error found.