Django集成百度富文本编辑器uEditor

UEditor是由百度web前端研发部开发所见即所得富文本web编辑器，具有轻量，可定制，注重用户体验等特点，开源基于MIT协议，允许自由使用和修改代码。

首先从ueEditor官网下载最新版本的包，目前官网上提供了ASP、.NET、PHP、JSP版本的，django版本只有一个第三方个人开发的，但看上出配置起来稍微复杂一点。

这里不介绍uEditor的使用方法，也不过多解释uEditor的配置方法，官网上都有详细的文档和API介绍，下载的Demo中也有常用的方法的示例代码，这里主要介绍uEditor和django集成需要修改的地方。

这里下载任意一个版本的都可以，因为我们只需要把关于ueEditor前端部分的抽取出来，至于后端服务器的，我们自己开发实现。

其实，uEditord的绝大部分功能在django中都是可用的，只有上传文件、图片、视频、在线图片、在线文件这一部分和上传有关系的部分不好用，因为这些功能需要后台处理程序的支持才可以，所以，我们自己要做的，就是用python实现这部分的处理逻辑。

uEditor与后台交互的逻辑：

1.编辑器初始化时，异步请求后台处理页面，处理程序应该返回一套json格式的配置信息，请求地址携带的参数为action=config

2.点击图片上传按钮，异步请求后台处理页面，请求地址携带参数为action=uploadimage

3.点击视频上传按钮，异步请求后台处理页面，请求地址携带参数为action=uploadvideo

4.点击附件上传按钮，异步请求后台处理页面，请求地址携带参数为action=uploadfile

5.点击多图上传中的在线图片选项卡，异步请求后台处理页面，请求地址携带参数为action=listimage

6.点击附件上传的在线文件选项卡，异步请求后台处理页面，请求地址携带参数为action=listfile

7.点击涂鸦按钮后，异步请求后台处理页面，请求地址携带参数为action=uploadscrawl

我们要实现的就是，根据每次请求的不同参数值，调用不同的方法进行处理，如下图所示，controller根据参数值，调用对应的处理程序进行处理：

image

处理逻辑其实很简单，就是将Request请求中的文件内容读取并写入到服务器上，然后构造特定的json返回值。

上传文件、图片、视频时，json格式如下：

  1. {  
  2.     "url": "20140703491416521462.png",   
  3.     "state": "SUCCESS",   
  4.     "error": "null",   
  5.     "original": "20140703491416521462.png",   
  6.     "title": "20140703491416521462.png"  
  7. }  

其中，url是文件在服务器的相对地址，这个地址会和json配置信息中的”xxxUrlPrefix”的值拼在一起，显示出来。

state是状态信息，成功的返回信息固定为SUCCESS，异常情况可自己定义。

error:异常信息，正常的话，为null

original:内部文件名，一般和titile相同。

title：文件名称。

在线文件、在线图片，json格式如下：

  1. {  
  2.     "state": "SUCCESS",  
  3.     "list": [  
  4.         {  
  5.             "url": "upload/image/20140627/6353948647502438222009315.png"  
  6.         },  
  7.         {  
  8.             "url": "upload/image/20140627/6353948659383617789875352.png"  
  9.         },  
  10.         {  
  11.             "url": "upload/image/20140701/6353980733328090063690725.png"  
  12.         },  
  13.         {  
  14.             "url": "upload/image/20140701/6353980745691597223366891.png"  
  15.         },  
  16.         {  
  17.             "url": "upload/image/20140701/6353980747586705613811538.png"  
  18.         },  
  19.         {  
  20.             "url": "upload/image/20140701/6353980823509548151892908.png"  
  21.         }  
  22.     ],  
  23.     "start": 0,  
  24.     "size": 20,  
  25.     "total": 6  
  26. }  

其中，start,是标志从第几张图片开始，个人感觉意义不大。

size:默认显示多少个文件、图片。

total:图片、文件总数量。

list:以数组形式列出图片、文件的相对地址。

 

这里，我实现了一个简单demo,可以实现文件、图片、视频的上传及在线图片、在线文件的功能。点击这里下载代码源码。

目前支持功能： 

 基本文字、排版等功能 

图片上传、文件上传、视频上传功能 

在线文件、在线图片功能

未实现功能：

涂鸦功能

网络图片功能

功能已在CentOS下，部署到nginx下，实测，可用。

使用方法： -----

1. 下载这里的完整代码，直接cd到根目录，运行

  1. python manage.py runserver 1989  

,可直接查看效果演示。

