PhpStorm 2018.2 Help

File Nesting Dialog

This dialog opens when you click File Nesting on the context menu of the title bar in the Project tool window.

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 sourcemaps generated:
A typescript file leftpad.ts with a compiled JavaScript file leftpad.js                  and a generated sourcemap 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. To configure file nesting, set correspondence between the suffixes of parent files and the suffixes of the child files.
PhpStorm provides a set of predefined rules. You can edit these rules as well as define your own custom ones.

Item

Shortcut

Description

Show files with the same names as nested

  • When the checkbox is selected, PhpStorm recognizes children 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 sourcemap file leftpad.js.map shown as a nest

  • When the checkbox is cleared, PhpStorm shows parents and children at the same level.

icons general add svgAlt+Insert

Click this button to add a new row and specify the "parent" file suffix and the matching "child" file suffix.

icons general remove svgAlt+Delete

Click this button to remove the selected rule from the list.

Reset to Default

Click this button to discard all your custom patterns and reload the default rules.

Last modified: 10 October 2018