1.0.7 • Published 1 year ago
yl_textbus v1.0.7
🚀 Textbus 是一个组件化、跨平台、数据驱动的富文本框架，并坚定的支持在线多人协作。你可以在 Textbus 中轻松创建出类似钉钉文档、石墨文档、飞书文档等完全自定义的编辑器。
如果你还在使用 1.0 版本，源代码请访问 Textbus 1.*
官方文档
介绍
我们一直致力于让富文本开发也能像普通前端框架一样，通过简明易懂的 api 和少量的约定，即可开发出使用流畅、交互丰富的富文本应用。
为了解决传统富文本开发的难题，Textbus 首次在富文本中引入了组件的概念，这让富文本开发就像拼积木一样，不再是前端领域不可跨越的天坑。不管你是富文本开发领域的老鸟，亦或是前端的新手，Textbus 都将帮助你把富文本做得更好。
Textbus 的特点
- 组件化：根据富文本的特点而专门开发的组件化系统，让富文本编辑支持复杂布局，插入特殊控件等就像现代前端框架一样，非常的简单。
- 完全可控：由于 Textbus 采用完全的数据驱动，输入输出完全依赖内核来完成，在不同的浏览器上，不会存在不一样的行为和结果。
- 易扩展：hooks 风格的扩展代码，让你在不同上下文中对同样事件定制不同的行为变得异常简单。
- 语法糖支持：高度灵活的语法糖支持，你可以非常灵活的定制输入实时转换功能，如 Markdown 中的 # 号 + 空格变为标题等，你也可以完全自创语法，只要你开心。
- 格式兼容：完全可定制的文档解析能力，可以让你最大可能的保持从网页、word 等其它页面复制过来的内容和格式。
- 格式限制：既可以做到组件深层次嵌套，也可以做到像现在大多数编辑器一样 block 化。
- 转换便捷：内置功能强大的格式转换能力，这也是富文本的难点之一，尤其是对于支持树状数据结构的编辑器来说，要实现这一点非常复杂。
- 高性能：高性能的渲染器和 jsx/tsx 支持，高性能意味着打开超长文档、超大文档不容易卡顿，jsx 的支持意味着编写复杂布局和复杂交互的组件更容易。
- 支持在线协作：Textbus 官方目前提供了基于 Yjs 的协作能力支持，你也可以采用其它的协作方案来对接 Textbus 的数据模型。
- 高度抽象：完全抽象的光标和选区系统，你不需要再关心浏览器复杂的选区问题。
模块
| 模块 | 作用 |
|---|---|
| @textbus/core | 核心模块，提供了组件、插槽、格式、属性的数据模型抽象和选区、格式变换、渲染、组件生命周期管理、编辑器控制、历史记录、快捷键管理、语法糖管理、输出转换等富文本核心能力的实现 |
| @textbus/platform-browser | 浏览器支持中间层，提供了基本的视图层，桥接了选区、光标、和 DOM 渲染能力 |
| @textbus/collaborate | 协作支持模块，提供了基于 Yjs 的协作对接能力 |
| @textbus/editor | 官方实现的一个简易的编辑器，提供了基本的文档编辑能力 |
| @textbus/platform-node | 适用于 node 后台运行的 Textbus 的实用工具集 |
3.0 预览
- node 中间层实现
- 移动端中间层实现
- 功能更完善的编辑器组件
安装
Textbus 可能通过两种方式引入到你的项目中。
通过 npm 安装
npm install @textbus/editor在 DOM 中准备好一个空的标签
<div id="editor"></div>创建编辑器实例
import '@textbus/editor/bundles/textbus.min.css';
import { createEditor } from '@textbus/editor';
const editor = createEditor()
editor.mount(document.getElementById('editor'))通过 script 标签引入
<!DOCTYPE html>
<html>
<head>
<link rel="stylesheet" href="/path/textbus.min.css">
<script src="/path/textbus.min.js"></script>
<title>Textbus 示例</title>
</head>
<body>
<div id="editor"></div>
<script>
var editor = textbus.editor.createEditor()
editor.mount(document.getElementById('editor'))
</script>
</body>
</html>设置默认内容
const editor = createEditor({
content: '<p>这里是默认内容</p>'
})常用方法
销毁编辑器
editor.destroy()获取焦点
editor.focus()取消焦点
editor.blur()获取 HTML 内容
const html = editor.getHTML()获取 JSON 内容
const json = editor.getJSON()替换内容
editor.replaceContent('<p>新内容！</p>')
editor.replaceContent({
// 必须为 Textbus 导出的 JSON 格式
})清空编辑器
editor.replaceContent('')本地开发
Textbus 采用 pnpm 作为多模块管理，全局安装 pnpm。
npm install pnpm -g克隆 Textbus 仓库，并安装依赖。
git clone git@github.com:textbus/textbus.git
cd textbus
pnpm install启动开发环境。
npm start联系我们
如果在官网还不能找到你想了解的问题，你可以加入 Textbus 的官方 QQ 群：786923770。你也可以直接扫码加入：
赞助
Textbus 的成长离不开社会的支持，如果 Textbus 为你带来了帮助，并且你也认同为知识付费，同时鼓励我们做的更好，欢迎通过下面的二维码表达你的支持
