PhpStorm 2020.2 Help

Code Style. YAML

File | Settings | Editor | Code Style | YAML for Windows and Linux

PhpStorm | Preferences | Editor | Code Style | YAML for macOS Ctrl+Alt+S the Settings/Preferences icon

Use this page to configure formatting options for YAML files. When you change these settings, the Preview pane shows how this will affect your code.

Tabs and Indents

Use tab character
  • If this checkbox is selected, tab characters are used:

    • On pressing the Tab key

    • For indentation

    • For reformatting code

  • If the checkbox is cleared, PhpStorm 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 sizeIn this field, specify the number of spaces that fits in a tab.
Indent In this field, specify the number of spaces to be inserted for each indent level.
Continuation indent

In this field, specify the number of spaces to be inserted between the elements of an array, in expressions, method declarations, and method calls.

Keep indents on empty linesIf this checkbox is selected, PhpStorm retains indents on empty lines as if they contained some code. If the checkbox is cleared, PhpStorm deletes the tab characters and spaces on empty lines.
Indent sequence value If selected, YAML sequence values are indented relative to the parent key item.

Wrapping and braces

In this tab, customize the exceptions, brace placement and alignment options that PhpStorm will apply to various code constructs on reformatting the source code. Check the results in the Preview pane.
Visual guides In this field, specify multiple right margins. You can leave a default value or enter the number of spaces for your margin. If you want to specify several margins, enter numbers separated by comma.

Keep when reformatting

Use the checkboxes to configure exceptions that PhpStorm will make when reformatting the source code. For example, by default, the Line breaks checkbox is selected.

If your code contains lines that are shorter than a standard convention, you can convert them by disabling the Line breaks checkbox before reformatting.

Alignment options

    Align values in maps

    Use this list to specify how PhpStorm should align key-value pairs. The available options are:

    • Do not align: the attributes in sequential lines will be not aligned.

    • On colon: the attributes in sequential lines will be aligned against the colon.

    • On value: the attributes in sequential lines will be aligned against the value.

    Sequence value

    Use these options to specify formatting for the YAML sequence values:

    • Sequence on new line: if selected, each new sequence inside a nested sequences block is put on a separate line:

      - - - nested sequences block

      Otherwise, nested sequences will be kept on a single line:

      - - - nested sequences block
    • Block mapping on new line: if selected, block mappings inside a sequence are put on a separate line:

      - key: value

      Otherwise, they are kept on a single line:

      - key: value

    • Automatically insert hyphen on enter: if selected, PhpStorm will automatically hyphenate the next sequence value when you press Enter.

    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: 03 September 2020