am-editor-002/docs/api/engine.zh-CN.md

引擎

类型：EngineInterface

属性

options

选项

类型：EngineOptions

readonly

是否只读

类型：boolean

change

编辑时状态

类型：ChangeInterface

typing

按键处理

类型：TypingInterface

ot

协同编辑相关

类型：OTInterface

history

历史记录

类型：HistoryInterface

request

网络请求

类型：RequestInterface

方法

focus

聚焦到编辑器

/**
 * 聚焦到编辑器
 * @param start 是否聚焦的开始位置，默认为 true，false 为聚焦到结束位置
 */
focus(start?: boolean): void;

blur

取消聚焦

/**
 * 让编辑器失去焦点
 */
blur(): void;

isFocus

当前光标是否已聚焦到编辑器

/**
 * 当前光标是否已聚焦到编辑器
 */
isFocus(): boolean;

isEmpty

当前编辑器是否为空值

/**
 * 当前编辑器是否为空值
 */
isEmpty(): boolean;

getValue

获取编辑器值

/**
 * 获取编辑器值
 * @param ignoreCursor 是否包含光标位置信息
 */
getValue(ignoreCursor?: boolean): string;

getValueAsync

异步获取编辑器值，将等候插件处理完成后再获取值

/**
 * 异步获取编辑器值，将等候插件处理完成后再获取值
 * 比如插件上传等待中，将等待上传完成后再获取值
 * @param ignoreCursor 是否包含光标位置信息，默认不包含
 * @param callback 有插件还有动作未执行完时回调，返回 false 终止获取值，返回 number 设置当前动作等待时间，毫秒
 */
getValueAsync(
    ignoreCursor?: boolean,
    callback?: (
        name: string,
        card?: CardInterface,
        ...args: any
    ) => boolean | number | void,
): Promise<string>;

getHtml

获取编辑器的 html

/**
 * 获取编辑器的html
 */
getHtml(): string;

getJsonValue

获取 JSON 格式的值

/**
 * 获取JSON格式的值
 */
getJsonValue(): string | undefined | (string | {})[];

setValue

设置编辑器值

/**
 * 设置编辑器值
 * @param value 值
 * @param options 异步渲染卡片回调
 */
setValue(value: string, callback?: (count: number) => void): EngineInterface;

setHtml

设置 html 作为编辑器值

/**
* 设置html，会格式化为合法的编辑器值
* @param html html
* @param options 异步渲染卡片回调
*/
setHtml(html: string, callback?: (count: number) => void): EngineInterface

setJsonValue

设置 json 格式值，主要用于与协同服务端的值同步

/**
 * 设置json格式值，主要用于协同
 * @param callback 异步渲染卡片后的回调
 */
setJsonValue(
    value: Array<any>,
    callback?: (count: number) => void,
): EngineInterface;

setScrollNode

设置编辑器滚动条节点

setScrollNode(node?: HTMLElement)

showPlaceholder

展示占位符

/**
 * 展示 placeholder
 */
showPlaceholder(): void;

隐藏占位符

hidePlaceholder

/**
 * 隐藏 placeholder
 */
hidePlaceholder(): void;

destroy

销毁编辑器

destroy():void