Adobe Commerce 2.3 reached end of support in September 2022.

FolderTree widget

The FolderTree widget allows creating a dynamic hierarchical tree structure with folders.

The main purpose of this widget is to represent a folder structure from the server, database or another resource and to allow the users to browse that structure.

The dynamic hierarchical allows us to easily update the folders via Ajax URL and show different levels of folders, with subfolders that can be collapsed and expanded.

For example: in the Wysiwyg editor, the FolderTree widget is used to represents the structure of media folders on the server. After clicking on one of the folders, an admin is able to see media files within the folder.

Example of Media Folder Tree

The FolderTree widget can be used only in the adminhtml area.

The FolderTree widget source is <Magento_Cms_module_dir>/view/adminhtml/web/js/folder-tree.js.

Initialize the FolderTree widget

For information about how to initialize a widget in a JS component or .phtml template, see the Initialize JavaScript topic.

1
2
3
4
5
$("#folder-tree").folderTree({
    rootName: 'Root',
    url: 'some/url',
    currentPath: ['root']
});

Where:

  • #folder-tree is the selector of the element which will display FolderTree.

The following example shows a PHTML file using the script:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
<script>
    require([
        'jquery',
        'Magento_Cms/js/folder-tree'
    ], function ($) {
        'use strict';

        $("#folder-tree").folderTree({
            rootName: 'Root',
            url: 'some/url',
            currentPath: ['root']
        });
    });
</script>

Options

currentPath

This option pre-opens the specified folder path. It is an array of folders IDs which represents the path to the current opened folder.

Type: Array

Default value: ['root']

root

The id for the root folder HTML element.

Type: String

Default value: 'root'

rootName

The name of the root folder.

Type: String

Default value: 'Root'

tree

The configuration for jstree widget.

The FolderTree widget uses the jstree widget to build a hierarchical tree with folders.

Type: String

Default value:

1
2
3
4
5
6
7
8
{
    'plugins': ['themes', 'json_data', 'ui', 'hotkeys'],
    'themes': {
        'theme': 'default',
        'dots': false,
        'icons': true
    }
}

url

The endpoint URL for getting the folders JSON data.

The example of the JSON response:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
[
  {
    "text": "Folder #1",
    "id": "1",
    "path": "some/path/",
    "cls": "folder folder-1"
  },
  {
    "text": "Folder #2",
    "id": "2",
    "path": "some/path/2",
    "cls": "folder folder-2"
  }
]

Type: String

Default value: undefined

Code sample

The following example shows the initialization of FolderTree widget.

1
2
3
4
5
6
7
<div data-role="tree" data-mage-init='{
    "folderTree": {
        "rootName": "Root",
        "url": "/some/path/jsontree",
        "currentPath": ["root"]
    }
}'>

Result

FolderTree widget example