react 富文本编辑器

re-editor

一个开箱即用的React富文本编辑器 ????当然也可以定制化啦????

编辑器默认工具栏使用了ant，如果想换个风格，可以自定义工具栏

• 使用方法
  • 开箱即用
  • 自定义
• 常见问题

特点

• 开箱即用，无需配置
• 定制化，可自行开发任意风格和形式的工具条 [API补全中]
• 支持元素功能设置，例如修改图片大小

使用方法

re-editor有两种使用方法，提供开箱即用的方式，也可以进行深度的定制化

开箱即用

安装依赖

$ npm install re-editor

引入样式

在js里面引入

import 're-editor/lib/styles/index.css'

也可以在css里面引入(需要css预处理支持)

@import 're-editor/lib/styles/index.css'

props

属性	说明	类型
value	编辑器的值	object
onChange	编辑器更改内容的回调	(value: Value) => void
placeholder	占位文本	string

自定义

编辑器分为两个部分，内容编辑区域 和 工具条，大部分的自定义需求都是集中在工具条上

安装编辑器核心

$ npm install @re-editor/core

创建工具条

可以用任何方式创建编辑器工具条，需要将编辑器的实例传给工具条，可参考 re-editor 和 @re-editor/toolbar-antd的实现，详情查看API文档(这部分文档还没写完，会在一周内补全????)

例如实现一个加粗功能:

import { command } from '@re-editor/core';

const Demo = (props) => {
  function handleClick() {
    command(props.editor)('bold')
  }
  return <div onClick={handleClick}>bold</div>
}

packages介绍

• re-editor: 一个封装好的，包含工具条的编辑器
• @re-editor/core: 编辑器核心
• @re-editor/toolbar-antd: 基于antd制作的工具条，默认
• @re-editor/examples: 演示项目

FAQ

和slate或draft-js对比有什么区别?

slate或draft并不是一个纯编辑器，它们更像是一个用于构建编辑器的框架，re-editor是基于slate开发，让你不必关注构建编辑器的过程。

怎么修改样式

样式分为两部分，node(粗体、h1、h2等)和工具栏，它们都可以通过css重写基础样式，工具栏也可以做到完全重写
样式可以通过css自定义

每次保存数据量太大怎么办？

使用增量更新，onChange回调的value是 immutable格式，可以使用immutable-js-diff等方法获取diff的内容进行增量更新