EditorConfig properties for HTML: Formatting Style

Tabs and indents

Indent style

Property names:

indent_style, [resharper_]html_indent_style

Possible values:

tab: Tab
space: Spaces

Examples:

tab
<div> <div> text </div> </div>

space
<div> <div> text </div> </div>

Indent size

Property names:

indent_size, [resharper_]html_indent_size

Possible values:

an integer

Examples:

value: 0
<div> <div> text </div> </div>

value: 1
<div> <div> text </div> </div>

value: 2
<div> <div> text </div> </div>

Tab width

Property names:

tab_width, [resharper_]html_tab_width

Possible values:

an integer

Examples:

value: 0
<div> <div> text </div> </div>

value: 1
<div> <div> text </div> </div>

value: 2
<div> <div> text </div> </div>

How to align when tabs are used for indents

Property names:

[resharper_]html_alignment_tab_fill_style, [resharper_]alignment_tab_fill_style

Possible values:

use_spaces: Use spaces (looks aligned on any tab size)
use_tabs_only: Only use tabs (inaccurate)
optimal_fill: Mix tabs and spaces for optimal fill

Align even if the resulting indentation is too large

Property names:

[resharper_]html_allow_far_alignment, [resharper_]allow_far_alignment

Allow alignment even if construct is located too far to the right, more than 2/3 of `Hard wrap at` limit

Possible values:

true | false

Processing instructions

Spaces around '=' in attribute

Property names:

[resharper_]html_spaces_around_eq_in_pi_attribute, [resharper_]spaces_around_eq_in_pi_attribute

Possible values:

true | false

Examples:

true
<?xml version = '1.0' encoding = 'utf-8'?>

false
<?xml version='1.0' encoding='utf-8'?>

Space after last attribute

Property names:

[resharper_]html_space_after_last_pi_attribute, [resharper_]space_after_last_pi_attribute

Possible values:

true | false

Examples:

true
<?xml version='1.0' encoding='utf-8' ?>

false
<?xml version='1.0' encoding='utf-8'?>

Attributes format

Property names:

[resharper_]html_pi_attribute_style, [resharper_]pi_attribute_style

Possible values:

on_single_line: On single line
first_attribute_on_single_line: First attribute on single line
on_different_lines: Each attribute on separate lines
do_not_touch: Do not touch

Examples:

on_single_line
<?xml version='1.0' encoding='utf-8'?>

first_attribute_on_single_line
<?xml version='1.0' encoding='utf-8'?>

on_different_lines
<?xml version='1.0' encoding='utf-8'?>

do_not_touch
<?xml version='1.0' encoding='utf-8'?>

Attributes indenting

Property names:

[resharper_]html_pi_attributes_indent, [resharper_]pi_attributes_indent

Possible values:

single_indent: Single indent
double_indent: Double indent
align_by_first_attribute: Align by first attribute

Examples:

single_indent
<?xml version='1.0' encoding='utf-8'?>

double_indent
<?xml version='1.0' encoding='utf-8'?>

align_by_first_attribute
<?xml version='1.0' encoding='utf-8'?>

Blank line after processing instructions

Property names:

[resharper_]html_blank_line_after_pi, [resharper_]blank_line_after_pi

Possible values:

true | false

Examples:

true
<?xml version='1.0' encoding='utf-8'?> <a/>

false
<?xml version='1.0' encoding='utf-8'?> <a/>

Inside of tag header

Spaces around '=' in attribute

Property names:

[resharper_]html_spaces_around_eq_in_attribute, [resharper_]spaces_around_eq_in_attribute

Possible values:

true | false

Examples:

true
<a x = '1' y = '2' z = '3'/>

false
<a x='1' y='2' z='3'/>

Space after last attribute

Property names:

[resharper_]html_space_after_last_attribute, [resharper_]space_after_last_attribute

Possible values:

true | false

Examples:

true
<a x='1' y='2' z='3' >text</a>

false
<a x='1' y='2' z='3'>text</a>

Space before '/>'

Property names:

[resharper_]html_space_before_self_closing, [resharper_]space_before_self_closing

Possible values:

true | false

Examples:

true
<a />

false
<a/>

Attributes format

Property names:

[resharper_]html_attribute_style, [resharper_]attribute_style

Possible values:

on_single_line: On single line
first_attribute_on_single_line: First attribute on single line
on_different_lines: Each attribute on separate lines
do_not_touch: Do not touch

Examples:

on_single_line
<a x='1' y='2' z='3'/>

first_attribute_on_single_line
<a x='1' y='2' z='3'/>

on_different_lines
<a x='1' y='2' z='3'/>

do_not_touch
<a x='1' y='2' z='3'/>

Attributes indenting

Property names:

[resharper_]html_attribute_indent, [resharper_]attribute_indent

Possible values:

single_indent: Single indent
double_indent: Double indent
align_by_first_attribute: Align by first attribute

Examples:

single_indent
<div class='a' style='color:red' data-attr='3'/>

double_indent
<div class='a' style='color:red' data-attr='3'/>

