0

0

如何在 Tiptap 中获取光标选区的 HTML 内容(含自定义节点标签)

花韻仙語

花韻仙語

发布时间:2026-01-09 23:48:16

|

558人浏览过

|

来源于php中文网

原创

如何在 Tiptap 中获取光标选区的 HTML 内容(含自定义节点标签)

在 tiptap 中,`state.doc.textbetween()` 仅返回纯文本,无法保留自定义节点(如 ``)的 html 结构;需结合原生 `window.getselection()` 获取真实 dom 选区并序列化为 html。

Tiptap 基于 ProseMirror 构建,其核心设计原则是将编辑器文档模型(Node/Mark 树)与浏览器 DOM 严格分离——这意味着 editor.state.doc 中存储的是结构化的 JSON 表示,而非 HTML 字符串;textBetween() 等方法仅面向逻辑文本内容,天然剥离所有节点语义和标记。

因此,若需获取用户当前光标选区的带格式、含自定义标签的 HTML 字符串(例如 100),必须绕过 ProseMirror 的文档抽象层,直接操作渲染后的 DOM:

✅ 正确做法:使用 window.getSelection() 提取选区 HTML

const getSelectedHTML = () => {
  const selection = window.getSelection();
  if (!selection || selection.rangeCount === 0) return '';

  const range = selection.getRangeAt(0);
  const fragment = range.cloneContents(); // 克隆选区 DOM 片段(保留所有节点、属性、自定义标签)

  // 创建临时容器序列化为 HTML
  const div = document.createElement('div');
  div.appendChild(fragment);
  return div.innerHTML;
};

// 在事件中调用(如按钮点击或快捷键)
const handleGetSelection = () => {
  const html = getSelectedHTML();
  console.log(html); // ✅ 输出: "This shop has 100 customers every day"
};

⚠️ 注意事项

  • 时机很重要:确保在编辑器已渲染完成、DOM 可访问时调用(例如在 useEffect 或用户交互回调中),避免因 React 渲染延迟导致 getSelection() 返回空。
  • 跨框架兼容性:该方法依赖浏览器原生 API,与 Tiptap 版本无关,适用于 v2/v3;但需注意 SSR 环境下 window 未定义,务必加运行时判断。
  • 不适用于“空选区”或“折叠选区”:当光标仅定位(无实际选中内容)时,rangeCount === 0,应做兜底处理。
  • 自定义节点需正确渲染:确保你的 扩展已正确定义 renderHTML 方法(Tiptap v2)或 addAttributes + parseHTML(v3),否则 DOM 中不会生成对应标签。

? 补充:若需 JSON 结构而非 HTML?

Tiptap 提供 editor.state.doc.slice() + editor.storage.html.serialize()(需启用 @tiptap/extension-html)可导出选区为 HTML;但更推荐使用 editor.state.doc.nodesBetween() 配合自定义序列化逻辑,以精准控制节点映射规则。

雪鸮AI
雪鸮AI

高效便捷的智能绘图辅助工具,一键生成高质量效果图。

下载

总之,不要试图从 ProseMirror 文档树“反向生成 HTML”——它不是为该目的设计的。拥抱 DOM,用 getSelection() + cloneContents() 是简洁、可靠且符合 Web 标准的解决方案。

相关文章

HTML速学教程(入门课程)
HTML速学教程(入门课程)

HTML怎么学习?HTML怎么入门?HTML在哪学?HTML怎么学才快?不用担心,这里为大家提供了HTML速学教程(入门课程),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

408

2023.08.07

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

532

2023.08.23

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

309

2023.10.13

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

74

2025.09.10

html版权符号
html版权符号

html版权符号是“©”,可以在html源文件中直接输入或者从word中复制粘贴过来,php中文网还为大家带来html的相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

603

2023.06.14

html在线编辑器
html在线编辑器

html在线编辑器是用于在线编辑的工具,编辑的内容是基于HTML的文档。它经常被应用于留言板留言、论坛发贴、Blog编写日志或等需要用户输入普通HTML的地方,是Web应用的常用模块之一。php中文网为大家带来了html在线编辑器的相关教程、以及相关文章等内容,供大家免费下载使用。

644

2023.06.21

html网页制作
html网页制作

html网页制作是指使用超文本标记语言来设计和创建网页的过程,html是一种标记语言,它使用标记来描述文档结构和语义,并定义了网页中的各种元素和内容的呈现方式。本专题为大家提供html网页制作的相关的文章、下载、课程内容,供大家免费下载体验。

465

2023.07.31

html空格
html空格

html空格是一种用于在网页中添加间隔和对齐文本的特殊字符,被用于在网页中插入额外的空间,以改变元素之间的排列和对齐方式。本专题为大家提供html空格的相关的文章、下载、课程内容,供大家免费下载体验。

245

2023.08.01

c++主流开发框架汇总
c++主流开发框架汇总

本专题整合了c++开发框架推荐,阅读专题下面的文章了解更多详细内容。

3

2026.01.09

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
React 教程
React 教程

共58课时 | 3.5万人学习

国外Web开发全栈课程全集
国外Web开发全栈课程全集

共12课时 | 1.0万人学习

React核心原理新老生命周期精讲
React核心原理新老生命周期精讲

共12课时 | 1万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号