jsx-boolean-value.md 1.7 KB

Enforce boolean attributes notation in JSX (react/jsx-boolean-value)

When using a boolean attribute in JSX, you can set the attribute value to true or omit the value. This rule will enforce one or the other to keep consistency in your code.

Fixable: This rule is automatically fixable using the --fix flag on the command line.

Rule Details

This rule takes two arguments. If the first argument is "always" then it warns whenever an attribute is missing its value. If "never" then it warns if an attribute has a true value. The default value of this option is "never".

The second argument is optional: if provided, it must be an object with a "never" property (if the first argument is "always"), or an "always" property (if the first argument is "never"). This property’s value must be an array of strings representing prop names.

The following patterns are considered warnings when configured "never", or with "always", { "never": ["personal"] }:

var Hello = <Hello personal={true} />;

The following patterns are not considered warnings when configured "never", or with "always", { "never": ["personal"] }:

var Hello = <Hello personal />;

The following patterns are considered warnings when configured "always", or with "never", { "always": ["personal"] }:

var Hello = <Hello personal />;

The following patterns are not considered warnings when configured "always", or with "never", { "always": ["personal"] }:

var Hello = <Hello personal={true} />;

When Not To Use It

If you do not want to enforce any style for boolean attributes, then you can disable this rule.