init from https://github.com/Hufe921/canvas-editor

docs/guide/option.md

@@ -0,0 +1,189 @@
+# 配置
+
+## 使用方式
+
+```javascript
+import Editor from "@hufe921/canvas-editor"
+
+new Editor(container, IEditorData | IElement[], {
+  // 配置项
+})
+```
+
+## 完整配置
+
+```typescript
+interface IEditorOption {
+  mode?: EditorMode // 编辑器模式：编辑、清洁（不显示视觉辅助元素。如：分页符）、只读、表单（仅控件内可编辑）、打印（不显示辅助元素、未书写控件及前后括号）、设计模式（不可删除、只读等配置不控制）。默认：编辑
+  locale?: string // 多语言类型。默认：zhCN
+  defaultType?: string // 默认元素类型。默认：TEXT
+  defaultColor?: string // 默认字体颜色。默认：#000000
+  defaultFont?: string // 默认字体。默认：Microsoft YaHei
+  defaultSize?: number // 默认字号。默认：16
+  minSize?: number // 最小字号。默认：5
+  maxSize?: number // 最大字号。默认：72
+  defaultBasicRowMarginHeight?: number // 默认行高。默认：8
+  defaultRowMargin?: number // 默认行间距。默认：1
+  defaultTabWidth?: number // 默认tab宽度。默认：32
+  width?: number // 纸张宽度。默认：794
+  height?: number // 纸张高度。默认：1123
+  scale?: number // 缩放比例。默认：1
+  pageGap?: number // 纸张间隔。默认：20
+  underlineColor?: string // 下划线颜色。默认：#000000
+  strikeoutColor?: string // 删除线颜色。默认：#FF0000
+  rangeColor?: string // 选区颜色。默认：#AECBFA
+  rangeAlpha?: number // 选区透明度。默认：0.6
+  rangeMinWidth?: number // 选区最小宽度。默认：5
+  searchMatchColor?: string // 搜索高亮颜色。默认：#FFFF00
+  searchNavigateMatchColor?: string // 搜索导航高亮颜色。默认：#AAD280
+  searchMatchAlpha?: number // 搜索高亮透明度。默认：0.6
+  highlightAlpha?: number // 高亮元素透明度。默认：0.6
+  highlightMarginHeight?: number // 高亮元素边距高度。默认：8
+  resizerColor?: string // 图片尺寸器颜色。默认：#4182D9
+  resizerSize?: number // 图片尺寸器大小。默认：5
+  marginIndicatorSize?: number // 页边距指示器长度。默认：35
+  marginIndicatorColor?: string // 页边距指示器颜色。默认：#BABABA
+  margins?: IMargin // 页面边距。默认：[100, 120, 100, 120]
+  pageMode?: PageMode // 纸张模式：连页、分页。默认：分页
+  renderMode?: RenderMode // 渲染模式：极速（多个字组合渲染）、兼容（逐字渲染：避免浏览器字体等环境差异）。默认：极速
+  defaultHyperlinkColor?: string // 默认超链接颜色。默认：#0000FF
+  table?: ITableOption // 表格配置。{tdPadding?:IPadding; defaultTrMinHeight?:number; defaultColMinWidth?:number}
+  header?: IHeader // 页眉信息。{top?:number; maxHeightRadio?:MaxHeightRatio;}
+  footer?: IFooter // 页脚信息。{bottom?:number; maxHeightRadio?:MaxHeightRatio;}
+  pageNumber?: IPageNumber // 页码信息。{bottom:number; size:number; font:string; color:string; rowFlex:RowFlex; format:string; numberType:NumberType;}
+  paperDirection?: PaperDirection // 纸张方向：纵向、横向
+  inactiveAlpha?: number // 正文内容失焦时透明度。默认值：0.6
+  historyMaxRecordCount?: number // 历史（撤销重做）最大记录次数。默认：100次
+  printPixelRatio?: number // 打印像素比率（值越大越清晰，但尺寸越大）。默认：3
+  maskMargin?: IMargin // 编辑器上的遮盖边距（如悬浮到编辑器上的菜单栏、底部工具栏）。默认：[0, 0, 0, 0]
+  letterClass?: string[] // 排版支持的字母类。默认：a-zA-Z。内置可选择的字母表类：LETTER_CLASS
+  contextMenuDisableKeys?: string[] // 禁用的右键菜单。默认：[]
+  shortcutDisableKeys?: string[] // 禁用的快捷键。默认：[]
+  scrollContainerSelector?: string // 滚动区域选择器。默认：document
+  pageOuterSelectionDisable?: boolean // 鼠标移出页面时选区禁用。默认：false
+  wordBreak?: WordBreak // 单词与标点断行：BREAK_WORD首行不出现标点&单词不拆分、BREAK_ALL按字符宽度撑满后折行。默认：BREAK_WORD
+  watermark?: IWatermark // 水印信息。{data:string; color?:string; opacity?:number; size?:number; font?:string; numberType:NumberType;}
+  control?: IControlOption // 控件信息。 {placeholderColor?:string; bracketColor?:string; prefix?:string; postfix?:string; borderWidth?: number; borderColor?: string; activeBackgroundColor?: string; disabledBackgroundColor?: string; existValueBackgroundColor?: string; noValueBackgroundColor?: string;}
+  checkbox?: ICheckboxOption // 复选框信息。{width?:number; height?:number; gap?:number; lineWidth?:number; fillStyle?:string; strokeStyle?: string; verticalAlign?: VerticalAlign;}
+  radio?: IRadioOption // 单选框信息。{width?:number; height?:number; gap?:number; lineWidth?:number; fillStyle?:string; strokeStyle?: string; verticalAlign?: VerticalAlign;}
+  cursor?: ICursorOption // 光标样式。{width?: number; color?: string; dragWidth?: number; dragColor?: string; dragFloatImageDisabled?: boolean;}
+  title?: ITitleOption // 标题配置。{ defaultFirstSize?: number; defaultSecondSize?: number; defaultThirdSize?: number defaultFourthSize?: number; defaultFifthSize?: number; defaultSixthSize?: number;}
+  placeholder?: IPlaceholder // 编辑器空白占位文本
+  group?: IGroup // 成组配置。{opacity?:number; backgroundColor?:string; activeOpacity?:number; activeBackgroundColor?:string; disabled?:boolean; deletable?:boolean;}
+  pageBreak?: IPageBreak // 分页符配置。{font?:string; fontSize?:number; lineDash?:number[];}
+  zone?: IZoneOption // 编辑器区域配置。{tipDisabled?:boolean;}
+  background?: IBackgroundOption // 背景配置。{color?:string; image?:string; size?:BackgroundSize; repeat?:BackgroundRepeat; applyPageNumbers?:number[]}。默认：{color: '#FFFFFF'}
+  lineBreak?: ILineBreakOption // 换行符配置。{disabled?:boolean; color?:string; lineWidth?:number;}
+  separator?: ISeparatorOption // 分隔符配置。{lineWidth?:number; strokeStyle?:string;}
+  lineNumber?: ILineNumberOption // 行号配置。{size?:number; font?:string; color?:string; disabled?:boolean; right?:number}
+  pageBorder?: IPageBorderOption // 页面边框配置。{color?:string; lineWidth:number; padding?:IPadding; disabled?:boolean;}
+  badge?: IBadgeOption // 徽章配置。{top?:number; left?:number}
+  modeRule?: IModeRule // 编辑器模式规则配置。{print:{imagePreviewerDisabled?: boolean}; readonly:{imagePreviewerDisabled?: boolean}; form:{controlDeletableDisabled?: boolean}}
+}
+```
+
+## 表格配置
+
+```typescript
+interface ITableOption {
+  tdPadding?: IPadding // 单元格内边距。默认：[0, 5, 5, 5]
+  defaultTrMinHeight?: number // 默认表格行最小高度。默认：42
+  defaultColMinWidth?: number // 默认表格列最小宽度（整体宽度足够时应用，否则会按比例缩小）。默认：40
+}
+```
+
+## 页眉配置
+
+```typescript
+interface IHeader {
+  top?: number // 距离页面顶部大小。默认：30
+  inactiveAlpha?: number // 失活时透明度。默认：1
+  maxHeightRadio?: MaxHeightRatio // 占页面最大高度比。默认：HALF
+  disabled?: boolean // 是否禁用
+  editable?: boolean // 禁止编辑标题内容
+}
+```
+
+## 页脚配置
+
+```typescript
+interface IFooter {
+  bottom?: number // 距离页面底部大小。默认：30
+  inactiveAlpha?: number // 失活时透明度。默认：1
+  maxHeightRadio?: MaxHeightRatio // 占页面最大高度比。默认：HALF
+  disabled?: boolean // 是否禁用
+  editable?: boolean // 禁止编辑页脚内容
+}
+```
+
+## 页码配置
+
+```typescript
+interface IPageNumber {
+  bottom?: number // 距离页面底部大小。默认：60
+  size?: number // 字体大小。默认：12
+  font?: string // 字体。默认：Microsoft YaHei
+  color?: string // 字体颜色。默认：#000000
+  rowFlex?: RowFlex // 行对齐方式。默认：CENTER
+  format?: string // 页码格式。默认：{pageNo}。示例：第{pageNo}页/共{pageCount}页
+  numberType?: NumberType // 数字类型。默认：ARABIC
+  disabled?: boolean // 是否禁用
+  startPageNo?: number // 起始页码。默认：1
+  fromPageNo?: number // 从第几页开始出现页码。默认：0
+  maxPageNo?: number | null // 最大页码（从0开始）。默认：null
+}
+```
+
+## 水印配置
+
+```typescript
+interface IWatermark {
+  data: string // 文本。
+  type?: WatermarkType
+  width?: number
+  height?: number
+  color?: string // 颜色。默认：#AEB5C0
+  opacity?: number // 透明度。默认：0.3
+  size?: number // 字体大小。默认：200
+  font?: string // 字体。默认：Microsoft YaHei
+  repeat?: boolean // 重复水印。默认：false
+  gap?: [horizontal: number, vertical: number] // 水印间距。默认：[10,10]
+  numberType: NumberType.ARABIC // 页码格式。默认：{pageNo}。示例：第{pageNo}页/共{pageCount}页
+}
+```
+
+## 占位文本配置
+
+```typescript
+interface IPlaceholder {
+  data: string // 文本。
+  color?: string // 颜色。默认：#DCDFE6
+  opacity?: number // 透明度。默认：1
+  size?: number // 字体大小。默认：16
+  font?: string // 字体。默认：Microsoft YaHei
+}
+```
+
+## 行号配置
+
+```typescript
+interface ILineNumberOption {
+  size?: number // 字体大小。默认：12
+  font?: string // 字体。默认：Microsoft YaHei
+  color?: string // 颜色。默认：#000000
+  disabled?: boolean // 是否禁用。默认：true
+  right?: number // 距离正文距离。默认：20
+  type?: LineNumberType // 编号类型（每页重新编号、连续编号）。默认：连续编号
+}
+```
+
+## 页面边框配置
+
+```typescript
+interface IPageBorderOption {
+  color?: string // 颜色。默认：#000000
+  lineWidth?: number // 宽度。默认：1
+  padding?: IPadding // 距离正文内边距。默认：[0, 5, 0, 5]
+  disabled?: boolean // 是否禁用。默认：true
+}
+```