PhpStorm 2021.3 Help

File nesting dialog

Use this dialog to configure presentation of files with the same names but different suffixes.

Such bunches of files may appear in framework-specific projects, for example, if you use Angular.

Angular application: a bunch of app files with various extensions

Also consider compilation of TypeScript into JavaScript with source maps generated:

A typescript file leftpad.ts with a compiled JavaScript file leftpad.js
                 and a generated source map file leftpad.js.map shown at the same level

PhpStorm can present such file bunches as plain structures or show parent files as folders (nests) with their child files inside.

PhpStorm provides a set of predefined rules for file nesting. You can edit these rules as well as define your own custom ones. To configure file nesting, specify the suffixes of parent files and the suffixes of the child files.

Item

Shortcut

Description

Show files with the same names as nested

  • When the checkbox is selected, PhpStorm recognizes child files based on the patterns from the list and shows them grouped under the corresponding parents. Compare the presentation of the above TypeScript example with file nesting enabled

    A typescript file leftpad.ts with a compiled JavaScript file leftpad.js
                             and a generated source map file leftpad.js.map shown as a nest
  • When the checkbox is cleared, PhpStorm shows parents and children at the same level.

the Add button

Alt+Insert

Add a new row and specify the "parent" file suffix and the matching "child" file suffix. List all patterns explicitly without using wildcards or regular expressions.

the Remove button

Alt+Delete

Remove the selected rule from the list.

Reset to Default

Discard all your custom patterns and reload the default rules.

Last modified: 19 March 2022