当前位置:首页 > React

react如何安装ueditor

2026-03-31 02:00:42React

安装 UEditor 到 React 项目

UEditor 是百度推出的富文本编辑器,但在 React 中直接使用需要额外配置。以下是具体步骤:

下载 UEditor 官方资源

从百度 UEditor 官网下载最新版本,解压后将整个 ueditor 文件夹放入 React 项目的 public 目录下。确保路径为 public/ueditor

配置 UEditor 的 HTML 文件

public/index.html 中引入 UEditor 的配置文件与核心脚本:

react如何安装ueditor

<script type="text/javascript" src="%PUBLIC_URL%/ueditor/ueditor.config.js"></script>
<script type="text/javascript" src="%PUBLIC_URL%/ueditor/ueditor.all.min.js"></script>

创建 React 组件封装 UEditor

新建一个组件文件(如 UEditor.js),动态加载 UEditor 并初始化:

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

const UEditor = ({ id, config, onChange }) => {
  const editorRef = useRef(null);

  useEffect(() => {
    // 确保全局 UE 对象存在
    if (window.UE) {
      const editor = window.UE.getEditor(id, config);
      editor.addListener('ready', () => {
        editorRef.current = editor;
      });
      editor.addListener('contentChange', () => {
        onChange?.(editor.getContent());
      });
    }
    return () => {
      window.UE?.delEditor(id); // 组件卸载时销毁编辑器
    };
  }, [id, config]);

  return <script id={id} type="text/plain"></script>;
};

export default UEditor;

在项目中使用组件

在需要富文本编辑的页面中引入组件:

react如何安装ueditor

import UEditor from './UEditor';

const App = () => {
  const handleChange = (content) => {
    console.log('编辑器内容:', content);
  };

  return (
    <UEditor 
      id="editor" 
      config={{ initialFrameHeight: 300 }}
      onChange={handleChange}
    />
  );
};

解决跨域问题(开发环境)

若在开发时遇到跨域请求资源问题,需修改 ueditor.config.js 中的配置:

window.UEDITOR_HOME_URL = '/ueditor/'; // 指向 public 目录下的路径

生产环境部署

构建项目后,确保 ueditor 文件夹随 public 目录一起部署到服务器。静态资源路径需与配置一致。

注意事项

  • UEditor 依赖全局变量 window.UE,需确保脚本加载顺序。
  • 编辑器样式文件(themes/)需一并放入 public/ueditor
  • 如需自定义插件或按钮,需修改 UEditor 原生代码并重新打包。

标签: reactueditor
分享给朋友:

相关文章

react如何迭代

react如何迭代

在 React 中迭代数组或对象 React 提供了多种方式来处理数组或对象的迭代,以下是常见的方法: 使用 map 方法迭代数组 map 是 JavaScript 数组的内置方法,常用于在 Rea…

如何用react

如何用react

使用React的基本步骤 安装Node.js和npm 确保系统已安装Node.js和npm。Node.js自带npm,可从官网下载安装包。安装完成后,通过命令行验证版本: node -v npm -…

typescript react 如何

typescript react 如何

TypeScript 与 React 结合使用的方法 在 React 项目中使用 TypeScript 可以提升代码的可维护性和类型安全性。以下是一些关键步骤和最佳实践: 安装 TypeScript…

如何调试react

如何调试react

调试 React 应用的方法 使用 React Developer Tools 安装浏览器扩展(Chrome/Firefox),通过组件树查看组件状态、props 和 hooks。支持实时编辑 pro…

react如何上传文件

react如何上传文件

使用React上传文件的方法 使用HTML的input元素和FormData 创建一个文件输入字段,通过onChange事件获取文件对象,使用FormData将文件数据发送到服务器。 import…

react如何激活跟踪

react如何激活跟踪

激活 React 跟踪的方法 React 跟踪通常指性能监控、状态变更追踪或用户行为分析。以下是几种常见场景的激活方式: 使用 React DevTools React DevTools 是官方…