align_by_first_attribute
<div class='a' style='color:red' data-attr='3'/>

Sort attributes

Property names:

[resharper_]html_sort_attributes, [resharper_]sort_attributes

Possible values:

true | false

Examples:

true
<div class='a' data-attr='3' style='color:red'/>

false
<div data-attr='3' style='color:red' class='a'/>

Sort class selectors

Property names:

[resharper_]html_sort_class_selectors, [resharper_]sort_class_selectors

Possible values:

true | false

Examples:

true
<div class="a b c"/>

false
<div class="b c a"/>

Around tags

Maximum blank lines between tags

Property names:

[resharper_]html_max_blank_lines_between_tags, [resharper_]max_blank_lines_between_tags

Possible values:

an integer

Examples:

value: 0
<br/> <br/>

value: 1
<br/> <br/>

value: 2
<br/> <br/>

Place all elements on a new line

Property names:

[resharper_]html_linebreak_before_all_elements, [resharper_]linebreak_before_all_elements

Possible values:

true | false

Examples:

true
Hi! <br/> <i>some text</i> <b>some text</b>

false
Hi! <br/><i>some text</i><b>some text</b>

Place multiline elements on a new line

Property names:

[resharper_]html_linebreak_before_multiline_elements, [resharper_]linebreak_before_multiline_elements

Possible values:

true | false

Examples:

true
Hi! <br/><i>some text</i> <b> more text </b> <img data-attr='3' class='a'/>

false
Hi! <br/><i>some text</i><b> more text </b><img data-attr='3' class='a'/>

Place the following elements on a new line

Property names:

[resharper_]html_linebreak_before_elements, [resharper_]linebreak_before_elements

Do not indent children of

Property names:

[resharper_]html_no_indent_inside_elements, [resharper_]no_indent_inside_elements

Do not indent children if element has more lines than

Property names:

[resharper_]html_no_indent_inside_if_element_longer_than, [resharper_]no_indent_inside_if_element_longer_than

Possible values:

an integer

Keep white spaces inside

Property names:

[resharper_]html_preserve_spaces_inside_tags, [resharper_]preserve_spaces_inside_tags

Line breaks after start-tag and before end-tag in multiline elements

Property names:

[resharper_]html_linebreaks_inside_tags_for_multiline_elements, [resharper_]linebreaks_inside_tags_for_multiline_elements

Possible values:

true | false

Examples:

true
<tag> text text text Text text text text text text text text text </tag>

false
<tag>text text text Text text text text text text text text text</tag>

Line breaks after start-tag and before end-tag in elements that contain other elements and no text

Property names:

[resharper_]html_linebreaks_inside_tags_for_elements_with_child_elements, [resharper_]linebreaks_inside_tags_for_elements_with_child_elements

Possible values:

true | false

Examples:

true
<tag> <othertag>text</othertag> </tag>

false
<tag><othertag>text</othertag></tag>

Other

Line feed at end of file

Property names:

insert_final_newline, [resharper_]html_insert_final_newline

Possible values:

true | false

Extra spaces inside

Property names:

[resharper_]html_extra_spaces, [resharper_]extra_spaces

Possible values:

remove_all: Remove all extra spaces
leave_tabs: Leave extra tabs
leave_multiple: Leave multiple extra spaces
leave_all: Leave all extra spaces and tabs

Examples:

Before formatting	After formatting, remove_all
<p id = "II" > I </p> <em dir = "rtl" > He </em> <div class = "first" > You </div> <p id = "II" > I </p> <em dir = "rtl" > He </em> <div class = "first" > You </div>	<p id="II"> I </p> <em dir="rtl"> He </em> <div class="first"> You </div> <p id="II"> I </p> <em dir="rtl"> He </em> <div class="first"> You </div>

Before formatting	After formatting, leave_tabs
<p id = "II" > I </p> <em dir = "rtl" > He </em> <div class = "first" > You </div> <p id = "II" > I </p> <em dir = "rtl" > He </em> <div class = "first" > You </div>	<p id="II"> I </p> <em dir="rtl"> He </em> <div class="first"> You </div> <p id = "II" > I </p> <em dir = "rtl" > He </em> <div class = "first" > You </div>

Before formatting	After formatting, leave_multiple
<p id = "II" > I </p> <em dir = "rtl" > He </em> <div class = "first" > You </div> <p id = "II" > I </p> <em dir = "rtl" > He </em> <div class = "first" > You </div>	<p id ="II" > I </p> <em dir ="rtl" > He </em> <div class="first"> You </div> <p id="II"> I </p> <em dir="rtl"> He </em> <div class="first"> You </div>

Before formatting	After formatting, leave_all
<p id = "II" > I </p> <em dir = "rtl" > He </em> <div class = "first" > You </div> <p id = "II" > I </p> <em dir = "rtl" > He </em> <div class = "first" > You </div>	<p id = "II" > I </p> <em dir = "rtl" > He </em> <div class = "first" > You </div> <p id = "II" > I </p> <em dir = "rtl" > He </em> <div class = "first" > You </div>

Last modified: 27 March 2023