# file-manager-template

> File manager with templated navigation pane, card-style large icons and custom details columns.

**Framework:** javascript  **Component:** FileManager  **Variant:** template

## Get this item

**If you are an agent, fetch the JSON.** Source is inlined, so one request is enough and no tooling is required:

```
GET https://ai.syncfusion.com/r/javascript/file-manager-template.json
```

**Install Package(s)**

```bash
npm install @syncfusion/ej2-filemanager @syncfusion/ej2-splitbuttons
```

**Notes**

- Syncfusion release: 2026 Volume 3 (v35.1.37)
- The Syncfusion package is licensed. The composition in this file is source you own and edit. See https://ai.syncfusion.com/licensing.md

## Source files

### src/components/file-manager-template/file-manager.html

```html
<div class="control-section">
    <div class="sample-container">
        <!-- Initialize FileManager -->
        <div id="container"></div>
    </div>
</div>

<style>

    .e-filemanager.e-fm-template-sample .e-list-icon {
        height: 20px !important;
        margin: 0 !important;
        width: 20px !important;
    }

    .e-dropdown-btn.filemanager-dropdown-button {
        border: none;
        margin-right: -6px;
        box-shadow: none;
        background: transparent;
    }

    .e-dropdown-btn.filemanager-dropdown-button:hover, .e-dropdown-btn.filemanager-dropdown-button.e-btn:hover {
        background: #d4d4d4;
    }

    .fluent2-dark .e-dropdown-btn.filemanager-dropdown-button:hover, .fluent2-dark .e-dropdown-btn.filemanager-dropdown-button.e-btn:hover,
    .fluent-dark .e-dropdown-btn.filemanager-dropdown-button:hover, .fluent-dark .e-dropdown-btn.filemanager-dropdown-button.e-btn:hover,
    .material3-dark .e-dropdown-btn.filemanager-dropdown-button:hover, .material3-dark .e-dropdown-btn.filemanager-dropdown-button.e-btn:hover,
    .tailwind3-dark .e-dropdown-btn.filemanager-dropdown-button:hover, .tailwind3-dark .e-dropdown-btn.filemanager-dropdown-button.e-btn:hover,
    .fluent2-highcontrast .e-dropdown-btn.filemanager-dropdown-button:hover, .fluent2-highcontrast .e-dropdown-btn.filemanager-dropdown-button.e-btn:hover,
    .highcontrast .e-dropdown-btn.filemanager-dropdown-button:hover, .highcontrast .e-dropdown-btn.filemanager-dropdown-button.e-btn:hover,
    .bootstrap5\.3-dark .e-dropdown-btn.filemanager-dropdown-button:hover, .bootstrap5\.3-dark .e-dropdown-btn.filemanager-dropdown-button.e-btn:hover {
        background: #3d3d3d;
    }

    .bootstrap5\.3 .e-dropdown-btn.filemanager-dropdown-button {
        color: #242424;
    }

    .e-filemanager.e-fm-template-sample .e-grid .e-gridheader .e-fe-grid-icon + .e-rowcell, .e-filemanager .e-grid .e-gridheader .e-fe-grid-icon + .e-headercell, .e-filemanager .e-grid .e-gridcontent .e-fe-grid-icon + .e-rowcell, .e-filemanager .e-grid .e-gridcontent .e-fe-grid-icon + .e-headercell {
        padding-left: 6px;
    }

    .e-fm-template-sample .e-nav-pane-node .e-icons {
        font-size: larger;
    }

    .e-fm-template-sample .custom-icon-card {
        padding: 8px;
        border: 1px solid #ccc;
        border-radius: 10px;
        height: 100%;
        box-sizing: border-box;
        display: flex;
        flex-direction: column;
        justify-content: flex-start;
        align-items: center;
    }

    .e-fm-template-sample .file-header {
        display: flex;
        justify-content: space-between;
        align-items: center;
        width: 100%;
        margin-bottom: 10px;
    }

    .e-fm-template-sample .left-info {
        display: flex;
        align-items: center;
        gap: 8px;
        overflow: hidden;
        flex-shrink: 1;
        flex-grow: 1;
    }

    .e-fm-template-sample .file-name {
        font-size: 14px;
        font-weight: 600;
        white-space: nowrap;
        overflow: hidden;
        text-overflow: ellipsis;
        max-width: 160px;
    }

    .e-fm-template-sample .file-formattedDate {
        font-size: 12px;
        margin-top: 8px;
        text-align: center;
        font-weight: 600;
    }

    .e-filemanager.e-fm-template-sample.e-fe-mobile .e-large-icons .e-list-parent .e-list-item {
        height: 185px;
        width: 100px;
        margin: 8px 4px;
    }

    .e-filemanager.e-fm-template-sample.e-fe-mobile .e-large-icons .e-list-parent .e-list-item .file-icon {
        width: 150px;
        height: 90px;
    }

    .e-filemanager.e-fm-template-sample.e-fe-mobile .e-large-icons .e-list-parent .e-list-item .file-name {
        max-width: 100px;
    }

    .e-filemanager.e-fm-template-sample .e-large-icons .e-list-item {
        height: 230px;
        width: 200px;
    }
    #container.e-fm-template-sample .e-layout-content {
        overflow: hidden;
    }

    .e-filemanager.e-fm-template-sample .e-large-icons .e-list-parent .e-list-item .file-icon {
        width: 190px;
        height: 150px;
        background-repeat: no-repeat;
        background-position: center center;
        background-size: contain;
        margin-bottom: 10px;
    }

    .tailwind3 .e-filemanager.e-fm-template-sample .e-treeview .e-text-content,
    .tailwind3-dark .e-filemanager.e-fm-template-sample .e-treeview .e-text-content {
        top: 0;
    }
    .e-filemanager.e-fm-template-sample .e-treeview .e-list-text {
        display: inline-flex;
    }

    .background-folder { background-image: url('/file-manager/template/folders.svg'); }
    .background-png { background-image: url('/file-manager/template/image-png.svg'); }
    .background-pptx { background-image: url('/file-manager/template/pptx.png'); }
    .background-jpg { background-image: url('/file-manager/template/image-jpg.svg'); }
    .background-doc { background-image: url('/file-manager/template/docx.png'); }
    .background-pdf { background-image: url('/file-manager/template/pdfphoto.png'); }
    .background-txt { background-image: url('/file-manager/template/text.png'); }
    .background-video { background-image: url('/file-manager/template/video.png'); }
    .background-audio { background-image: url('/file-manager/template/music.png'); }
    .background-xlsx { background-image: url('/file-manager/template/xlsx.png'); }
    .background-zip { background-image: url('/file-manager/template/zip.svg'); }

    /* People */
    .background-Adam { background-image: url('/file-manager/template/Adam.png'); }
    .background-Andrew { background-image: url('/file-manager/template/Andrew.png'); }
    .background-Ellie { background-image: url('/file-manager/template/Ellie.png'); }
    .background-Jameson { background-image: url('/file-manager/template/Jameson.png'); }
    .background-John { background-image: url('/file-manager/template/John.png'); }
    .background-Josie { background-image: url('/file-manager/template/Josie.png'); }

    /* Food */
    .background-Applepie { background-image: url('/file-manager/template/Apple pie.png'); }
    .background-Bread { background-image: url('/file-manager/template/Bread.png'); }
    .background-Doughnut { background-image: url('/file-manager/template/Doughnut.png'); }
    .background-Nuggets { background-image: url('/file-manager/template/Nuggets.png'); }
    .background-Sugarcookie { background-image: url('/file-manager/template/Sugar cookie.png'); }

    /* Nature */
    .background-bird { background-image: url('/file-manager/template/bird.jpg'); }
    .background-sea { background-image: url('/file-manager/template/sea.jpg'); }
    .background-seaview { background-image: url('/file-manager/template/seaview.jpg'); }
    .background-snow { background-image: url('/file-manager/template/snow.jpg'); }
    .background-snowfall { background-image: url('/file-manager/template/snowfall.jpg'); }
</style>

```

### src/components/file-manager-template/file-manager.ts

```typescript
import { FileManager, DetailsView, NavigationPane, Toolbar } from '@syncfusion/ej2-filemanager';
import { DropDownButton, type ItemModel } from '@syncfusion/ej2-splitbuttons';
FileManager.Inject(Toolbar, NavigationPane, DetailsView);

/**
 * File Manager template sample
 */
export function initFileManagerTemplate(): void {
    const actionItems: ItemModel[] = [
        { text: 'Open', iconCss: 'e-icons e-folder-open' },
        { text: 'Download', iconCss: 'e-icons e-download' },
        { text: 'Refresh', iconCss: 'e-icons e-refresh' },
        { text: 'Delete', iconCss: 'e-icons e-trash' },
    ];
    const hostUrl: string = 'https://physical-service.syncfusion.com/';

    const fileManager = new FileManager({
        ajaxSettings: {
            url: `${hostUrl}api/FileManager/FileOperations`,
            uploadUrl: `${hostUrl}api/FileManager/Upload`,
            downloadUrl: `${hostUrl}api/FileManager/Download`,
            getImageUrl: `${hostUrl}api/FileManager/GetImage`
        },
        cssClass: 'e-fm-template-sample',
        height: '600px',
        detailsViewSettings: {
            columns: [
                {
                    field: "name",
                    headerText: "Name",
                    template: (item: any) => {
                        return `<div>${item.name}</div>`;
                    }
                },
                {
                    field: 'size',
                    headerText: 'Size', 
                    template: (item: any) => {
                        return `<div>${item.isFile ? formatSize(item.size) : "-"}</div>`;
                    }
                },
                {
                    field: '_fm_modified', headerText: 'DateModified', format: 'MM/dd/yyyy hh:mm a'
                },
                {
                    headerText: "Actions",
                    template: (item: any) => {
                        return `
                            <div class="action-ddb" data-name="${item.name}" data-isFile="${item.isFile}"></div>
                        `;
                    }
                }
            ]
        },
        largeIconsTemplate: (item: any): string => {
            const formattedDate = item.dateCreated
                ? new Date(item.dateCreated).toLocaleDateString('en-US', {
                    year: 'numeric',
                    month: 'long',
                    day: 'numeric'
                })
                : '';
            const iconClass = getFileIconCssClass(item);
            const backgroundClass = getBackgroundCss(item);
            const iconHtml = item.isFile ? `<div class="${iconClass}"></div>` : '';
            return `
                <div class="custom-icon-card">
                    <div class="file-header">
                        <div class="left-info">
                            ${iconHtml}
                            <div class="file-name" title="${item.name}">${item.name}</div>
                        </div>
                        <div class="action-ddb" data-name="${item.name}" data-isFile="${item.isFile}"></div>
                    </div>
                    <div class="${backgroundClass}" title="${item.name}"></div>
                    <div class="file-formattedDate">Created on ${formattedDate}</div>
                </div>
            `;
        },
        navigationPaneTemplate: (item: any): string => {
            const iconClass = getIconsForFolders(item);
            return `
                <div class="e-nav-pane-node" style="display: inline-flex; align-items: center;">
                    <span class="e-icons ${iconClass}"></span>
                    <span class="folder-name" style="margin-left:8px;">${item.name}</span>
                </div>
            `;
        },
        menuOpen: (args: any) => {
            args.cancel = true;
        },
        fileLoad: (args: any) => {
            const validModules = ['DetailsView', 'LargeIconsView'];

            if (validModules.indexOf(args.module) !== -1) {
                const actionBtn = args.element.querySelector('.action-ddb') as HTMLElement;

                if (actionBtn && !actionBtn.hasAttribute('data-ddb-initialized')) {
                    wireDropDownButton(actionBtn);
                }
            }
        },
    });

    fileManager.appendTo('#container');

    function wireDropDownButton(hostEl: HTMLElement) {
        const fileName = hostEl.getAttribute('data-name') || '';
        const isFile = (hostEl.getAttribute('data-isfile') || 'false') === 'true';
        const items = isFile ? actionItems.filter((i) => i.text !== 'Open') : actionItems;
        const ddb = new DropDownButton({
            items: items,
            cssClass: 'e-caret-hide filemanager-dropdown-button',
            select: (args) => {
                const action = args.item.text || '';
                onActionSelect(action, { name: fileName, isFile });
            },
            iconCss: 'e-icons e-more-vertical-1',
        });
        ddb.appendTo(hostEl);
        hostEl.setAttribute('data-ddb-initialized', 'true');
    }

    function onActionSelect(action: string, item: { name: string; isFile: boolean }) {
        switch (action) {
            case 'Open':
                fileManager.openFile(item.name);
                break;
            case 'Download':
                fileManager.downloadFiles([item.name]);
                break;
            case 'Refresh':
                fileManager.refreshFiles();
                break;
            case 'Delete':
                fileManager.deleteFiles([item.name]);
                break;
            default:
                break;
        }
    }

    function formatSize(bytes: number): string {
        if (!bytes) return "0 B";
        const sizes = ["B", "KB", "MB", "GB", "TB"];
        let i = 0;
        while (bytes >= 1024 && i < sizes.length - 1) {
            bytes /= 1024;
            i++;
        }
        return `${bytes.toFixed(1)} ${sizes[i]}`;
    }

    function getBackgroundCss(item: any): string {
        const NamedFileBackgrounds: Record<string, string> = {
            "Adam.png": "background-Adam",
            "Andrew.png": "background-Andrew",
            "Ellie.png": "background-Ellie",
            "Jameson.png": "background-Jameson",
            "John.png": "background-John",
            "Josie.png": "background-Josie",
            "Apple pie.png": "background-Applepie",
            "Bread.png": "background-Bread",
            "Doughnut.png": "background-Doughnut",
            "Nuggets.png": "background-Nuggets",
            "Sugar cookie.png": "background-Sugarcookie",
            "bird.jpg": "background-bird",
            "sea.jpg": "background-sea",
            "seaview.jpg": "background-seaview",
            "snow.jpg": "background-snow",
            "snowfall.jpg": "background-snowfall"
        };

        const ExtensionBackgrounds: Record<string, string> = {
            "jpg": "background-jpg",
            "jpeg": "background-jpg",
            "png": "background-png",
            "pptx": "background-pptx",
            "pdf": "background-pdf",
            "mp4": "background-video",
            "mp3": "background-audio",
            "docx": "background-doc",
            "txt": "background-txt",
            "xlsx": "background-xlsx",
            "zip": "background-zip"
        };

        if (!item.isFile) return "file-icon background-folder";
        if (NamedFileBackgrounds[item.name]) return `file-icon ${NamedFileBackgrounds[item.name]}`;
        const ext = item.name.split('.').pop() || '';
        return `file-icon ${ExtensionBackgrounds[ext] || "background-default"}`;
    }

    function getIconsForFolders(item: any): string {
        const iconMap: Record<string, string> = {
            Files: 'e-folder',
            Documents: 'e-file-document',
            Downloads: 'e-download',
            Pictures: 'e-thumbnail',
            Music: 'e-file-format',
            Videos: 'e-video',
            Employees: 'e-export-png',
            Food: 'e-export-png',
            Nature: 'e-export-png'
        };
        return iconMap[item.name] || 'e-folder';
    }

    function getFileIconCssClass(item: any): string {
        if (!item.isFile) return "";

        const extensionMap: Record<string, string> = {
            jpg: "image",
            jpeg: "image",
            png: "image",
            gif: "image",
            mp3: "music",
            wav: "music",
            mp4: "video",
            avi: "video",
            doc: "doc",
            docx: "docx",
            ppt: "pptx",
            pptx: "pptx",
            xls: "xlsx",
            xlsx: "xlsx",
            txt: "txt",
            js: "js",
            css: "css",
            html: "html",
            exe: "exe",
            msi: "msi",
            php: "php",
            xml: "xml",
            zip: "zip",
            rar: "rar",
            pdf: "pdf"
        };

        const extension = (item.name.split('.').pop() || "").toLowerCase();
        const iconType = extensionMap[extension] || "unknown";
        return `e-list-icon e-fe-${iconType}`;
    }
}

```
