Grunt task to hint html code.

Downloads in past


0.6.05 years ago9 years agoMinified + gzip package size for grunt-htmlhint-plus in KB


!Build Statusci-imgci-url !Code GPAgpa-imggpa-url !Code stylelint-imglint-url !Dependency Statusdep-imgdep-url !Dev Dependency Statusdev-dep-imgdev-dep-url !NPM versionnpm-ver-imgnpm-url !NPM downloadsnpm-dl-imgnpm-url !NPM licensenpm-lc-imgnpm-url
Grunt task to hint html code.

Getting Started

This plugin requires Grunt >=0.4.0
If you haven't used Grunt before, be sure to check out the Getting Started guide, as it explains how to create a Gruntfile as well as install and use Grunt plugins. Once you're familiar with that process, you may install this plugin with this command:
npm install grunt-htmlhint-plus --save-dev

Or you may like yarn:
yarn add grunt-htmlhint-plus -D

Once the plugin has been installed, it may be enabled inside your Gruntfile with this line of JavaScript:

Htmlhintplus Task

Run this task with the grunt htmlhintplus command.
Task targets, files and options may be specified according to the grunt Configuring tasks guide.


src {String|Array}

Source path. Support file path, glob and globs.

options.rules {Object}

Htmlhint rules. Default is:
  • "tagname-lowercase": true,
  • "attr-lowercase": true,
  • "attr-value-double-quotes": true,
  • "attr-value-not-empty": true,
  • "attr-no-duplication": true,
  • "doctype-first": true,
  • "tag-pair": true,
  • "tag-self-close": false,
  • "spec-char-escape": true,
  • "id-unique": true,
  • "src-not-empty": true,
  • "head-script-disabled": false,
  • "img-alt-require": true,
  • "doctype-html5": true,
  • "id-class-value": "dash",
  • "style-disabled": false,
  • "space-tab-mixed-disabled": true,
  • "id-class-ad-disabled": true,
  • "href-abs-or-rel": true,
  • "attr-unsafe-chars": true

For the whole rules list, please see Rules page.

options.htmlhintrc {String}

Htmlhintrc file path. Has higher priority than rules option.

options.force {Boolean}

Throw fatal fail or not at the end of this task, when there is hint error. Default false.

options.newer {Boolean}

Only hint changed file and new file. Default true.

options.ignore {Object}

Ignore strings between key and value from this object. Default {}.

options.customRules {Array}

An array of paths to custom rule files to load and use in your HTMLHinting. See issue #47 on the HTMLHint project. For examples of how to write a custom rule.

options.extendRules {Boolean}

Extend the default rules instead of only running the rules specified. Default false.

options.output {String|Array}

A string or array of output file types for reporting. Multiple types can also be selected separating them with a pipe character (ex: console|checkstyle|json). Available output types include console, default (alias for console), text, json, and checkstyle. Default console.

Usage Examples


// Project configuration
htmlhintplus: {
	build: {
		options: {
			rules: {
				'tag-pair': true,
				'custom-rule': true
			customRules: [
			extendRules: true,
			output: [ 'console', 'text', 'json', 'checkstyle' ]
		src: 'path/to/file'

Use htmlhintrc file

// Project configuration
htmlhintplus: {
	html: {
		options: {
			htmlhintrc: 'path/to/file'
		src: [

Use global options

// Project configuration
htmlhintplus: {
	options: {
		htmlhintrc: 'path/to/file',
		newer: true
	build: {
		options: {
			force: false
		src: [


Run the test demo:
grunt test