Use this page to configure
options for XML files. View the result in the
pane on the right.
On this page:
Tabs and Indents
|Use tab character
If this check box is selected, tab characters are used:
- On pressing the TabTabTabTabTabTabTabTabTabTabTab key
- For indentation
- For code reformatting
When the check box is cleared, PhpStorm uses spaces instead of tabs.
If this check box is selected, PhpStorm inserts tabs for indentation and reformatting,
but fine alignment to a necessary column is done
only via spaces without replacing them with tabs.
This is done in order to preserve visual
representation of the source code, when the
If this check box is cleared, only tabs are used. This means that a group of spaces that fits the specified tab size is automatically replaced with a tab,
which may result in breaking fine alignment.
The Smart Tabs check box is available if the Use Tab Character
check box is selected.
||In this text box, specify the number of spaces included in a tab.
||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.
||In this text box, specify the number of spaces (or tabs if the
Use Tab Character check box is selected) to be inserted at the next line in case of a construct break.
|Keep indents on empty lines
||If this check box is selected, then PhpStorm will keep indents on the empty lines as if they have contained some code.
If this check box is not selected, PhpStorm will delete the tabulation characters.
|Detect and use existing file indents for editing
||Use this check box to detect code style settings in the currently edited file on the fly. In this case, when you open a file in the editor,
indentation that was used in that file is preserved automatically. For example, if tabs were used for the indentation then in copy, paste or enter actions,
tabs are used. Also, note that if you use the Reformat Code command then PhpStorm applies default code style settings and uses them in the editor.
||By default, this check box is selected and indicates right column margin in the Right margin (columns) field.
Clear this check box to set a different value in the Right margin (columns) field.
|Keep line breaks
||Select this check box to have PhpStorm honor line breaks when reviewing XML files in the editor.
|Keep line breaks in text
||Select this check box to have PhpStorm honor line breaks in attributes (for example, lengthy descriptions) when
reviewing XML files in the editor.
|Keep blank lines
||In this text box, specify the minimum number of sequential blank lines to be retained after reformatting.
||Use this drop-down list to determine how attribute lines should be wrapped. The available options are:
Do not wrap -
if this option is selected, no special wrapping style is applied to the code.
Wrap if long -
select this option to have lines going beyond the right margin wrapped with proper indentation.
Chop down if long -
select this option to have elements in lists that go beyond the right margin wrapped
to give one element per line with proper indentation.
Wrap always -
select this option to have all elements in lists wrapped to give one element per line with proper indentation.
||Select this check box to have long lines wrapped according to the code style settings.
||Select this check box to have attributes in sequential lines aligned.
|Keep white spaces
||When this check box is selected, the editor preserves all whitespaces within tags. The same refers also to the indents, and line breaks.
||In this area, define the usage of spaces for attributes and tag names.
Around "=" in attribute:
select this check box to have spaces added around the "=" symbol in attributes.
After tag name:
select this check box to have spaces added after tag names.
In empty tag:
select this check box to have spaces added in empty tags.
||In this area, define the usage of whitespaces around and inside CDATA sections in MXML files:
Whitespaces around: from the drop-down list, choose how whitespaces around CDATA will be treated.
Preserve: all whitespaces will be left intact after reformatting.
Remove (keep with tags): all whitespaces around CDATA will be removed,
and tags will be kept on the same lines.
New lines: new lines will be added before and after CDATA.
Keep whitespaces inside: If this check box is selected, whitespaces will be preserved after
CDATA[ and before ]].
This tab lets you define a set of rules that rearranges your code according to your preferences.
||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 dialog window 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.
||Use this window to create a new matching rule or edit an existing one.
You can select from the following filters:
Type - use this filter to choose classes or methods for your rule.
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 and etc. The filter supports regular expressions and uses a standard syntax. The match is performed
against the entire name.
Namespace - use this field to specify the namespace in the rule. It lets you specify a rule that controls
a namespace attribute position.
Order - use this option 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.
Aliases - this option displays aliases that were defined in the Rules Alias Definition dialog. You can remove the ones you do not need.
||This icon appears when you select Order by Name in Order option. The icon indicates that the items in this rule are alphabetized.
||Use this area to set additional arrangement options. The Force rearrange drop-down list lets you
select options that affect the Rearrange entries check box in the Reformat Code
You can select from the following options:
- Use current mode (toggled in the Reformat Code dialog) - In this case the Rearrange entries
check box stays active and you can modify it in the Reformat Code dialog.
- Always - In this case the Rearrange entries check box is selected
and becomes read-only.
- Never - In this case the Rearrange entries check box is cleared and
Click this link to reveal the list of languages to be used as the base for the current language code style. So doing,
only the settings that are applicable to the current language are taken. All the other settings are not affected.
This link appears in the upper-right corner of the language-specific code style page, when applicable.
Click Reset to discard changes and return to the initial set of code style settings.