mutation.js

/**
 * mutation.js - Mutation observer and handler
 *
 * @version     2.4.1
 * @package     tpl_lyquix
 * @author      Lyquix
 * @copyright   Copyright (C) 2015 - 2018 Lyquix
 * @license     GNU General Public License version 2 or later
 * @link        https://github.com/Lyquix/tpl_lyquix
 */

if(lqx && !('mutation' in lqx)) {
	lqx.mutation = (function(){
		var opts = {

		};

		var vars = {
			observer: null,
			addNode: [],
			removeNode: [],
			modAttrib: []
		};

		var init = function(){
			// Copy default opts and vars
			jQuery.extend(true, lqx.opts.mutation, opts);
			opts = lqx.opts.mutation;
			jQuery.extend(true, lqx.vars.mutation, vars);
			vars = lqx.vars.mutation;

			// Initialize on lqxready
			lqx.vars.window.on('lqxready', function() {
				// Initialize only if enabled
				if(opts.enabled) {
					lqx.log('Initializing `mutation`');

					// Create observer
					observer();
				}
			});

			// Run only once
			lqx.mutation.init = function(){
				lqx.warn('lqx.mutation.init already executed');
			};

			return true;
		};

		// create a custom mutation observer that will trigger any needed functions
		var observer = function(){
			// handle videos that may be loaded dynamically
			var mo = window.MutationObserver || window.WebKitMutationObserver;

			// check for mutationObserver support , if exists, user the mutation observer object, if not use the listener method.
			if (typeof mo !== 'undefined'){
				vars.observer = new mo(handler);
				vars.observer.observe(document, {childList: true, subtree: true, attributes: true});
			}
		};

		var addHandler = function(type, selector, callback) {
			// type can be addNode, removeNode, and modAttrib
			switch(type) {
				case 'addNode':
					vars.addNode.push({'selector': selector, 'callback': callback});
					break;
				case 'removeNode':
					vars.removeNode.push({'selector': selector, 'callback': callback});
					break;
				case 'modAttrib':
					vars.modAttrib.push({'selector': selector, 'callback': callback});
					break;
			}
			lqx.log('Adding handler for mutation ' + type + ' for ' + selector);
		};

		// Mutation observer handler
		var handler = function(mutRecs) {
			if(!(mutRecs instanceof Array)) {
				// Not an array, convert to an array
				mutRecs = [mutRecs];
			}
			mutRecs.forEach(function(mutRec){
				switch(mutRec.type) {
					case 'childList':
						// Handle nodes added
						if (mutRec.addedNodes.length > 0) {
							var nodes = nodesArray(mutRec.addedNodes)
							nodes.forEach(function(e){
								vars.addNode.forEach(function(h){
									if(jQuery(e).is(h.selector)) h.callback(e);
								});
							});
						}

						// Handle nodes removed
						if (mutRec.removedNodes.length > 0) {
							var nodes = nodesArray(mutRec.removedNodes)
							nodes.forEach(function(e){
								vars.removeNode.forEach(function(h){
									if(jQuery(e).is(h.selector)) h.callback(e);
								});
							});
						}
						break;

					case 'attributes':
						vars.modAttrib.forEach(function(h){
							if(mutRec.target.matches(h.selector)) h.callback(mutRec.target);
						});
						break;
				}
			});
		};

		var nodesArray = function(nodes) {
			var o = [];
			for(var i = 0; i < nodes.length; i++) {
				var n = jQuery(nodes[i]);
				o.push(n);
				var children = n.find('*').toArray();
				if(children.length) o = o.concat(children);
			}
			return o;
		}

		return {
			init: init,
			addHandler: addHandler
		};
	})();
	lqx.mutation.init();
}