讲师中心 微信公众号
AI工具推荐 视频效率加速

如何在 React 中正确维护 contentEditable 元素的光标位置

酷强小哥_3868

酷强小哥_3868

发布时间:2026-06-30 21:19:50

|

189人浏览过

|

来源于php中文网

原创

如何在 React 中正确维护 contentEditable 元素的光标位置

使用 dangerouslySetInnerHTML 更新 contentEditable 内容时,频繁重置 innerHTML 会导致光标跳回开头;通过 useRef 直接操作 DOM 节点并延迟同步状态,可有效保持续写光标位置。

使用 `dangerouslysetinnerhtml` 更新 `contenteditable` 内容时,频繁重置 innerhtml 会导致光标跳回开头;通过 `useref` 直接操作 dom 节点并延迟同步状态,可有效保持续写光标位置。

在构建基于 contentEditable 的自定义富文本编辑器时,一个高频痛点是:用户每次输入后,光标自动跳转至编辑区域起始位置。根本原因在于:React 中 dangerouslySetInnerHTML 是“一次性快照式”渲染机制——每当 content 状态更新并触发重新渲染时,React 会销毁并重建整个 div 的 DOM 子树,导致浏览器原生光标位置信息丢失。

上述问题代码中,onInput 直接调用 setContent(...) 触发状态更新,进而引发组件重渲染 + dangerouslySetInnerHTML 重载,光标必然重置。解决方案的核心是 分离 DOM 操作与状态同步时机:

✅ 正确做法:使用 useRef 获取对 contentEditable 容器的直接引用,在 onInput 中仅读取并清洗当前 HTML(不立即更新 state),再手动同步 content 状态——避免因状态变更触发不必要的 DOM 重建。

React Best Practices 2 0.1.0
React Best Practices 2 0.1.0

React 与 Next.js 性能优化指南,源自 Vercel 工程团队。适用于编写、审查或重构 React/Next.js 代码时使用。

下载

以下是优化后的完整实现:

import React, { useState, useRef, useEffect } from 'react';

function App() {
  const [content, setContent] = useState('');
  const editableRef = useRef(null);

  const freeAllAttributeHTML = (htmlString) => {
    // 使用 replaceAll 替代正则全局匹配(注意:需确保环境支持)
    let cleaned = String(htmlString)
      .replaceAll(/<div[^>]*>/g, '<div>')
      .replaceAll(/<p[^>]*>/g, '<p>')
      .replaceAll(/<span[^>]*>/g, '<span>')
      .replaceAll(/<button[^>]*>/g, '<button>')
      .replaceAll(/<a[^>]*>/g, '<a>')
      .replaceAll(/<svg[^>]*>/g, '<svg>')
      .replaceAll(/<img[^>]*>/g, ''); // 移除 img 标签(含所有属性)
    return cleaned;
  };

  const handleContentChange = () => {
    if (!editableRef.current) return;
    const rawHTML = editableRef.current.innerHTML;
    const cleaned = freeAllAttributeHTML(rawHTML);
    setContent(cleaned);
  };

  // ⚠️ 关键补充:防止初始渲染时 ref 为空导致异常
  useEffect(() => {
    if (editableRef.current && !content) {
      editableRef.current.innerHTML = '';
    }
  }, [content]);

  return (
    <>
      <div>
        <strong>hello one</strong>
        <em> hello two</em>
      </div>
      <div
        className="editable"
        ref={editableRef}
        contentEditable={true}
        dangerouslySetInnerHTML={{ __html: content }}
        onInput={handleContentChange}
        // 可选:添加样式确保可编辑体验
        style={{ 
          minHeight: '100px', 
          border: '1px solid #ccc', 
          padding: '8px',
          outline: 'none'
        }}
      />
    </>
  );
}

export default App;

? 关键要点说明:

  • useRef 提供对 DOM 节点的稳定引用,绕过 React 渲染周期,使 innerHTML 读取不依赖状态更新;
  • onInput 中仅执行清洗与 setContent,不修改 DOM,因此光标位置由浏览器原生维护;
  • 避免在 dangerouslySetInnerHTML 同步过程中混入 setState —— 否则会形成「读 DOM → 改 state → 重渲染 → 清空 DOM → 重载 HTML」的破坏性循环;
  • 如需更健壮的 HTML 清洗,建议使用 DOMPurify.sanitize() 替代手工正则(防范 XSS 并提升兼容性);
  • 生产环境推荐配合 useCallback 缓存 handleContentChange,并考虑节流防抖以减少高频输入下的状态更新压力。

该方案在保持轻量级的同时,精准解决了 contentEditable 光标丢失问题,为自研富文本编辑器奠定了可靠基础。

热门AI工具

更多
WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

LibLibAI
LibLibAI Hot

一款AI视频创作工具,主要用于国内领先的AI创意平台,以海量模型、低门槛操作与“创作-分享-商业化”生态,让小白与专业创作者都能高效实现图文乃至视频创意表达,适合需要提升相关任务效率的用户。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

相关专题

更多
html版权符号
html版权符号

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

5195

2023.06.14

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

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

3012

2023.06.21

html网页制作
html网页制作

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

2670

2023.07.31

html空格
html空格

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

2699

2023.08.01

html是什么
html是什么

HTML是一种标准标记语言,用于创建和呈现网页的结构和内容,是互联网发展的基石,为网页开发提供了丰富的功能和灵活性。本专题为大家提供html相关的各种文章、以及下载和课程。

4619

2023.08.11

html字体大小怎么设置
html字体大小怎么设置

在网页设计中,字体大小的选择是至关重要的。合理的字体大小不仅可以提升网页的可读性,还能够影响用户对网页整体布局的感知。php中文网将介绍一些常用的方法和技巧,帮助您在HTML中设置合适的字体大小。

2661

2023.08.11

html转txt
html转txt

html转txt的方法有使用文本编辑器、使用在线转换工具和使用Python编程。本专题为大家提供html转txt相关的文章、下载、课程内容,供大家免费下载体验。

2429

2023.08.31

html文本框代码怎么写
html文本框代码怎么写

html文本框代码:1、单行文本框【<input type="text" style="height:..;width:..;" />】;2、多行文本框【textarea style=";height:;"></textare】。

2228

2023.09.01

Buffalo框架数据库开发全教程
Buffalo框架数据库开发全教程

本专题围绕Buffalo框架数据库开发,讲解database.yml多环境配置、soda与fizz迁移生成回滚、模型结构体标签、增删改查与条件查询、一对多与多对多关联、数据校验、回调钩子、事务处理及原生SQL执行能力。

160

2026.09.23

热门下载

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

精品课程

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

共58课时 | 12万人学习

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

共12课时 | 1.4万人学习

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn