WebStorm 2018.3 Help

Code Style. CSS

File | Settings | Editor | Code Style | Style Sheets | CSS for Windows and Linux
WebStorm | Preferences | Editor | Code Style | Style Sheets | CSS for macOS
Ctrl+Alt+S icons general settings svg


Use this page to configure formatting options for CSS files. View the result in the Preview pane on the right.

Tabs and Indents

Use tab character

  • If this checkbox is selected, tab characters are used for indentation and for code reformatting.

  • When the checkbox 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 checkbox 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 checkbox 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 checkbox 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 checkbox 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 checkbox is selected, WebStorm retains indents on empty lines as if they contained some code. If the checkbox is cleared, WebStorm deletes the tab characters and spaces on empty lines.

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 around top-level blocks and nested selectors. In the text box next to each option, specify the minimum number of extra blank lines to be left.

Other

In this tab, specify the alignment, braces, and spaces options to be applied on reformatting.

Braces placement

Use this drop-down list to specify where WebStorm should place the opening braces of selectors. The available options are:
  • At the end of line

  • Next line

Align values

Use this drop-down list to specify how WebStorm should align attributes and values. The available options are:
  • Do not align: select this option to specify alignment on the first character of an attribute name.

  • On value: select this option to specify alignment on the first character of the value of an attribute.

  • On colon

Align closing brace with properties

If this checkbox is selected, the closing brace of the selector will be placed under the list of properties.
If this checkbox is not selected, the closing brace of the selector will be placed under the selector.

Keep single-line blocks

If this checkbox is selected, the blocks with a single property will be confined to one line.
If this checkbox is not selected, each property will be placed to its own line.

Spaces

Select the checkboxes in this area to add a space after the colon delimiting key and value, and before the opening brace of the selector.

HEX Colors

Use this area to configure the hex color syntax. You can select from the following check options:
  • Convert hex colors to - select this checkbox to configure the hex color letter case. You can choose Lower case or Upper case.

  • Convert hex colors format to - select this checkbox to configure the hex color format length. You can choose Long format or Short format.

View changes in the Preview pane.

Arrangement

In this tab, enable sorting of CSS properties, which is by default turned off, and select the sorting order.

  • To enable sorting, select the Sort CSS properties checkbox.

  • Select By name to have all CSS properties within each block reordered alphabetically. WebStorm ignores vendor-specific prefixes but keeps multiple vendor-specific prefixes for a certain CSS property alpha-sorted.

    border: 1px solid; -moz-border-radius: 4px; -webkit-border-radius: 4px; border-radius: 4px; color: black;
  • To define your own sorting strategy, select the Custom order option and specify the desired sorting order in the textbox next to it.

    Use commas and spaces as delimiters and skip vendor-specific properties because WebStorm always groups them with the corresponding one without a prefix. Within such group, properties are sorted by vendor prefix and the prefix-free one comes last.

    WebStorm remembers the modified Custom Order list and restores it if you turn custom sorting off and then turn it on again.

To sort all CSS properties in a file

  • From the main menu, select Code | Rearrange Code.

  • Alternatively, select Code | Show Reformat File Dialog from the main menu, and then select Whole file and Rearrange code in the dialog that opens.

To sort CSS properties within a block

  • Select the block to sort and then select Code | Rearrange Code from the main menu.

  • Alternatively, select Code | Show Reformat File Dialog on the main menu, and then select Rearrange code in the dialog that opens.

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.

Last modified: 6 December 2018

See Also