2. 在urls.py中将uEditor所在目录配置成静态文件路径，本demo中为UE    

  1. ( r'^UE/(?P<path>.*)$','django.views.static.serve', { 'document_root':os.path.dirname(__file__).replace('\\','/')+"/UE"}),  

  3. 将demo中ueconfig.json文件拷贝到自己项目的根目录中，并修改其中几处关键位置：   

  1.  将"imageUrlPrefix": "/upload/images/"修改为自己项目中图片上传后保存的位置，demo中是/upload/images/这个目录      
  2.   
  3.  将"scrawlUrlPrefix": "/upload/images/", 修改为自己项目中涂鸦       
  4.   
  5. "snapscreenUrlPrefix": "/upload/images/", 截图保存位置       
  6.   
  7. "catcherUrlPrefix": "/upload/images/", 网络图片保存位置       
  8.   
  9. "videoUrlPrefix": "/upload/vedio/"   视频文件保存地址      
  10.   
  11.  "fileUrlPrefix": "/upload/files/" 附件保存地址       
  12.   
  13. "imageManagerUrlPrefix": "/upload/onlineimages/", 在线图片所在位置，在线图片实际就是服务器为用户提供的可选图片      
  14.   
  15.  "fileManagerUrlPrefix": "/upload/onlinefiles/"  在线附件所在位置，在线附件实际就是服务器为用户提供的可选附件  

  4. json文件修改后，要把上面设置的路径设置为静态资源目录，例如demo中全部保存到/upload/的子目录下，那么在urls.py中配置如下：

  1. ( r'^upload/(?P<path>.*)$', 'django.views.static.serve',{ 'document_root': (os.path.dirname(__file__)+"/upload").replace('\\','/') }),  

之后，确保子目录是存在的，为了方便，程序里没有自动创建目录的方法，需要手工创建，例如demo中创建了images、vedio、 files、onlinefiles、onlineimages几个子目录

5. 将demo中的controller.py文件拷贝到项目中任意位置，其实controller就是一个异步处理的视图，拷贝完成后，在urls.py中配置相应的路由，demo中放到了根目录，所以配置如下：

  1. url(r'ueEditorControler','ueEditor_django.controller.handler')  

自己的项目中只需要将

  1. ueEditor_django.controller.handler  

改为

  1. xxxx.controller.handler  

即可

6. 配置工作最后一步，将”ueditor.config.js”文件的 

  1. , serverUrl: URL + "/net/controller.ashx"   

修改为

  1. , serverUrl: "/ueEditorControler"  

即上一步配置的url路由

至此，配置工作完成，剩下的就是到页面上引用uEditor了，下面是一个简单的html页面，可根据uEditor放置位置调整脚本 和样式的引用路径

  1. <!DOCTYPE html>  
  2. <html lang="en" xmlns="http://www.w3.org/1999/xhtml">  
  3. <head>  
  4.     <link rel="stylesheet" type="text/css" href="/UE/third-party/SyntaxHighlighter/shCoreDefault.css">  
  5. <script type="text/javascript" src="/UE/third-party/SyntaxHighlighter/shCore.js"></script>  
  6. <script type="text/javascript" charset="utf-8" src="/UE/ueditor.config.js"></script>  
  7. <script type="text/javascript" charset="utf-8" src="/UE/ueditor.all.min.js"> </script>  
  8. <script type="text/javascript" charset="utf-8" src="/UE/lang/zh-cn/zh-cn.js"></script>  
  9.   
  10. <script type="text/javascript">  
  11.     var ue = UE.getEditor('editor');  
  12.     SyntaxHighlighter.all();  
  13. </script>  
  14. </head>  
  15. <body>  
  16.     <script id="editor" type="text/plain" style="width:auto;height:500px;"></script>  
  17.     <input type="button" onclick="" value="保存"/>  
  18. </body>  
  19. </html>  

查看源代码，请到这里

posted @   风的姿态  阅读(9044)  评论(1)  编辑  收藏  举报
编辑推荐：
· 从 HTTP 原因短语缺失研究 HTTP/2 和 HTTP/3 的设计差异
· AI与.NET技术实操系列：向量存储与相似性搜索在 .NET 中的实现
· 基于Microsoft.Extensions.AI核心库实现RAG应用
· Linux系列：如何用heaptrack跟踪.NET程序的非托管内存泄露
· 开发者必知的日志记录最佳实践
阅读排行：
· TypeScript + Deepseek 打造卜卦网站：技术与玄学的结合
· Manus的开源复刻OpenManus初探
· 写一个简单的SQL生成工具
· AI 智能体引爆开源社区「GitHub 热点速览」
· C#/.NET/.NET Core技术前沿周刊 | 第 29 期（2025年3.1-3.9）
点击右上角即可分享
微信分享提示