suneditor 2.46.2 → 3.0.0-alpha.1

package/src/core/section/context.js

@@ -0,0 +1,97 @@
+import { get as getNumber } from '../../helper/numbers';
+
+/**
+ * @description Elements and variables you should have
+ * @param {Element} editorTargets Target textarea
+ * @param {Element} top Editor top area
+ * @param {Element} wwFrame Editor wysiwyg frame
+ * @param {Element} codeWrapper Editor code view wrapper
+ * @param {Element} codeFrame Editor code view frame
+ * @param {Element|null} statusbar Editor statusbar
+ * @param {any} key root key
+ * @returns {Map}
+ */
+export const CreateFrameContext = function (editorTarget, top, wwFrame, codeWrapper, codeFrame, statusbar, key) {
+	const m = new Map([
+		['key', key],
+		['options', editorTarget.options],
+		['originElement', editorTarget.target],
+		['topArea', top],
+		['container', top.querySelector('.se-container')],
+		['wrapper', top.querySelector('.se-wrapper')],
+		['wysiwygFrame', wwFrame],
+		['wysiwyg', wwFrame], // options.iframe ? wwFrame.contentDocument.body : wwFrame
+		['codeWrapper', codeWrapper],
+		['code', codeFrame],
+		['codeNumbers', codeWrapper?.querySelector('.se-code-view-line')],
+		['lineBreaker_t', top.querySelector('.se-line-breaker-component-t')],
+		['lineBreaker_b', top.querySelector('.se-line-breaker-component-b')],
+		['_stickyDummy', top.querySelector('.se-toolbar-sticky-dummy')],
+		['_toolbarShadow', top.querySelector('.se-toolbar-shadow')],
+		['_minHeight', getNumber(wwFrame.style.minHeight || '65', 0)],
+		['isCodeView', false],
+		['isFullScreen', false],
+		['isReadOnly', false],
+		['isDisabled', false],
+		['isChanged', -1],
+		['historyIndex', -1],
+		['savedIndex', -1]
+	]);
+
+	if (statusbar) UpdateStatusbarContext(statusbar, m);
+
+	const placeholder = top.querySelector('.se-placeholder');
+	if (placeholder) m.set('placeholder', placeholder);
+
+	return m;
+};
+
+/**
+ * @description Update statusbar context
+ * @param {Element} statusbar Statusbar element
+ * @param {FrameContext} mapper FrameContext map
+ */
+export const UpdateStatusbarContext = function (statusbar, mapper) {
+	statusbar ? mapper.set('statusbar', statusbar) : mapper.delete('statusbar');
+	const navigation = statusbar ? statusbar.querySelector('.se-navigation') : null;
+	const charWrapper = statusbar ? statusbar.querySelector('.se-char-counter-wrapper') : null;
+	const charCounter = statusbar ? statusbar.querySelector('.se-char-counter-wrapper .se-char-counter') : null;
+	navigation ? mapper.set('navigation', navigation) : mapper.delete('navigation');
+	charWrapper ? mapper.set('charWrapper', charWrapper) : mapper.delete('charWrapper');
+	charCounter ? mapper.set('charCounter', charCounter) : mapper.delete('charCounter');
+};
+
+/**
+ * @description Common elements and variables you should have
+ * @param {Element} toolbar Toolbar frame
+ * @param {Element|null} toolbarContainer Toolbar container
+ * @param {Element} menuTray menu tray
+ * @param {Element|null} subbar sub toolbar
+ * @returns {Map}
+ */
+export const CreateContext = function (toolbar, toolbarContainer, menuTray, subbar, statusbarContainer) {
+	const m = new Map([
+		['menuTray', menuTray],
+		['toolbar.main', toolbar],
+		['toolbar.buttonTray', toolbar.querySelector('.se-btn-tray')],
+		['toolbar._arrow', toolbar.querySelector('.se-arrow')]
+	]);
+
+	if (subbar) {
+		m.set('toolbar.sub.main', subbar);
+		m.set('toolbar.sub.buttonTray', subbar.querySelector('.se-btn-tray'));
+		m.set('toolbar.sub._arrow', subbar.querySelector('.se-arrow'));
+		m.set('toolbar.sub._wrapper', subbar.parentElement.parentElement);
+	}
+
+	if (toolbarContainer) {
+		m.set('toolbar._wrapper', toolbarContainer.querySelector('.sun-editor'));
+		m.set('_stickyDummy', toolbarContainer.querySelector('.se-toolbar-sticky-dummy'));
+	}
+
+	if (statusbarContainer) {
+		m.set('statusbar._wrapper', statusbarContainer.querySelector('.sun-editor'));
+	}
+
+	return m;
+};

package/src/editorInjector/_classes.js

@@ -0,0 +1,22 @@
+/**
+ * @description Add all inner classes to the editor;
+ * @param {any} editor Editor object
+ * @private
+ */
+function ClassInjector(editor) {
+	this.char = editor.char;
+	this.component = editor.component;
+	this.format = editor.format;
+	this.html = editor.html;
+	this.menu = editor.menu;
+	this.nodeTransform = editor.nodeTransform;
+	this.notice = editor.notice;
+	this.offset = editor.offset;
+	this.selection = editor.selection;
+	this.shortcuts = editor.shortcuts;
+	this.toolbar = editor.toolbar;
+	this.viewer = editor.viewer;
+	if (editor.subToolbar) this.subToolbar = editor.subToolbar;
+}
+
+export default ClassInjector;

package/src/editorInjector/_core.js

@@ -0,0 +1,28 @@
+/**
+ * @description Add default properties to the editor core;
+ * @param {any} editor Editor's core
+ * @private
+ */
+function CoreInjector(editor) {
+	// editor root
+	this.editor = editor;
+	// base
+	this.eventManager = editor.eventManager;
+	this.history = editor.history;
+	this.events = editor.events;
+	this.triggerEvent = editor.triggerEvent;
+	this.carrierWrapper = editor.carrierWrapper;
+	// environment variables
+	this.plugins = editor.plugins;
+	this.status = editor.status;
+	this.context = editor.context;
+	this.options = editor.options;
+	this.icons = editor.icons;
+	this.lang = editor.lang;
+	// window, document, shadowRoot
+	this._w = editor._w;
+	this._d = editor._d;
+	this._shadowRoot = editor._shadowRoot;
+}
+
+export default CoreInjector;

package/src/editorInjector/index.js

@@ -0,0 +1,13 @@
+import CoreInjector from './_core';
+import ClassInjector from './_classes';
+
+/**
+ * @description Initializes and adds inner classes and default properties of the editor.
+ * @param {any} editor Editor object
+ */
+function EditorInjector(editor) {
+	CoreInjector.call(this, editor);
+	ClassInjector.call(this, editor);
+}
+
+export default EditorInjector;

package/src/helper/converter.js

@@ -0,0 +1,313 @@
+import { _d, _w } from './env';
+
+const FONT_VALUES_MAP = {
+	'xx-small': 1,
+	'x-small': 2,
+	small: 3,
+	medium: 4,
+	large: 5,
+	'x-large': 6,
+	'xx-large': 7,
+	'xxx-large': 8
+};
+
+/**
+ * @description Convert HTML string to HTML Entity
+ * @param {string} content
+ * @returns {string} Content string
+ * @private
+ */
+export function htmlToEntity(content) {
+	const ec = {
+		'&': '&',
+		'\u00A0': ' ',
+		"'": ''',
+		'"': '"',
+		'<': '&lt;',
+		'>': '&gt;'
+	};
+	return content.replace(/&|\u00A0|'|"|<|>/g, (m) => {
+		return typeof ec[m] === 'string' ? ec[m] : m;
+	});
+}
+
+/**
+ * @description Convert HTML Entity to HTML string
+ * @param {string} content Content string
+ * @returns {string}
+ */
+export function entityToHTML(content) {
+	const ec = {
+		'&amp;': '&',
+		'&nbsp;': '\u00A0',
+		'&apos;': "'",
+		'&quot;': '"',
+		'&lt;': '<',
+		'&gt;': '>'
+	};
+	return content.replace(/&amp;|&nbsp;|&apos;|&quot;|\$lt;|\$gt;/g, (m) => {
+		return typeof ec[m] === 'string' ? ec[m] : m;
+	});
+}
+
+/**
+ * @description Debounce function
+ * @param {Function} func function
+ * @param {number} wait delay ms
+ * @returns
+ */
+export function debounce(func, wait) {
+	let timeout;
+
+	return function executedFunction(...args) {
+		const later = () => {
+			_w.clearTimeout(timeout);
+			func(...args);
+		};
+
+		_w.clearTimeout(timeout);
+		timeout = setTimeout(later, wait);
+	};
+}
+
+/**
+ *
+ * @param {"em"|"rem"|"%"|"pt"|"px"} to Size units to be converted
+ * @param {string} size siSize to convert with units (ex: "15rem")
+ * @returns {string}
+ */
+export function fontSize(to, size) {
+	const value = size.match(/(\d+(?:\.\d+)?)(.+)/);
+	const sizeNum = value ? value[1] * 1 : FONT_VALUES_MAP[size];
+	const from = value ? value[2] : 'rem';
+	let pxSize = sizeNum;
+
+	if (/em/.test(from)) {
+		pxSize = Math.round(sizeNum / 0.0625);
+	} else if (from === 'pt') {
+		pxSize = Math.round(sizeNum * 1.333);
+	} else if (from === '%') {
+		pxSize = sizeNum / 100;
+	}
+
+	switch (to) {
+		case 'em':
+		case 'rem':
+			return (pxSize * 0.0625).toFixed(2) + to;
+		case '%':
+			return (pxSize * 0.0625).toFixed(2) * 100 + to;
+		case 'pt':
+			return Math.floor(pxSize / 1.333) + to;
+		default:
+			// px
+			return pxSize + to;
+	}
+}
+
+/**
+ * @description Convert the node list to an array. If not, returns an empty array.
+ * @param {NodeList|null} nodeList
+ * @returns Array
+ */
+export function nodeListToArray(nodeList) {
+	if (!nodeList) return [];
+	return Array.prototype.slice.call(nodeList);
+}
+
+/**
+ * @description Returns a new object with keys and values swapped.
+ * @param {Object} obj object
+ * @returns {Object}
+ */
+export function swapKeyValue(obj) {
+	const swappedObj = {};
+
+	for (const key in obj) {
+		if (Object.prototype.hasOwnProperty.call(obj, key)) {
+			swappedObj[obj[key]] = key;
+		}
+	}
+
+	return swappedObj;
+}
+
+/**
+ * @description Create whitelist RegExp object.
+ * Return RegExp format: new RegExp("<\\/?\\b(?!" + list + ")\\b[^>^<]*+>", "gi")
+ * @param {string} list Tags list ("br|p|div|pre...")
+ * @returns {RegExp}
+ */
+export function createElementWhitelist(list) {
+	return new RegExp(`<\\/?\\b(?!\\b${(list || '').replace(/\|/g, '\\b|\\b')}\\b)[^>]*>`, 'gi');
+}
+
+/**
+ * @description Create blacklist RegExp object.
+ * Return RegExp format: new RegExp("<\\/?\\b(?:" + list + ")\\b[^>^<]*+>", "gi")
+ * @param {string} list Tags list ("br|p|div|pre...")
+ * @returns {RegExp}
+ */
+export function createElementBlacklist(list) {
+	return new RegExp(`<\\/?\\b(?:\\b${(list || '^').replace(/\|/g, '\\b|\\b')}\\b)[^>]*>`, 'gi');
+}
+
+/**
+ * @description Function to check hex format color
+ * @param {string} str Color value
+ */
+export function isHexColor(str) {
+	return /^#[0-9a-f]{3}(?:[0-9a-f]{3})?$/i.test(str);
+}
+
+/**
+ * @description Function to convert hex format to a rgb color
+ * @param {string} rgb RGB color format
+ * @returns {string}
+ */
+export function rgb2hex(rgba) {
+	if (isHexColor(rgba) || !rgba) return rgba;
+
+	const rgbaMatch = rgba.match(/^rgba?[\s+]?\(([\d]+)[\s+]?,[\s+]?([\d]+)[\s+]?,[\s+]?([\d]+)[\s+]?/i);
+
+	if (rgbaMatch && rgbaMatch.length >= 4) {
+		const r = ('0' + parseInt(rgbaMatch[1], 10).toString(16)).slice(-2);
+		const g = ('0' + parseInt(rgbaMatch[2], 10).toString(16)).slice(-2);
+		const b = ('0' + parseInt(rgbaMatch[3], 10).toString(16)).slice(-2);
+
+		let a = '';
+		if (rgba.includes('rgba')) {
+			const alphaMatch = rgba.match(/[\s+]?([\d]+\.?[\d]*)[\s+]?/i);
+			if (alphaMatch) {
+				a = ('0' + Math.round(parseFloat(alphaMatch[1]) * 255).toString(16)).slice(-2);
+			}
+		}
+
+		return `#${r}${g}${b}${a}`;
+	} else {
+		return '';
+	}
+}
+
+/**
+ * @description Computes the width as a percentage of the parent's width, and returns this value rounded to two decimal places.
+ * @param {Element} target
+ * @param {Element|null} parentTarget
+ * @returns {number}
+ */
+export function getWidthInPercentage(target, parentTarget) {
+	const parent = parentTarget || target.parentElement;
+	const parentStyle = _w.getComputedStyle(parent);
+	const parentPaddingLeft = _w.parseFloat(parentStyle.paddingLeft);
+	const parentPaddingRight = _w.parseFloat(parentStyle.paddingRight);
+	const scrollbarWidth = parent.offsetWidth - parent.clientWidth;
+	const parentWidth = parent.offsetWidth - parentPaddingLeft - parentPaddingRight - scrollbarWidth;
+	const widthInPercentage = (target.offsetWidth / parentWidth) * 100;
+	return widthInPercentage;
+}
+
+/**
+ * @description Converts options-related styles and returns them for each frame.
+ * @param {Object.<string, any>} fo frameOptions
+ * @param {string} cssText Style string
+ * @returns {{top: string, frame: string, editor: string}}
+ * @private
+ */
+export function _setDefaultOptionStyle(fo, cssText) {
+	let optionStyle = '';
+	if (fo.get('height')) optionStyle += 'height:' + fo.get('height') + ';';
+	if (fo.get('minHeight')) optionStyle += 'min-height:' + fo.get('minHeight') + ';';
+	if (fo.get('maxHeight')) optionStyle += 'max-height:' + fo.get('maxHeight') + ';';
+	if (fo.get('width')) optionStyle += 'width:' + fo.get('width') + ';';
+	if (fo.get('minWidth')) optionStyle += 'min-width:' + fo.get('minWidth') + ';';
+	if (fo.get('maxWidth')) optionStyle += 'max-width:' + fo.get('maxWidth') + ';';
+
+	let top = '',
+		frame = '',
+		editor = '';
+	cssText = optionStyle + cssText;
+	const styleArr = cssText.split(';');
+	for (let i = 0, len = styleArr.length, s; i < len; i++) {
+		s = styleArr[i].trim();
+		if (!s) continue;
+		if (/^(min-|max-)?width\s*:/.test(s) || /^(z-index|position|display)\s*:/.test(s)) {
+			top += s + ';';
+			continue;
+		}
+		if (/^(min-|max-)?height\s*:/.test(s)) {
+			if (/^height/.test(s) && s.split(':')[1].trim() === 'auto') {
+				fo.set('height', 'auto');
+			}
+			frame += s + ';';
+			continue;
+		}
+		editor += s + ';';
+	}
+
+	return {
+		top: top,
+		frame: frame,
+		editor: editor
+	};
+}
+
+/**
+ * @description Set default style tag of the iframe
+ * @param {Object.<string, any>} options Options
+ * @returns {string} "<link rel="stylesheet" href=".." />.."
+ */
+export function _setIframeStyleLinks(linkNames) {
+	let tagString = '';
+
+	if (linkNames) {
+		for (let f = 0, len = linkNames.length, path; f < len; f++) {
+			path = [];
+
+			if (/(^https?:\/\/)|(^data:text\/css,)/.test(linkNames[f])) {
+				path.push(linkNames[f]);
+			} else {
+				const CSSFileName = new RegExp(`(^|.*[\\/])${linkNames[f]}(\\..+)?.css((\\??.+?)|\\b)$`, 'i');
+				for (let c = _d.getElementsByTagName('link'), i = 0, cLen = c.length, styleTag; i < cLen; i++) {
+					styleTag = c[i].href.match(CSSFileName);
+					if (styleTag) path.push(styleTag[0]);
+				}
+			}
+
+			if (!path || path.length === 0)
+				throw '[SUNEDITOR.constructor.iframe.fail] The suneditor CSS files installation path could not be automatically detected. Please set the option property "iframe_cssFileName" before creating editor instances.';
+
+			for (let i = 0, pLen = path.length; i < pLen; i++) {
+				tagString += '<link href="' + path[i] + '" rel="stylesheet">';
+			}
+		}
+	}
+
+	return tagString;
+}
+
+/**
+ * @description When iframe height options is "auto" return "<style>" tag that required.
+ * @param {string} frameHeight height
+ * @returns {string} "<style>...</style>"
+ */
+export function _setAutoHeightStyle(frameHeight) {
+	return frameHeight === 'auto' ? '<style>\n/** Iframe height auto */\nbody{height: min-content; overflow: hidden;}\n</style>' : '';
+}
+
+const converter = {
+	htmlToEntity,
+	entityToHTML,
+	debounce,
+	fontSize,
+	nodeListToArray,
+	swapKeyValue,
+	createElementWhitelist,
+	createElementBlacklist,
+	isHexColor,
+	rgb2hex,
+	getWidthInPercentage,
+	_setDefaultOptionStyle,
+	_setIframeStyleLinks,
+	_setAutoHeightStyle
+};
+
+export default converter;