Previous | Next | See Also

File | Settings | Project Settings | Code Style - XML

settings

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

On this page:

Tabs and Indents

ItemDescription
Use tab characterIf this check box is selected, tab characters are used:
  • On pressing the Tab key
  • For indentation
  • For code reformatting

Otherwise, spaces are used instead of tabs.

Smart tabsIf this check box is selected, IntelliJ IDEA inserts tabs for indentation and reformatting, but fine alignment to a necessary column is done only via spaces. This is done in order to preserve visual representation of the source code, when the Tab Size is changed.

If this check box is not selected, then spaces are used for alignment if necessary.

This check box is available if the Use Tab Character check box is selected.

Tab sizeIn this text box, specify the number of spaces included in a tab.
IndentIn 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 indentIn 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.

Other

ItemDescription
Keep line breaksSelect this check box to have IntelliJ IDEA honor line breaks when reviewing XML files in the editor.
Keep line breaks in textSelect this check box to have IntelliJ IDEA honor line breaks in attributes (for example, lengthy descriptions) when reviewing XML files in the editor.
Keep blank linesIn this text box, specify the minimum number of sequential blank lines to be retained after reformatting.
Wrap attributesUse 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.
Wrap textSelect this check box to have long lines wrapped according to the code style settings.
Align attributesSelect this check box to have attributes in sequential lines aligned.
Keep white spacesWhen this check box is selected, the editor preserves all whitespaces within tags. The same refers also to the indents, and line breaks.
SpacesIn 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.
CDATAIn 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 ]].

Arrangement

ItemDescription
Grouping RulesUse this area to set the grouping rules.
  • Group property field with corresponding getter/setter
  • Keep getters and setters together

    Select this check box to keep getter and setter methods together. By default, this check box is selected.

  • Keep overridden methods together

    Select this check box to group the overridden methods together by class and interface. In order: list, select keep or by name options.

  • Keep dependent methods together

    Select this check box to group the dependent methods together. In order: list, select depth-first or breadth-first options.

Matching rulesUse this area to define elements order as a list of rules, where every rule has a set of matches such as modifier or type.
  • add - use this button to add a rule. The empty rule dialog window opens.
  • delete - use this button to remove the rule from the list.
  • edit1 - 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.
  • arrowUparrowDown - use these buttons to move the selected rule up or down.
Empty ruleUse 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.
  • Modifier - use this filter to select the types of modifiers for the 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.
  • 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.
icon_sortThis icon appears when you select Order by Name in Order option. The icon indicates that the items in this rule are alphabetized.

Android

ItemDescription
Use custom formatting settings for Android XML filesUse this check box to set a custom formatting for the Android XML files. This might be helpful if you need to format Android files differently from other XML files or need to use specific Android formatting options.
If this check box is not selected, the default XML files formatting is applied.
AndroidManifest.xmlUse this area to set the following formatting for AndroidManifest.xml:
  •  Wrap attributes  - use this drop-down list to determine how attribute lines should be wrapped. See the available options.
  • Insert line break before first attribute - select this check box to insert a line before the first attribute.
  • Group tags with the same name - select this check box to group tags with the same name.
Layout FilesUse this area to set the following formatting for the layout files:
  • Wrap attributes  - use this drop-down list to determine how the attribute lines should be wrapped. See the available options.
  • Insert line break before first attribute - select this check box to insert a line break before the first attribute.
  • Insert blank line before tag - select this check box to insert a blank line before the tag.
Value Resources Files and SelectorsUse this area to set the following formatting for value resource files and selectors:
  • Wrap attributes  - use this drop-down list to determine how attribute lines should be wrapped. See the available options.
  • Insert line breaks around style declaration - select this check box to insert line breaks around a style declaration.
Other XML resource filesUse this area to set Wrap attributes for other XML resource files. See the available options.

Set From

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.

See Also

Procedures:

Reference:

Web Resources: