suneditor 3.0.0-alpha.9 → 3.0.0-beta.2

package/src/langs/zh_cn.js

@@ -1,3 +1,5 @@
+// Simplified Chinese, Mainland China
+// 중국어 (간체)
 (function (global, factory) {
 	if (typeof module === 'object' && typeof module.exports === 'object') {
 		module.exports = global.document
@@ -15,29 +17,75 @@
 	const lang = {
 		code: 'zh_cn',
 		align: '对齐方式',
+		alignBottom: '底部对齐',
 		alignCenter: '居中',
 		alignJustify: '两端对齐',
 		alignLeft: '左对齐',
+		alignMiddle: '中间对齐',
 		alignRight: '右对齐',
+		alignTop: '顶部对齐',
+		anchor: '锚点',
+		asBlock: '作为块',
+		asInline: '作为内联',
+		asLink: '作为链接',
 		audio: '音讯',
+		audioGallery: '音频库',
 		audio_modal_file: '上传图片',
 		audio_modal_title: '插入音频',
 		audio_modal_url: '音频网址',
-		autoSize: 'Auto size',
+		autoSize: '自动调整大小',
 		backgroundColor: '背景颜色',
 		basic: '基本',
+		blockStyle: '块样式',
 		bold: '粗体',
+		border: '边框',
+		border_all: '全部边框',
+		border_inside: '内侧边框',
+		border_horizontal: '水平边框',
+		border_vertical: '垂直边框',
+		border_outside: '外侧边框',
+		border_left: '左侧边框',
+		border_top: '顶部边框',
+		border_right: '右侧边框',
+		border_bottom: '底部边框',
+		border_none: '无边框',
 		bulletedList: '无序列表',
+		cancel: '取消',
 		caption: '标题',
+		cellProperties: '单元格属性',
 		center: '居中',
 		close: '取消',
 		codeView: '代码视图',
+		color: '颜色',
+		colorPicker: '颜色选择器',
+		column: '列',
+		comment: '评论',
+		commentAdd: '添加评论',
+		commentShow: '显示评论',
+		copy: '复制',
+		copyFormat: '绘画格式',
+		cut: '剪切',
 		default: '默认',
 		deleteColumn: '删除列',
 		deleteRow: '删除行',
 		dir_ltr: '左到右',
 		dir_rtl: '右到左',
+		download: '下载',
+		drag: '拖动',
+		drawing: '绘图',
+		drawing_modal_title: '绘图',
 		edit: '编辑',
+		embed: '嵌入',
+		embed_modal_title: '嵌入',
+		embed_modal_source: '嵌入源 / URL',
+		exportPDF: '导出为 PDF',
+		exportWord: '导出为 Word',
+		find: '查找',
+		decrease: '减少',
+		increase: '增加',
+		fileBrowser: '文件浏览器',
+		fileGallery: '文件库',
+		fileUpload: '文件上传',
 		fixedColumnWidth: '固定列宽',
 		font: '字体',
 		fontColor: '字体颜色',
@@ -50,19 +98,23 @@
 		hr_dashed: '虚线',
 		hr_dotted: '点线',
 		hr_solid: '实线',
+		id: 'ID',
 		image: '图片',
 		imageGallery: '图片库',
 		image_modal_altText: '替换文字',
 		image_modal_file: '上传图片',
 		image_modal_title: '插入图片',
 		image_modal_url: '图片网址',
+		importWord: '从 Word 导入',
 		indent: '增加缩进',
+		inlineStyle: '内联样式',
 		insertColumnAfter: '在右侧插入',
 		insertColumnBefore: '在左侧插入',
 		insertRowAbove: '在上方插入',
 		insertRowBelow: '在下方插入',
+		insertLine: '插入行',
 		italic: '斜体',
-		layout: 'Layout',
+		layout: '布局',
 		left: '左',
 		lineHeight: '行高',
 		link: '超链接',
@@ -72,6 +124,7 @@
 		link_modal_text: '要显示的文字',
 		link_modal_title: '插入超链接',
 		link_modal_url: '网址',
+		link_modal_relAttribute: 'Rel 属性',
 		list: '列表',
 		math: '数学',
 		math_modal_fontSizeLabel: '字号',
@@ -79,6 +132,7 @@
 		math_modal_previewLabel: '预览',
 		math_modal_title: '数学',
 		maxSize: '最大尺寸',
+		mediaGallery: '媒体库',
 		mention: '提到',
 		menu_bordered: '边界线',
 		menu_code: '代码',
@@ -90,8 +144,13 @@
 		minSize: '最小尺寸',
 		mirrorHorizontal: '翻转左右',
 		mirrorVertical: '翻转上下',
+		newDocument: '新文档',
 		numberedList: '有序列表',
 		outdent: '减少缩进',
+		pageBreak: '分页符',
+		pageDown: '向下翻页',
+		pageNumber: '页码',
+		pageUp: '向上翻页',
 		paragraphStyle: '段落样式',
 		preview: '预览',
 		print: '打印',
@@ -100,17 +159,22 @@
 		redo: '恢复',
 		remove: '删除',
 		removeFormat: '清除格式',
+		replace: '替换',
+		replaceAll: '全部替换',
 		resize100: '放大 100%',
 		resize25: '放大 25%',
 		resize50: '放大 50%',
 		resize75: '放大 75%',
-		resize: 'Resize',
+		resize: '调整大小',
 		revert: '恢复',
+		revisionHistory: '修订历史',
 		right: '右',
 		rotateLeft: '向左旋转',
 		rotateRight: '向右旋转',
+		row: '行',
 		save: '保存',
 		search: '搜索',
+		selectAll: '全选',
 		showBlocks: '显示块区域',
 		size: '尺寸',
 		splitCells: '分割单元格',
@@ -120,6 +184,7 @@
 		superscript: '上标',
 		table: '表格',
 		tableHeader: '表格标题',
+		tableProperties: '表格属性',
 		tags: '标签',
 		tag_blockquote: '引用',
 		tag_div: '正文 (DIV)',
@@ -128,16 +193,20 @@
 		tag_pre: '代码',
 		template: '模板',
 		textStyle: '文字样式',
-		title: 'Title',
+		title: '标题',
 		underline: '下划线',
 		undo: '撤消',
+		unmergeCells: '取消合并单元格',
 		unlink: '去除链接',
 		verticalSplit: '垂直分割',
 		video: '视频',
+		videoGallery: '视频库',
 		video_modal_file: '上传图片',
 		video_modal_title: '插入视频',
 		video_modal_url: '嵌入网址, Youtube,Vimeo',
-		width: '宽度'
+		width: '宽度',
+		message_copy_success: '已复制到剪贴板',
+		message_copy_fail: '复制失败，请手动复制。'
 	};
 
 	if (typeof noGlobal === typeof undefined) {

package/src/modules/ApiManager.js

@@ -1,44 +1,60 @@
 import { env } from '../helper';
 
 /**
- *
- * @param {*} inst
- * @param {Object|null=} params
- * @param {string|null=} params.method - HTTP method (GET, POST, PUT, DELETE...)
- * @param {string|null=} params.url - API's URL
- * @param {Object|null=} params.headers - HTTP headers
- * @param {Object|null=} params.data - API data
- * @param {Function|null=} params.callBack - API success callback
- * @param {Function|null=} params.errorCallBack - API fail callback
- * @param {string|null=} params.responseType - XMLHttpRequest.responseType
+ * @typedef ApiManagerParams
+ * @property {string=} method - HTTP method (GET, POST, PUT, DELETE...)
+ * @property {string=} url - API's URL
+ * @property {Object<string, string>=} headers - HTTP headers
+ * @property {*=} data - API data
+ * @property {(xmlHttp: XMLHttpRequest) => boolean=} callBack - API success callback
+ * @property {(res: *, xmlHttp: XMLHttpRequest) => string=} errorCallBack - API fail callback
+ * @property {XMLHttpRequestResponseType=} responseType - XMLHttpRequest.responseType
  */
-const ApiManager = function (inst, params) {
-	this.editor = inst.editor;
-	this.kind = inst.constructor.key || inst.constructor.name;
-
-	// members
-	this._xhr = env.getXMLHttpRequest();
-	// members - option
-	this.method = params?.method;
-	this.url = params?.url;
-	this.headers = params?.headers;
-	this.data = params?.data;
-	this.callBack = params?.callBack;
-	this.errorCallBack = params?.errorCallBack;
-	this.responseType = params?.responseType;
-};
-
-ApiManager.prototype = {
+
+/**
+ * @class
+ * @description API Manager
+ */
+class ApiManager {
+	/**
+	 * @constructor
+	 * @param {*} inst The instance object that called the constructor.
+	 * @param {ApiManagerParams=} params API options
+	 */
+	constructor(inst, params) {
+		/**
+		 * @description Editor instance
+		 * @type {__se__EditorCore}
+		 */
+		this.editor = inst.editor;
+
+		/**
+		 * @description UI class
+		 * @type {__se__EditorCore["ui"]}
+		 */
+		this.ui = this.editor.ui;
+
+		/**
+		 * @description Caller instance key name
+		 * @type {string}
+		 */
+		this.kind = inst.constructor.key || inst.constructor.name;
+
+		// members
+		this._xhr = env.getXMLHttpRequest();
+		// members - option
+		this.method = params?.method;
+		this.url = params?.url;
+		this.headers = params?.headers;
+		this.data = params?.data;
+		this.callBack = params?.callBack;
+		this.errorCallBack = params?.errorCallBack;
+		this.responseType = params?.responseType;
+	}
+
 	/**
 	 * @description Call API
-	 * @param {Object|null=} params
-	 * @param {string|null=} params.method - HTTP method (GET, POST, PUT, DELETE...)
-	 * @param {string|null=} params.url - API's URL
-	 * @param {Object|null=} params.headers - HTTP headers
-	 * @param {Object|null=} params.data - API data
-	 * @param {Function|null=} params.callBack - API success callback
-	 * @param {Function|null=} params.errorCallBack - API fail callback
-	 * @param {string|null=} params.responseType - XMLHttpRequest.responseType
+	 * @param {ApiManagerParams} params
 	 */
 	call({ method, url, headers, data, callBack, errorCallBack, responseType }) {
 		this.cancel();
@@ -62,16 +78,17 @@ ApiManager.prototype = {
 		}
 
 		xhr.send(data);
-	},
+	}
 
 	/**
 	 * @description Call Async API
-	 * @param {Object|null=} params
-	 * @param {string|null=} params.method - HTTP method (GET, POST, PUT, DELETE...)
-	 * @param {string|null=} params.url - API's URL
-	 * @param {Object|null=} params.headers - HTTP headers
-	 * @param {Object|null=} params.data - API data
-	 * @param {string|null=} params.responseType - XMLHttpRequest.responseType
+	 * @param {Object} params
+	 * @param {string=} params.method - HTTP method (GET, POST, PUT, DELETE...)
+	 * @param {string=} params.url - API's URL
+	 * @param {Object<string, string>=} params.headers - HTTP headers
+	 * @param {*=} params.data - API data
+	 * @param {XMLHttpRequestResponseType=} params.responseType - XMLHttpRequest.responseType
+	 * @returns {Promise<XMLHttpRequest>}
 	 */
 	asyncCall({ method, url, headers, data, responseType }) {
 		this.cancel();
@@ -84,6 +101,7 @@ ApiManager.prototype = {
 
 		const xhr = this._xhr;
 		if (responseType) xhr.responseType = responseType;
+
 		return new Promise((resolve, reject) => {
 			xhr.open(method, url, true);
 			if (headers !== null && typeof headers === 'object' && Object.keys(headers).length > 0) {
@@ -96,14 +114,14 @@ ApiManager.prototype = {
 					try {
 						resolve(xhr);
 					} finally {
-						this.editor.hideLoading();
+						this.ui.hideLoading();
 					}
 				} else {
 					try {
 						const res = !xhr.responseText ? xhr : JSON.parse(xhr.responseText);
-						reject(res, xhr);
+						reject(res);
 					} finally {
-						this.editor.hideLoading();
+						this.ui.hideLoading();
 					}
 				}
 			};
@@ -114,27 +132,32 @@ ApiManager.prototype = {
 
 			xhr.send(data);
 		});
-	},
+	}
 
 	/**
 	 * @description Cancel API (xhr.abort())
 	 */
 	cancel() {
 		if (this._xhr) this._xhr.abort();
-	},
+	}
 
 	/**
+	 * @private
 	 * @description Remove unnecessary slashes in API URL.
 	 * @param {string} url url
 	 * @returns
 	 */
 	_normalizeUrl(url) {
 		return url.replace(/([^:])\/+/g, '$1/').replace(/\/(\?|#|$)/, '$1');
-	},
-
-	constructor: ApiManager
-};
+	}
+}
 
+/**
+ * @description API callback
+ * @param {XMLHttpRequest} xmlHttp - XMLHttpRequest
+ * @param {(xmlHttp: XMLHttpRequest) => Promise<void>} callBack - Callback function
+ * @param {(res: *, xmlHttp: XMLHttpRequest) => Promise<string>} errorCallBack - Error callback function
+ */
 async function CallBackApi(xmlHttp, callBack, errorCallBack) {
 	if (xmlHttp.readyState === 4) {
 		if (xmlHttp.status === 200) {
@@ -143,7 +166,7 @@ async function CallBackApi(xmlHttp, callBack, errorCallBack) {
 			} catch (error) {
 				throw Error(`[SUNEDITOR.ApiManager[${this.kind}].upload.callBack.fail] ${error.message}`);
 			} finally {
-				this.editor.hideLoading();
+				this.ui.hideLoading();
 			}
 		} else {
 			// exception
@@ -155,11 +178,11 @@ async function CallBackApi(xmlHttp, callBack, errorCallBack) {
 					message = await errorCallBack(res, xmlHttp);
 				}
 				const err = `[SUNEDITOR.ApiManager[${this.kind}].upload.serverException] status: ${xmlHttp.status}, response: ${message || res.errorMessage || xmlHttp.responseText}`;
-				this.editor.notice.open(err);
+				this.ui.alertOpen(err, 'error');
 			} catch (error) {
 				throw Error(`[SUNEDITOR.ApiManager[${this.kind}].upload.errorCallBack.fail] ${error.message}`);
 			} finally {
-				this.editor.hideLoading();
+				this.ui.hideLoading();
 			}
 		}
 	}