Client event API

Most of elFinder events pass some data to event handlers. This data stored in event.data, can be object, string or undefined.

Events handlers can be attached in two ways:

On elFinder init

$('selector').elfinder({
    // options ...
    handlers : {
        select : function(event, elfinderInstance) {
            console.log(event.data);
            console.log(event.data.selected); // selected files hashes list
        }
    }
});

After elFinder init:

var elfinder = $(selector).elfinder(options).elfinder('instance');
// or
var elfinder = new window.elFinder(document.getElementById('my-id'), options);

elfinder.bind('upload', function(event) { ... });
elfinder.unbind('load', function(event) { ... });

elfinder.one('load', function(event) { ... }); // execute once and unbind event after, similar to jQuery.one()

Event list

• init called once after elFinder node created
• load called once elFinder got first connector response
• api called once elFinder got first connector response and event.data contains api version
• enable elFinder get focus
• disable elFinder lost focus
• open on folder open
• select called on file(s) select/unselect
• dblclick called on file double click
• add called when file(s) added (fired by several commands)
• remove called when file(s) removed (fired by several commands)
• change called when file was changed (fired by several commands)
• upload called on file(s) upload
• sync called on elFinder content syncing (command "reload")
• changeclipboard called on copy/cut
• paste called on paste of copied files
• rename
• duplicate
• download
• get called when got response with file content to edit
• resize
• archive
• extract
• contextmenu
• hover called on mouseleave/mouseenter file area in cwd
• viewchange on icons/list view change
• sortchange
• searchstart after user pressed enter in search field
• search when got search results
• searchend when search field cleaned
• destroy after elFinder instance destroyed