htmlhint-loader-ng2

htmlhint-loader-ng2

A webpack loader for htmlhint-ng2, based off htmlhint-loader.

Install

npm install htmlhint-loader-ng2

Usage

module.exports = {
  module: {
    preLoaders: [
      {
        test: /\.html/, 
        loader: 'htmlhint-ng2', 
        exclude: /node_modules/
      }
    ]
  }
}

Options

You can directly pass some htmlhint rules by

• Adding a query string to the loader for this loader usage only

{
  module: {
    preLoaders: [
      {
        test: /\.html/,
        loader: 'htmlhint-ng2?{tagname-lowercase: true}',
        exclude: /node_modules/
      },
    ]
  }
}

• Adding a htmlhint entry in your webpack config for global options:

module.exports = {
  htmlhint: {
    configFile: 'path/.htmlhintrc'
  }
}

configFile

A path to a json file containing the set of htmlhint rules you would like applied to this project. By default all rules are turned off and it is up to you to enable them.

Example file:

{
  "tagname-lowercase": true,
  "attr-lowercase": true,
  "attr-value-double-quotes": true
}

formatter (default: a function that pretty prints any warnings and errors)

The function is called with an array of messages direct for htmlhint and must return a string.

emitAs (default: null)

What to emit errors and warnings as. Set to warning to always emit errors as warnings and error to always emit warnings as errors. By default the plugin will auto detect whether to emit as a warning or an error.

failOnError (default false)

Whether to force webpack to fail the build on a htmlhint error

failOnWarning (default false)

Whether to force webpack to fail the build on a htmlhint warning

customRules

Any custom rules you would like added to htmlhint. Specify as an array like so:

module.exports = {
  htmlhint-ng2: {
    customRules: [{
      id: 'my-rule-name',
      description: 'Example description',
      init: function(parser, reporter) {
        //see htmlhint docs / source for what to put here
      }
    }]
  }
}

Credits

I based a lot of this code off the eslint-loader and the gulp htmlhint plugin, so a big thanks is due to the authors of those modules.

Licence

MIT