快速开始

快速了解可查看视频教程。用于 Vue React 参考这里。

创建空白编辑器

可直接参考 demo 示例的网页源码。

引入 CSS 定义样式

可自定义编辑器、工具栏的尺寸、边框、z-index 等样式。

<link href="https://unpkg.com/@wangeditor-next/editor@latest/dist/css/style.css" rel="stylesheet">
<style>
  #editor—wrapper {
    border: 1px solid #ccc;
    z-index: 100; /* 按需定义 */
  }
  #toolbar-container { border-bottom: 1px solid #ccc; }
  #editor-container { height: 500px; }
</style>

自定义元素样式

<style>
  /* 匹配所有 id 以 "w-e-element-paragraph-" 开头的元素 */
  [id^="w-e-element-paragraph-"] {
  /* 示例样式 */
  border:  solid #000;
  }
</style>

定义 HTML 结构

<div id="editor—wrapper">
    <div id="toolbar-container"><!-- 工具栏 --></div>
    <div id="editor-container"><!-- 编辑器 --></div>
</div>

TIP

• 如果想要“全屏”功能，则要求工具栏、编辑器 DOM 节点必须是同一层级
• 当然，工具栏、编辑器 DOM 节点也可自由组合，例如 仿腾讯文档 demo

引入 JS 创建编辑器

<script src="https://unpkg.com/@wangeditor-next/editor@latest/dist/index.js"></script>
<script>
const { createEditor, createToolbar } = window.wangEditor

const editorConfig = {
    placeholder: 'Type here...',
    onChange(editor) {
      const html = editor.getHtml()
      console.log('editor content', html)
      // 也可以同步到 <textarea>
    }
}

const editor = createEditor({
    selector: '#editor-container',
    html: '<p><br></p>',
    config: editorConfig,
    mode: 'default', // or 'simple'
})

const toolbarConfig = {}

const toolbar = createToolbar({
    editor,
    selector: '#toolbar-container',
    config: toolbarConfig,
    mode: 'default', // or 'simple'
})
</script>

TIP

不同 mode 可参考 demo

• mode: 'default' 默认模式 - 集成了 wangEditor 所有功能
• mode: 'simple' 简洁模式 - 仅有部分常见功能，但更加简洁易用

这样就创建出了一个最基本的编辑器。

接下来

要实现一个完整的富文本编辑器功能，你可能还需要以下功能：

• 内容处理 - 获取内容，设置内容，展示内容
• 工具栏配置 - 插入新菜单，屏蔽某个菜单等
• 编辑器配置 - 兼听各个生命周期，自定义粘贴
• 菜单配置 - 配置颜色、字体、字号、链接校验、上传图片、上传视频等
• 编辑器 API - 控制编辑器内容和选区
• 扩展新功能 - 扩展菜单、元素、插件等