feat: set locale option and api #1159

Author: Hufe921

docs/en/guide/option.md

@@ -15,6 +15,7 @@ new Editor(container, IEditorData | IElement[], {
 ```typescript
 interface IEditorOption {
   mode?: EditorMode // Editor mode: Edit, Clean (Visual aids are not displayed, For example: page break), ReadOnly, Form (Only editable within the control), Print (Visual aids are not displayed, Unwritten content control), Design (Do not handle configurations such as non deletable and read-only). default: Edit
+  locale?: string // Language. default: zhCN
   defaultType?: string // Default element type. default: TEXT
   defaultColor?: string // Default color. default: #000000
   defaultFont?: string // Default font. default: Microsoft YaHei

docs/guide/option.md

@@ -15,6 +15,7 @@ new Editor(container, IEditorData | IElement[], {
 ```typescript
 interface IEditorOption {
   mode?: EditorMode // 编辑器模式：编辑、清洁（不显示视觉辅助元素。如：分页符）、只读、表单（仅控件内可编辑）、打印（不显示辅助元素、未书写控件及前后括号）、设计模式（不可删除、只读等配置不控制）。默认：编辑
+  locale?: string // 多语言类型。默认：zhCN
   defaultType?: string // 默认元素类型。默认：TEXT
   defaultColor?: string // 默认字体颜色。默认：#000000
   defaultFont?: string // 默认字体。默认：Microsoft YaHei

src/editor/core/command/Command.ts

@@ -89,6 +89,7 @@ export class Command {
   public executeDeleteElementById: CommandAdapt['deleteElementById']
   public executeSetValue: CommandAdapt['setValue']
   public executeRemoveControl: CommandAdapt['removeControl']
+  public executeTranslate: CommandAdapt['translate']
   public executeSetLocale: CommandAdapt['setLocale']
   public executeLocationCatalog: CommandAdapt['locationCatalog']
   public executeWordTool: CommandAdapt['wordTool']
@@ -238,6 +239,7 @@ export class Command {
     this.executeDeleteElementById = adapt.deleteElementById.bind(adapt)
     this.executeSetValue = adapt.setValue.bind(adapt)
     this.executeRemoveControl = adapt.removeControl.bind(adapt)
+    this.executeTranslate = adapt.translate.bind(adapt)
     this.executeSetLocale = adapt.setLocale.bind(adapt)
     this.executeLocationCatalog = adapt.locationCatalog.bind(adapt)
     this.executeWordTool = adapt.wordTool.bind(adapt)

src/editor/core/command/CommandAdapt.ts

@@ -1990,6 +1990,10 @@ export class CommandAdapt {
     }
   }
 
+  public translate(path: string): string {
+    return this.i18n.t(path)
+  }
+
   public setLocale(payload: string) {
     this.i18n.setLocale(payload)
   }

src/editor/core/contextmenu/menus/hyperlinkMenus.ts

@@ -46,7 +46,10 @@ export const hyperlinkMenus: IRegisterContextMenu[] = [
       )
     },
     callback: (command: Command, context: IContextMenuContext) => {
-      const url = window.prompt('编辑链接', context.startElement?.url)
+      const url = window.prompt(
+        command.executeTranslate('contextmenu.hyperlink.edit'),
+        context.startElement?.url
+      )
       if (url) {
         command.executeEditHyperlink(url)
       }

src/editor/core/draw/Draw.ts

@@ -213,7 +213,7 @@ export class Draw {
     this.pageContainer = this._createPageContainer()
     this._createPage(0)
 
-    this.i18n = new I18n()
+    this.i18n = new I18n(options.locale)
     this.historyManager = new HistoryManager(this)
     this.position = new Position(this)
     this.zone = new Zone(this)

src/editor/core/i18n/I18n.ts

@@ -5,12 +5,16 @@ import { mergeObject } from '../../utils'
 import { DeepPartial } from '../../interface/Common'
 
 export class I18n {
+  private currentLocale: string
+
   private langMap: Map<string, ILang> = new Map([
     ['zhCN', zhCN],
     ['en', en]
   ])
 
-  private currentLocale = 'zhCN'
+  constructor(locale: string) {
+    this.currentLocale = locale
+  }
 
   public registerLangMap(locale: string, lang: DeepPartial<ILang>) {
     const sourceLang = this.langMap.get(locale)

src/editor/interface/Editor.ts

@@ -38,6 +38,7 @@ export interface IEditorData {
 
 export interface IEditorOption {
   mode?: EditorMode
+  locale?: string
   defaultType?: string
   defaultColor?: string
   defaultFont?: string

src/editor/utils/option.ts

@@ -150,6 +150,7 @@ export function mergeOption(
 
   return {
     mode: EditorMode.EDIT,
+    locale: 'zhCN',
     defaultType: 'TEXT',
     defaultColor: '#000000',
     defaultFont: 'Microsoft YaHei',