vue+ueditor百度富文本框的前后端配置以及相关bug解决方法

迷南。 2023-07-15 01:47 2阅读 0赞

# 前端配置 #

在`vue`中使用`ueditor`，可以用已经封装好的**`vue-ueditor-wrap`**，配置简单，功能也是十分强大

## 安装依赖包 ##

**npm i vue-ueditor-wrap**

## 下载`ueditor` ##

将下载好的`ueditor`解压至项目`static`目录

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM5MTY3OTM0_size_16_color_FFFFFF_t_70][]

## 引入`VueUeditorWrap`组件 ##

**//可全局引入也可局部引入**

**import VueUeditorWrap from 'vue-ueditor-wrap';**

**components: \{ VueUeditorWrap, \}**

## 绑定数据并修改`VueUeditorWrap`配置 ##

**<vue-ueditor-wrap v-model="contents" :config="myConfig"></vue-ueditor-wrap>**

**data () \{**

**return \{**

**contents: '<h2>Vue + UEditor + v-model双向绑定</h2>',**

**myConfig: \{**

**autoHeightEnabled: false,// 编辑器不自动被内容撑高**

**initialFrameHeight: 240,// 初始容器高度**

**initialFrameWidth: '100%',// 初始容器宽度**

**serverUrl: 'http://35.201.165.105:8000/controller.php',// 上传文件接口**

**UEDITOR\_HOME\_URL: '/UEditor/'**** , // UEditor 资源文件的存放路径**

# 后端配置 #

如果服务器网站是`php`、`jsp`、`asp`搭建的，百度提供了`demo`，请自行参考ueditor文档[http://fex.baidu.com/ueditor/][http_fex.baidu.com_ueditor]

如果用python，参考**`DjangoUeditor3`**定制属于我们自己的`ueditor`服务端接口

我们来打开`DjangoUeditor3`的仓库https://github.com/twz915/DjangoUeditor3，

## 拷贝项目源码 ##

### 新建视图 ###

新建我们的`ueditor`视图接口`ueditor_view.py`

拷贝仓库中的`DjangoUeditor3/DjangoUeditor/views.py`文件内容到`ueditor_view.py`

### 新建配置文件 ###

视图中引用了自己的一个`setting`，包含自己`ueditor`上传的一些设置，我们也一起拿过来

在我们当前应用中创建`settings.py`

`DjangoUeditor3/DjangoUeditor/settings.py`复制到其中

### 创建接口`url` ###

<table> 
 <tbody> 
  <tr> 
   <td> <pre><code>1
2
</code></pre> </td> 
   <td> <pre><code>from app.ueditorviews import get_ueditor_controller
path('controller',get_ueditor_controller)
</code></pre> </td> 
  </tr> 
 </tbody> 
</table>

`get_ueditor_controller`就是我们的入口

## 连接前端`vue` ##

将[`vue`使用`ueditor`前端配置][vue_ueditor]中的`serverUrl`配置为我们刚才的接口地址，我这里都在本地测试，端口不同

<table> 
 <tbody> 
  <tr> 
   <td> <pre><code>1
</code></pre> </td> 
   <td> <pre><code>serverUrl: 'http://localhost:8000/controller',
</code></pre> </td> 
  </tr> 
 </tbody> 
</table>

### 初试接口 ###

点击上传图片无反应

默认请求接口带了一个`action`和`callback`的参数，200接口访问成功，但是却没有取回任何数据，观察下之前我们用到的测试服务接口，是有返回数据的，对方是用的`php`，我们来看下`ueditor_view.py`源码

控制台也打印了如下：

<table> 
 <tbody> 
  <tr> 
   <td> <pre><code>1
</code></pre> </td> 
   <td> <pre><code>Cross-Origin Read Blocking (CORB) blocked cross-origin response http://localhost:8000/controller?action=config&amp;callback=bd__editor__ve7qge with MIME type text/html. See https://www.chromestatus.com/feature/5629709824032768 for more details.
</code></pre> </td> 
  </tr> 
 </tbody> 
</table>

<table> 
 <tbody> 
  <tr> 
   <td> <pre><code>1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
</code></pre> </td> 
   <td> <pre><code>@csrf_exempt
def get_ueditor_controller(request):
    """获取ueditor的后端URL地址"""
    action = request.GET.get("action", "")
    reponseAction = {
        "config": get_ueditor_settings,
        "uploadimage": UploadFile,
        "uploadscrawl": UploadFile,
        "uploadvideo": UploadFile,
        "uploadfile": UploadFile,
        "catchimage": catcher_remote_image,
        "listimage": list_files,
        "listfile": list_files
    }
    return reponseAction[action](request)
</code></pre> </td> 
  </tr> 
 </tbody> 
</table>

可以看出来做了一个类似反射的东西，初始连接带了`action`参数为`config`，所以对应的把我们给踢到`get_ueditor_settings`方法中了，继续跟进到这个方法

<table> 
 <tbody> 
  <tr> 
   <td> <pre><code>1
2
3
4
5
6
</code></pre> </td> 
   <td> <pre><code>@csrf_exempt
def get_ueditor_settings(request):
    json_data = json.dumps(
        USettings.UEditorUploadSettings,
        ensure_ascii=False)
    return HttpResponse(json_data, content_type="application/javascript")
</code></pre> </td> 
  </tr> 
 </tbody> 
</table>

我们来打印下`json_data`

<table> 
 <tbody> 
  <tr> 
   <td> <pre><code>1
</code></pre> </td> 
   <td> <pre><code>{"imageActionName": "uploadimage", "imageMaxSize": 10485760, "imageFieldName": "upfile", "imageUrlPrefix": "http://localhost:8000", "imagePathFormat": "", "imageAllowFiles": [".png", ".jpg", ".jpeg", ".gif", ".bmp"], "scrawlActionName": "uploadscrawl", "scrawlFieldName": "upfile", "scrawlMaxSize": 10485760, "scrawlUrlPrefix": "", "scrawlPathFormat": "", "snapscreenActionName": "uploadimage", "snapscreenPathFormat": "", "snapscreenUrlPrefix": "", "catcherLocalDomain": ["127.0.0.1", "localhost", "img.baidu.com"], "catcherPathFormat": "", "catcherActionName": "catchimage", "catcherFieldName": "source", "catcherMaxSize": 10485760, "catcherAllowFiles": [".png", ".jpg", ".jpeg", ".gif", ".bmp"], "catcherUrlPrefix": "", "videoActionName": "uploadvideo", "videoPathFormat": "", "videoFieldName": "upfile", "videoMaxSize": 102400000, "videoUrlPrefix": "", "videoAllowFiles": [".flv", ".swf", ".mkv", ".avi", ".rm", ".rmvb", ".mpeg", ".mpg", ".ogg", ".ogv", ".mov", ".wmv", ".mp4", ".webm", ".mp3", ".wav", ".mid"], "fileActionName": "uploadfile", "filePathFormat": "", "fileFieldName": "upfile", "fileMaxSize": 204800000, "fileUrlPrefix": "", "fileAllowFiles": [".png", ".jpg", ".jpeg", ".gif", ".bmp", ".flv", ".swf", ".mkv", ".avi", ".rm", ".rmvb", ".mpeg", ".mpg", ".ogg", ".ogv", ".mov", ".wmv", ".mp4", ".webm", ".mp3", ".wav", ".mid", ".rar", ".zip", ".tar", ".gz", ".7z", ".bz2", ".cab", ".iso", ".doc", ".docx", ".xls", ".xlsx", ".ppt", ".pptx", ".pdf", ".txt", ".md", ".xml"], "imageManagerActionName": "listimage", "imageManagerListPath": "", "imageManagerListSize": 30, "imageManagerAllowFiles": [".png", ".jpg", ".jpeg", ".gif", ".bmp"], "imageManagerUrlPrefix": "", "fileManagerActionName": "listfile", "fileManagerListPath": "", "fileManagerUrlPrefix": "", "fileManagerListSize": 30, "fileManagerAllowFiles": [".png", ".jpg", ".jpeg", ".gif", ".bmp", ".tif", ".psd.flv", ".swf", ".mkv", ".avi", ".rm", ".rmvb", ".mpeg", ".mpg", ".ogg", ".ogv", ".mov", ".wmv", ".mp4", ".webm", ".mp3", ".wav", ".mid", ".rar", ".zip", ".tar", ".gz", ".7z", ".bz2", ".cab", ".iso", ".doc", ".docx", ".xls", ".xlsx", ".ppt", ".pptx", ".pdf", ".txt", ".md", ".xml", ".exe", ".com", ".dll", ".msi"]}
</code></pre> </td> 
  </tr> 
 </tbody> 
</table>

有返回数据，可以前台没有响应，再仔细观察下除了`action`还带了一个`callback`参数，我们还没用到，刷新发下，这个`callback`的值每次还随机变动，跟原示例返回值比较下，外层少了一个`callback()`,我们简单来组装下这个参数。

<table> 
 <tbody> 
  <tr> 
   <td> <pre><code>1
2
</code></pre> </td> 
   <td> <pre><code>callback = request.GET.get('callback')
json_data = '%s(%s)' % (callback,json_data)
</code></pre> </td> 
  </tr> 
 </tbody> 
</table>

再次测试，控制台没有警告了，且我们也取到返回值了

<table> 
 <tbody> 
  <tr> 
   <td> <pre><code>1
</code></pre> </td> 
   <td> <pre><code>bd__editor__dzdteh({"imageActionName": "uploadimage", "imageMaxSize": 10485760, "imageFieldName": "upfile", "imageUrlPrefix": "http://localhost:8000", "imagePathFormat": "", "imageAllowFiles": [".png", ".jpg", ".jpeg", ".gif", ".bmp"], "scrawlActionName": "uploadscrawl", "scrawlFieldName": "upfile", "scrawlMaxSize": 10485760, "scrawlUrlPrefix": "", "scrawlPathFormat": "", "snapscreenActionName": "uploadimage", "snapscreenPathFormat": "", "snapscreenUrlPrefix": "", "catcherLocalDomain": ["127.0.0.1", "localhost", "img.baidu.com"], "catcherPathFormat": "", "catcherActionName": "catchimage", "catcherFieldName": "source", "catcherMaxSize": 10485760, "catcherAllowFiles": [".png", ".jpg", ".jpeg", ".gif", ".bmp"], "catcherUrlPrefix": "", "videoActionName": "uploadvideo", "videoPathFormat": "", "videoFieldName": "upfile", "videoMaxSize": 102400000, "videoUrlPrefix": "", "videoAllowFiles": [".flv", ".swf", ".mkv", ".avi", ".rm", ".rmvb", ".mpeg", ".mpg", ".ogg", ".ogv", ".mov", ".wmv", ".mp4", ".webm", ".mp3", ".wav", ".mid"], "fileActionName": "uploadfile", "filePathFormat": "", "fileFieldName": "upfile", "fileMaxSize": 204800000, "fileUrlPrefix": "", "fileAllowFiles": [".png", ".jpg", ".jpeg", ".gif", ".bmp", ".flv", ".swf", ".mkv", ".avi", ".rm", ".rmvb", ".mpeg", ".mpg", ".ogg", ".ogv", ".mov", ".wmv", ".mp4", ".webm", ".mp3", ".wav", ".mid", ".rar", ".zip", ".tar", ".gz", ".7z", ".bz2", ".cab", ".iso", ".doc", ".docx", ".xls", ".xlsx", ".ppt", ".pptx", ".pdf", ".txt", ".md", ".xml"], "imageManagerActionName": "listimage", "imageManagerListPath": "", "imageManagerListSize": 30, "imageManagerAllowFiles": [".png", ".jpg", ".jpeg", ".gif", ".bmp"], "imageManagerUrlPrefix": "", "fileManagerActionName": "listfile", "fileManagerListPath": "", "fileManagerUrlPrefix": "", "fileManagerListSize": 30, "fileManagerAllowFiles": [".png", ".jpg", ".jpeg", ".gif", ".bmp", ".tif", ".psd.flv", ".swf", ".mkv", ".avi", ".rm", ".rmvb", ".mpeg", ".mpg", ".ogg", ".ogv", ".mov", ".wmv", ".mp4", ".webm", ".mp3", ".wav", ".mid", ".rar", ".zip", ".tar", ".gz", ".7z", ".bz2", ".cab", ".iso", ".doc", ".docx", ".xls", ".xlsx", ".ppt", ".pptx", ".pdf", ".txt", ".md", ".xml", ".exe", ".com", ".dll", ".msi"]})
</code></pre> </td> 
  </tr> 
 </tbody> 
</table>

测试单图片上传，应该大多数人已经可以成功上传了。

**图片上传成功，却提示上传错误，不显示图片**

这部分都是跨域问题，解决办法如下：`UploadFile`函数返回值做修改，添加一个`header`即可。

<table> 
 <tbody> 
  <tr> 
   <td> <pre><code>1
2
3
</code></pre> </td> 
   <td> <pre><code>response = HttpResponse(json.dumps(return_info, ensure_ascii=False))
response['Access-Control-Allow-Headers'] = '*'
return response
</code></pre> </td> 
  </tr> 
 </tbody> 
</table>

### 测试多图片 ###

点击上传多张图片按钮会出现以下提示：

控制台：

<table> 
 <tbody> 
  <tr> 
   <td> <pre><code>1
</code></pre> </td> 
   <td> <pre><code>Access to XMLHttpRequest at 'http://localhost:8000/controller?action=uploadimage&amp;encode=utf-8' from origin 'http://localhost:8080' has been blocked by CORS policy: Request header field x_requested_with is not allowed by Access-Control-Allow-Headers in preflight response.
</code></pre> </td> 
  </tr> 
 </tbody> 
</table>

图片上传失败；跨域问题；而且访问接口请求成功200，请求方法却是`options`以前没有用到过该方法，百度查了下，大概意思是说这个浏览器自己发的，先试探下服务器允不允许。我在`ueditor_view`入口函数包括上传函数中都打印请求，很显然什么也没打印出来，真是不知道这个`options`方法会走到程序的哪里，甚至打算将这个视图写成`cbv`，走走`options`函数试试。

后来想到初始使用`vue`连`django`时也出现了该提示，详见：[Access-Control-Allow-Origin跨域问题][Access-Control-Allow-Origin]，当时用的是

`django-cors-headers`，按照文中内容配置好

主要配置：

<table> 
 <tbody> 
  <tr> 
   <td> <pre><code>1
2
3
</code></pre> </td> 
   <td> <pre><code>CORS_ALLOW_HEADERS = [
    'x-requested-with',
]
</code></pre> </td> 
  </tr> 
 </tbody> 
</table>

测试多图片上传，完美

### 后端配置遇到问题： ###

**在本地调试需带上`callback`参数，服务器上则需要去掉`callback`参数**

### **前端富文本隐藏问题：** ###

**1.ueditor图片和图片调节框错位**

可以通过修改ueditor.all.js的代码来实现调节框位置与图片位置一致。如下  
原代码17097行：

‘top’: iframePos.y + imgPos.y - me.editor.document.**body**.scrollTop - editorPos.y - parseInt(resizer.style.borderTopWidth) + ‘px’；  
修改为：

‘top’: iframePos.y + imgPos.y - me.editor.document.**documentElement**.scrollTop - editorPos.y - parseInt(resizer.style.borderTopWidth) + ‘px’；

**2.如何隐藏图片调节框**

直接在css文件里设置  
\#edui1\_imagescale\{display:none !important;\} /*去除点击图片后出现的拉伸边框*/

**3.视频无法播放，格式被自动存为gif**

修改ueditor.all.js文件

ueditor.all.js，17769行

html.push(creatInsertStr( vi.url, vi.width || 420,  vi.height || 280, id + i, null, cl, '**image**'));

修改为

html.push(creatInsertStr( vi.url, vi.width || 420,  vi.height || 280, id + i, null, cl, '**video**'));

7343,7344,7346行，注释掉一下三行代码：

var root = UE.htmlparser(html);

me.filterInputRule(root);

html = root.toHtml();

参考文章：[https://www.diandian100.cn/9923e2ee.html][https_www.diandian100.cn_9923e2ee.html]

参考文章：[https://blog.csdn.net/qq\_35405240/article/details/82786590][https_blog.csdn.net_qq_35405240_article_details_82786590]

参考文章：[https://blog.csdn.net/eadela/article/details/76264168][https_blog.csdn.net_eadela_article_details_76264168]

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM5MTY3OTM0_size_16_color_FFFFFF_t_70]: /images/20230529/ddca0304849f4b36a798d0735b0c7a1e.png
[http_fex.baidu.com_ueditor]: http://fex.baidu.com/ueditor/
[vue_ueditor]: https://www.diandian100.cn/574181d3.html
[Access-Control-Allow-Origin]: https://www.diandian100.cn/807b7587.html
[https_www.diandian100.cn_9923e2ee.html]: https://www.diandian100.cn/9923e2ee.html
[https_blog.csdn.net_qq_35405240_article_details_82786590]: https://blog.csdn.net/qq_35405240/article/details/82786590
[https_blog.csdn.net_eadela_article_details_76264168]: https://blog.csdn.net/eadela/article/details/76264168