Tabs and Indents

If this check box is selected, tab characters are used for indentation and for code reformatting.

When the check box is cleared, WebStorm uses spaces instead of tabs.

Smart tabs

An indentation consists of two parts. One part results from nesting code blocks and the other part is determined by alignment.

If this check box is selected, the part that results from nesting contains both tabs and spaces (if necessary), while the part defined by alignment consists only of spaces.

If this check box is cleared, only tabs are used. This means that after reformatting a group of spaces that fits the specified tab size is automatically replaced with a tab, which may result in breaking fine alignment.

Tab size

In this text box, specify the number of spaces that fits in a tab.

Indent

In this text box, specify the number of spaces (or tabs if the Use Tab Character check box is selected) to be inserted for each indent level.

Continuation indent

In this text box, specify the number of spaces (or tabs if the Use Tab Character check box is selected) to be inserted between the elements of an array, in expressions, method declarations, and method calls.

Keep indents on empty lines

If this check box is selected, WebStorm retains indents on empty lines as if they contained some code. If the check box is cleared, WebStorm deletes the tab characters and spaces on empty lines.

Indent chained methods

In declarations of functions, the second and further methods in a chain are displayed on a separate line.

When the check box is selected, the second and further methods in a chain are aligned with the first call.

When the check box is cleared, the second and further methods in a chain are aligned with the object on which they are invoked.

Indent all chained calls in a group

The check box is available only when the Indent chained methods check box is selected.

The Smart Tabs check box is available if the Use Tab Character check box is selected.

Spaces

Use this tab to specify where you want WebStorm to insert spaces automatically. Select the check boxes next to the decription of relevant locations and check the results in the Preview pane.

Wrapping and braces

In this tab, customize the exceptions, brace placement and alignment options that WebStorm will apply to various code constructs on reformatting the source code. Check the results in the Preview pane.

Alignment takes precedence over indentation options.

Right Margin (columns) In this field, specify the number of spaces required to the right of an element. If you accept the Default option then the value from the global settings is used.

Wrap on typing In this field, specify how the edited text is fitted in the specified Right margin.

Default - choose this option to use the Wrap on typing value from the global settings.

Yes - choose this option to use the value from the Right Margin field.

No - if you choose this option a line can exceed the value specified in the right margin.

Keep when reformatting Use the check boxes to configure exceptions that WebStorm will make when reformatting the source code. For example, by default, the Line breaks check box is selected. If your code contains lines that are shorter than a standard convention, you can convert them by disabling the Line breaks check box before reformatting.

Use this drop-down list to specify the position of the opening brace in class declarations, method declarations, function declarations, and other types of declarations. The available options are:

End of line - select this option to place the opening brace at the declaration line end.

Next line if wrapped - select this option to place the opening brace at the beginning of the line after the multiline declaration line.

Next line - select this option to place the opening brace at the beginning of the line after the declaration line.

Next line shifted - select this option to place the opening brace at the line after the declaration line being shifted to the corresponding indent level.

Next line each shifted - select this option to place the opening brace at the line after the declaration line being shifted to the corresponding indent level, and shift the next line to the next indent level as well.

Force braces

From this drop-down list, choose the braces introduction method for if, for, while, and do () while statements. The available options are:

Do not force - select this option to suppress introducing braces automatically.

When multiline - select this option to insert braces automatically if a statement occupies more than one line. Note that WebStorm analyzes the number of lines in the entire statement but not only its condition.

Blank Lines

Use this tab to define where and how many blank lines you want WebStorm to retain and insert in your code after reformatting. The results are displayed in the Preview pane.

Keep Maximum Blank Lines

In this area, specify the number of extra blank lines to be kept after reformatting.

Minimum Blank Lines

In this area, configure whether to have or not to have extra empty lines after the blocks of import statements and around classes, fields, methods, or functions. In the text box next to each option, specify the minimum number of extra blank lines to be left.

These settings do not affect the number of blank lines before the first and after the last item.

Punctuation

Use the drop-down lists in this tab to form directives in automatic insertion of terminating semicolons, single and double quotes, and trailing commas.

Semicolon to terminate statements

Use semicolon to terminate statements in new code

Use semicolon to terminate statements always

Don't use semicolon to terminate statements in new code

Don't use semicolon to terminate statements always

Quotes

Use double quotes in new code

