AppCode 2017.2 Help

Code Style. JavaScript

AppCode | Preferences | Editor | Code Style | JavaScript for macOS


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

On this page:

Tabs and Indents

Use tab character
  • If this check box is selected, tab characters are used for indentation and for code reformatting.
  • When the check box is cleared, AppCode 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 sizeIn this text box, specify the number of spaces that fits 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 between the elements of an array, in expressions, method declarations, and method calls.
Keep indents on empty linesIf this check box is selected, AppCode retains indents on empty lines as if they contained some code. If the check box is cleared, AppCode 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.

Spaces

Use this tab to specify where you want AppCode 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 AppCode will apply to various code constructs on reformatting the source code. Check the results in the Preview pane.

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 AppCode 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.

Wrapping options
A wrapping style applies to various code constructs, specified in the left-hand pane (for example, method call arguments, or assignment statements).

Do not wrap When this option is selected, no special wrapping style is applied, the nested alignment and braces settings are ignored.
Wrap if long Select this option to wrap lines going beyond the right margin with proper indentation.
Wrap always Select this option to wrap all elements in lists so that there is one element per line with proper indentation.
Chop down if long Select this option to wrap elements in lists that go beyond the right margin so that there is one element per line with proper indentation.

Alignment options

Align when multilineIf this check box is selected, a code construct starts at the same column on each next line. Otherwise, the position of a code construct is determined by the current indentation level.
<character(s)> on next lineSelect this check box to move the specified character or characters to the next line when the lines are wrapped.
'else' on new lineUse this check box to move the corresponding statements or characters to the next line.
New line after <character> Select this check box to move the code after the specified character to a new line.
Special else if treatmentIf this check box is selected, else if statements are located in the same line.

Otherwise, else if statements are moved to the next line to the corresponding indent level.

ObjectsFrom the drop-down list, choose how to align objects:
  • 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.
Variable declarationsChoose one of the following options to configure alignment for equality signs:
  • Do not align - the equality signs are not aligned.
  • Align when multiline - the equality signs in multiline var statements are aligned by inserting additional spaces.
  • Align when grouped - the equality signs in multiple var statements are aligned by inserting additional spaces.

Braces placement options

Braces placement style 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 bracesFrom 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 AppCode analyzes the number of lines in the entire statement but not only its condition.

    For example, if the code is

    int foo (int Days) { if ((Days % 10) == 3) return 1; else return 0; }
    AppCode will insert braces automatically:
    int foo (int Days) { if ((Days % 10) == 3) { return 1; } else { return 0; } }

  • Always - when this check box is selected, AppCode always inserts braces automatically.

Blank Lines

Use this tab to define where and how many blank lines you want AppCode 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.

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.

Naming conventions 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.

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 the project, resource or sources roots This option is applied during automatic generation of import statements in JavaScript code.
  • When this check box is selected, AppCode suggests paths relative to the project root, resource root, or sources root.
  • By default, this check box is cleared and AppCode suggests paths relative to the current file.
Use directory import (Node-style module resolution)
Sort imported members
  • When this check box is selected, AppCode 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 JavaScript code according to your preferences.

Grouping RulesUse this area to set the grouping rules.
  • Group property field with corresponding getter/setter
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.
  • /help/img/idea/2017.2/new.png - use this button to add a rule. The empty rule area opens.
  • /help/img/idea/2017.2/delete.png - use this button to remove the rule from the list.
  • /help/img/idea/2017.2/edit1.png - 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.
  • /help/img/idea/2017.2/arrowUp.png /help/img/idea/2017.2/arrowDown.png - use these buttons to move the selected rule up or down.
Empty ruleUse 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 classes or methods 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.
  • Aliases - this option displays aliases that were defined in the Rules Alias Definition dialog. You can remove the ones you do not need.
/help/img/idea/2017.2/icon_sort.png 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

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.

See Also

Last modified: 26 July 2017