Skip to content

draw.io is a JavaScript, client-side editor for general diagramming.

12.0 KB
Raw Blame
/**
 * Copyright (c) 2006-2017, JGraph Holdings Ltd
 * Copyright (c) 2006-2017, draw.io AG
 */
/**
 * Contains current settings.
 */
var mxSettings =
{
	/**
	 * Defines current version of settings.
	 */
	currentVersion: 18,
	
	defaultFormatWidth: (screen.width < 600) ? '0' : '240',
	
	// NOTE: Hardcoded in index.html due to timing of JS loading
	key: Editor.settingsKey,

	getLanguage: function()
	{
		return mxSettings.settings.language;
	},
	setLanguage: function(lang)
	{
		mxSettings.settings.language = lang;
	},
	isMainSettings: function()
	{
		return mxSettings.key == '.drawio-config';
	},
	getMainSettings: function()
	{
		var value = localStorage.getItem('.drawio-config');

		if (value == null)
		{
			value = mxSettings.getDefaults();
			delete value.isNew;
		}
		else
		{
			value = JSON.parse(value);
			value.version = mxSettings.currentVersion;
		}

		return value;
	},
	getUi: function()
	{
		return (mxSettings.isMainSettings()) ? mxSettings.settings.ui :
			mxSettings.getMainSettings().ui;
	},
	setUi: function(ui)
	{
		if (mxSettings.isMainSettings())
		{
			mxSettings.settings.ui = ui;
			mxSettings.save();
		}
		else
		{
			var value = mxSettings.getMainSettings();
			value.ui = ui;
			localStorage.setItem('.drawio-config', JSON.stringify(value));
		}
	},
	getCurrentEdgeStyle: function()
	{
		return (mxSettings.settings != null) ? mxSettings.settings.currentEdgeStyle : null;
	},
	setCurrentEdgeStyle: function(value)
	{
		mxSettings.settings.currentEdgeStyle = value;
		mxSettings.save();
	},
	/**
	 * Returns the stored array of export presets for the given format or an
	 * empty array. The entries are unvalidated and must be sanitized by the
	 * caller (see EditorUi.sanitizeExportPreset).
	 */
	getExportPresets: function(format)
	{
		var presets = (mxSettings.settings != null) ?
			mxSettings.settings.exportPresets : null;

		if (presets != null && typeof presets === 'object' &&
			!Array.isArray(presets) && typeof format === 'string' &&
			Object.prototype.hasOwnProperty.call(presets, format) &&
			Array.isArray(presets[format]))
		{
			return presets[format];
		}

		return [];
	},
	/**
	 * Stores the given array of export presets for the given format.
	 */
	setExportPresets: function(format, value)
	{
		if (typeof format === 'string' && /^[a-z]+$/.test(format) &&
			Array.isArray(value))
		{
			var presets = mxSettings.settings.exportPresets;

			if (presets == null || typeof presets !== 'object' || Array.isArray(presets))
			{
				presets = {};
			}

			presets[format] = value;
			mxSettings.settings.exportPresets = presets;
			mxSettings.save();
		}
	},
	getGridColor: function(darkMode)
	{
		var result = (darkMode) ? mxSettings.settings.darkGridColor :
			mxSettings.settings.gridColor;

		if (mxUtils.isLightDarkColor(result))
		{
			var ld = mxUtils.getLightDarkColor(result);
			result = (darkMode) ? ld.dark : ld.light;
		}

		return result;
	},
	setGridColor: function(gridColor, darkMode)
	{
		if (darkMode)
		{
			mxSettings.settings.darkGridColor = gridColor;
		}
		else
		{
			mxSettings.settings.gridColor = gridColor;
		}
	},
	getAutosave: function()
	{
		return mxSettings.settings.autosave;
	},
	setAutosave: function(autosave)
	{
		mxSettings.settings.autosave = autosave;
	},
	getResizeImages: function()
	{
		return mxSettings.settings.resizeImages;
	},
	setResizeImages: function(resizeImages)
	{
		mxSettings.settings.resizeImages = resizeImages;
	},
	getOpenCounter: function()
	{
		return mxSettings.settings.openCounter;
	},
	setOpenCounter: function(openCounter)
	{
		mxSettings.settings.openCounter = openCounter;
	},
	setCustomFonts: function(fonts)
	{
		mxSettings.settings.customFonts = fonts;
	},
	getCustomFonts: function()
	{
		//Convert from old format to the new one
		var custFonts = mxSettings.settings.customFonts || [];
		
		for (var i = 0 ; i < custFonts.length; i++)
		{
			if (typeof custFonts[i] === 'string')
			{
				custFonts[i] = {name: custFonts[i], url: null};
			}
		}
		
		return custFonts;
	},
	getLibraries: function()
	{
		return mxSettings.settings.libraries;
	},
	setLibraries: function(libs)
	{
		mxSettings.settings.libraries = libs;
	},
	addCustomLibrary: function(id)
	{
		// Makes sure to update the latest data from the localStorage
		mxSettings.load();
		
		//If the setting is incorrect, reset it to an empty array
		if (!Array.isArray(mxSettings.settings.customLibraries))
		{
			mxSettings.settings.customLibraries = [];
		}
		
		if (mxUtils.indexOf(mxSettings.settings.customLibraries, id) < 0)
		{
			// Makes sure scratchpad is below search in sidebar
			if (id === 'L.scratchpad')
			{
				mxSettings.settings.customLibraries.splice(0, 0, id);
			}
			else
			{
				mxSettings.settings.customLibraries.push(id);
			}
		}
		
		mxSettings.save();
	},
	removeCustomLibrary: function(id)
	{
		// Makes sure to update the latest data from the localStorage
		mxSettings.load();
		mxUtils.remove(id, mxSettings.settings.customLibraries);
		mxSettings.save();
	},
	getCustomLibraries: function()
	{
		return mxSettings.settings.customLibraries;
	},
	getPlugins: function()
	{
		return mxSettings.settings.plugins;
	},
	setPlugins: function(plugins)
	{
		mxSettings.settings.plugins = plugins;
	},
	getRecentColors: function()
	{
		return mxSettings.settings.recentColors;
	},
	setRecentColors: function(recentColors)
	{
		mxSettings.settings.recentColors = recentColors;
	},
	getRecentShapes: function()
	{
		return mxSettings.settings.recentShapes;
	},
	setRecentShapes: function(recentShapes)
	{
		mxSettings.settings.recentShapes = recentShapes;
	},
	getFormatWidth: function()
	{
		return parseInt(mxSettings.settings.formatWidth);
	},
	setFormatWidth: function(formatWidth)
	{
		mxSettings.settings.formatWidth = formatWidth;
	},
	getSidebarWidth: function()
	{
		return mxSettings.settings.sidebarWidth;
	},
	setSidebarWidth: function(sidebarWidth)
	{
		mxSettings.settings.sidebarWidth = sidebarWidth;
	},
	getCollapsedSections: function()
	{
		return mxSettings.settings.collapsedSections || {};
	},
	setCollapsedSections: function(collapsedSections)
	{
		mxSettings.settings.collapsedSections = collapsedSections;
	},
	getCollapsedLibraries: function()
	{
		return mxSettings.settings.collapsedLibraries || {};
	},
	setCollapsedLibraries: function(collapsedLibraries)
	{
		mxSettings.settings.collapsedLibraries = collapsedLibraries;
	},
	getLibraryOrder: function()
	{
		return mxSettings.settings.libraryOrder || null;
	},
	setLibraryOrder: function(order)
	{
		mxSettings.settings.libraryOrder = order;
	},
	getWindowState: function(name)
	{
		var states = mxSettings.settings.windowStates;

		return (states != null) ? states[name] : null;
	},
	setWindowState: function(name, state)
	{
		if (mxSettings.settings.windowStates == null)
		{
			mxSettings.settings.windowStates = {};
		}

		mxSettings.settings.windowStates[name] = state;
	},
	getPageFormat: function()
	{
		return mxSettings.settings.pageFormat;
	},
	setPageFormat: function(value)
	{
		mxSettings.settings.pageFormat = value;
	},
	getUnit: function()
	{
		return mxSettings.settings.unit || mxConstants.POINTS;
	},
	setUnit: function(value)
	{
		mxSettings.settings.unit = value;
	},
	isRulerOn: function()
	{
		return mxSettings.settings.isRulerOn;
	},
	setRulerOn: function(value)
	{
		mxSettings.settings.isRulerOn = value;
	},
	getDraftSaveDelay: function()
	{
		return mxSettings.settings.draftSaveDelay;
	},
	setDraftSaveDelay: function(value)
	{
		mxSettings.settings.draftSaveDelay = value;
	},
	getDefaults: function()
	{
		return {
			language: '',
			configVersion: Editor.configVersion,
			customFonts: [],
			libraries: Sidebar.prototype.defaultEntries,
			customLibraries: Editor.defaultCustomLibraries,
			plugins: [],
			recentColors: [],
			recentShapes: [],
			formatWidth: mxSettings.defaultFormatWidth,
			sidebarWidth: null,
			collapsedSections: {},
			collapsedLibraries: {},
			pageFormat: mxGraph.prototype.pageFormat,
			search: true,
			gridColor: mxGraphView.prototype.defaultGridColor,
			darkGridColor: mxGraphView.prototype.defaultDarkGridColor,
			darkMode: 'auto',
			autosave: !EditorUi.isElectronApp,
			resizeImages: null,
			openCounter: 0,
			version: mxSettings.currentVersion,
			// Only defined and true for new settings which haven't been saved
			isNew: true,
			unit: mxConstants.POINTS,
			isRulerOn: false,
			windowStates: {},
			// Persisted global current edge style (the toolbar dropdown's choice for
			// new edges when nothing is selected). null => use the theme default.
			currentEdgeStyle: null
		};
	},
	init: function()
	{
		mxSettings.settings = mxSettings.getDefaults();
	},
	save: function()
	{
		if (isLocalStorage && typeof(JSON) !== 'undefined')
		{
			try
			{
				delete mxSettings.settings.isNew;
				mxSettings.settings.version = mxSettings.currentVersion;
				localStorage.setItem(mxSettings.key, JSON.stringify(mxSettings.settings));
			}
			catch (e)
			{
				// ignores quota exceeded
			}
		}
	},
	load: function()
	{
		try
		{
			if (isLocalStorage && typeof(JSON) !== 'undefined')
			{
				mxSettings.parse(localStorage.getItem(mxSettings.key));
			}
		}
		catch (e)
		{
			if (window.console != null)
			{
				console.log('Error loading settings:', mxSettings.key, e);
			}
		}

		if (mxSettings.settings == null)
		{
			mxSettings.init();
		}
	},
	parse: function(value)
	{
		var config = (value != null) ? JSON.parse(value) : null;

		// A stored value that is not an object, eg. 1, would silently drop all
		// defaults below, including the page format
		if (config == null || typeof config !== 'object' ||
			(config.configVersion != Editor.configVersion) ||
			(Editor.config != null && Editor.config.override))
		{
			mxSettings.settings = null;
			mxSettings.init();
		}
		else
		{
			mxSettings.settings = config;
			
			if (mxSettings.settings.plugins == null)
			{
				mxSettings.settings.plugins = [];
			}
			
			if (mxSettings.settings.recentColors == null)
			{
				mxSettings.settings.recentColors = [];
			}

			// Recent shapes of the sidebar (see Sidebar.addRecentShapes)
			if (!Array.isArray(mxSettings.settings.recentShapes))
			{
				mxSettings.settings.recentShapes = [];
			}

			if (mxSettings.settings.customFonts == null)
			{
				mxSettings.settings.customFonts = [];
			}
			
			if (mxSettings.settings.libraries == null)
			{
				mxSettings.settings.libraries = Sidebar.prototype.defaultEntries;
			}
			
			if (mxSettings.settings.customLibraries == null)
			{
				mxSettings.settings.customLibraries = Editor.defaultCustomLibraries;
			}
			
			if (mxSettings.settings.ui == null)
			{
				mxSettings.settings.ui = '';
			}
			
			if (mxSettings.settings.formatWidth == null)
			{
				mxSettings.settings.formatWidth = mxSettings.defaultFormatWidth;
			}
			
			if (mxSettings.settings.lastAlert != null)
			{
				delete mxSettings.settings.lastAlert;
			}
			
			if (mxSettings.settings.pageFormat == null)
			{
				mxSettings.settings.pageFormat = mxGraph.prototype.pageFormat;
			}
			
			if (mxSettings.settings.search == null)
			{
				mxSettings.settings.search = true;
			}
			
			if (mxSettings.settings.gridColor == null)
			{
				mxSettings.settings.gridColor = mxGraphView.prototype.defaultGridColor;
			}

			if (mxSettings.settings.darkGridColor == null)
			{
				mxSettings.settings.darkGridColor = mxGraphView.prototype.defaultDarkGridColor;
			}
			
			if (mxSettings.settings.autosave == null)
			{
				mxSettings.settings.autosave = !EditorUi.isElectronApp;
			}
			else if (EditorUi.isElectronApp && localStorage.getItem('._autoSaveTrans_') == null) //Transition to no autosave
			{
				localStorage.setItem('._autoSaveTrans_', '1');
				mxSettings.settings.autosave = false;
				mxSettings.save();
			}
			
			if (mxSettings.settings.scratchpadSeen != null)
			{
				delete mxSettings.settings.scratchpadSeen;
			}
		}
	},
	clear: function() 
	{
		if (isLocalStorage)
		{
			localStorage.removeItem(mxSettings.key);
		}
	}
}

/**
 * Variable: mxLoadSettings
 * 
 * Optional global config variable to toggle loading the settings. Default is true.
 *
 * (code)
 * <script type="text/javascript">
 * 		var mxLoadSettings = false;
 * </script>
 * (end)
 */
if (typeof(mxLoadSettings) == 'undefined' || mxLoadSettings)
{
	// Loads initial content
	mxSettings.load();
}