Use double quotes always

Use single quotes in new code

Use single quotes always

Trailing comma

Use this drop-down list to configure whether you want to use trailing commas in objects, arrays, and for the parameters in method definitions and calls. The available options are:

Keep

Remove

Add when multiline

Code Generation

On this tab, configure the code style for generated code.

Use 'public' modifier

Use this check box to have the public access modifier inserted or omitted in the generated code. For example, during generation of a public method from the following:

classTest{publictest():void{varx=1;}}

If the check box is selected, the public access modifier is automatically inserted in the generated code:

In this area, configure or accept default prefixes that will be added automatically to the names of generated fields and properties.

Comment Code

In this area, configure code style for generated comments.

Line comment at first column - select this check box to start line comments at the first column. When the check box is cleared, line comments are aligned in the code.

Add a space at comment start - when this check box is selected, a space will be inserted between a line comment character and the first character of a commented line.

The Add a space at comment start check box is unavailable when Line comment at first column is selected.

Imports

Merge imports for members from the same module

When this check box is selected, imported symbols from the same module are listed in one import statement with a comma as separator. The members are listed in the order in which they are imported. To arrange them alphabetically, select the Sort imported members check box and run Code | Optimize Imports.

When this check box is cleared, for each imported symbol a separate import statement is generated.

Use paths relative to tsconfig.json

When this check box is selected, WebStorm calculates import paths using the tsconfig.json file as the root. When this check box is cleared, WebStorm calculates import paths relative to the project root.

For example, if your project is structured as follows:

With the check box selected, WebStorm generates the following import statement:

import{ClassName}from'directory_2/file_2'

If the check box is cleared, the following import statement is generated:

In this field, specify the exact paths that WebStorm should skip during automatic import of a symbol. Instead, WebStorm will look for alternative paths to import the symbol.

This is particularly useful for modules that allow importing their submodules instead of the entire module. For example, to prefer imports like import {Observable} from 'rxjs/Observable' to a more general import {Observable} from 'rxjs', add rxjs to the list.

To manage the list of modules to skip:

Click to the right of the field.

In the Change modules dialog box that opens, click and specify the module name in the Add module dialog box. To remove a module from the list, select it and click .

Sort imported members

When this check box is selected, WebStorm lists the imported members in merged import statements alphabetically. Note that the members are listed comma-separated in the order they are imported and re-sorted only when you run Code | Optimize Imports.

When this check box is cleared, the members in merged import statements are always listed comma-separated in the order they are imported.

Sort imports by modules

When this check box is selected, import statements are re-sorted alphabetically by the module names when you run Code | Optimize Imports.

When this check box is cleared, import statements are always shown in the order they are generated and this order is not changed after you run Code | Optimize Imports.

Arrangement

In this tab, define a set of rules to rearrange your TypeScript code according to your preferences.

Grouping Rules

Use this area to set the grouping rules.

Group property field with corresponding getter/setter

Matching rules

Use this area to define elements order as a list of rules, where every rule has a set of matches such as modifier or type.

- use this button to add a rule. The empty rule area opens.

- use this button to remove the rule from the list.

- use this button to edit an existing rule. To see this button, navigate to the rule that you want to edit and click on the button. In pop-up window that opens, modify the rule fields.

- use these buttons to move the selected rule up or down.

Empty rule

Use this area to create a new matching rule or edit an existing one. You can select from the following filters:

Type - use this filter to choose constructors, methods, fields, or properties for your rule. Note that clicking a type keyword twice negates the condition.

Modifier - use this filter to select the types of modifiers for the rule. Note that clicking a modifier keyword twice negates the condition.

Name - use this field to specify entry names in the rule. This filter matches only entry names, such as field names, method names, class names, etc. The filter supports regular expressions and uses a standard syntax. The match is performed against the entire name.

Order - use this drop-down list to select the sorting order for the rule. This option is useful when more than one element uses the same matching rule. In this case, selecting Keep order will keep the same order as was set before the rearrangement and selecting Order by Name will sort the elements with the same matching rule by their names.

This icon appears when you select Order by Name from the Order list. The icon indicates that the items in this rule are sorted alphabetically.

Set from

The link appears in the upper-right corner of the page, when applicable. Click this link and choose the language to be used as the base for the current language code style. To return to the initial set of code style settings and discard the changes, click Reset.