Function _showModule

js/main.js:328–417

* Show the module. * @param {Module} module The module to show. * @param {number} speed The speed of the show animation. * @param {() => void} callback Called when the animation is done. * @param {object} [options] Optional settings for the show method.

(module, speed, callback, options = {})

 * @param {object} [options] Optional settings for the show method.
 */
function _showModule (module, speed, callback, options = {}) {
	// remove lockString if set in options.
	if (options.lockString) {
		const index = module.lockStrings.indexOf(options.lockString);
		if (index !== -1) {
			module.lockStrings.splice(index, 1);
		}
	}

	// Check if there are no more lockStrings set, or the force option is set.
	// Otherwise cancel show action.
	if (module.lockStrings.length !== 0 && options.force !== true) {
		Log.log(`Will not show ${module.name}. LockStrings active: ${module.lockStrings.join(",")}`);
		if (typeof options.onError === "function") {
			options.onError(new Error("LOCK_STRING_ACTIVE"));
		}
		return;
	}
	// reset all animations if needed
	if (module.hasAnimateOut) {
		removeAnimateCSS(module.identifier, module.hasAnimateOut);
		Log.debug(`${module.identifier} Force remove animateOut (in show): ${module.hasAnimateOut}`);
		module.hasAnimateOut = false;
	}
	if (module.hasAnimateIn) {
		removeAnimateCSS(module.identifier, module.hasAnimateIn);
		Log.debug(`${module.identifier} Force remove animateIn (in show): ${module.hasAnimateIn}`);
		module.hasAnimateIn = false;
	}

	module.hidden = false;

	// If forced show, clean current lockStrings.
	if (module.lockStrings.length !== 0 && options.force === true) {
		Log.log(`Force show of module: ${module.name}`);
		module.lockStrings = [];
	}

	const moduleWrapper = document.getElementById(module.identifier);
	if (moduleWrapper !== null) {
		clearTimeout(module.showHideTimer);

		// haveAnimateName for verify if we are using AnimateCSS library
		// we check AnimateCSSIn Array for validate it
		// and finally return the animate name or `null` (for default MM² animation)
		let haveAnimateName = null;
		// check if have valid animateOut in module definition (module.data.animateIn)
		if (module.data.animateIn && AnimateCSSIn.indexOf(module.data.animateIn) !== -1) haveAnimateName = module.data.animateIn;
		// can't be override with options.animate
		else if (options.animate && AnimateCSSIn.indexOf(options.animate) !== -1) haveAnimateName = options.animate;

		if (!haveAnimateName) moduleWrapper.style.transition = `opacity ${speed / 1000}s`;
		// Restore the position. See _hideModule() for more info.
		moduleWrapper.style.position = "static";
		moduleWrapper.classList.remove("hidden");

		updateWrapperStates();