springboot+layui 整合百度富文本编辑器ueditor入门使用教程(踩过的坑)

虚幻大学 xuhss 172℃ 0评论

? 优质资源分享 ?

学习路线指引(点击解锁) 知识定位 人群定位
? Python实战微信订餐小程序 ? 进阶级 本课程是python flask+微信小程序的完美结合,从项目搭建到腾讯云部署上线,打造一个全栈订餐系统。
?Python量化交易实战? 入门级 手把手带你打造一个易扩展、更安全、效率更高的量化交易系统

springboot+layui 整合百度富文本编辑器ueditor入门使用教程(踩过的坑)

写在前面:

​ 富文本编辑器,Multi-function Text Editor, 简称 MTE, 是一种可内嵌于浏览器,所见即所得的文本编辑器

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

效果如图:

183cb2609707dfadda2aacca3e768c5e - springboot+layui 整合百度富文本编辑器ueditor入门使用教程(踩过的坑)

01 首先去官网下载ueditor包

官方网址:http://fex.baidu.com/ueditor/#start-start(下载jsp版本就可以)

877dd328bb23460eeb7e95bf420a4169 - springboot+layui 整合百度富文本编辑器ueditor入门使用教程(踩过的坑)

02 解压

你会看到这样的界面:

64905bbc73c81f815a24efc98720efeb - springboot+layui 整合百度富文本编辑器ueditor入门使用教程(踩过的坑)

​ dialogs:弹出对话框对应的资源和JS文件
​ lang:编辑器国际化显示的文件
​ themes:样式图片和样式文件
​ php/jsp/.net:涉及到服务器端操作的后台文件,根据你选择的不同后台版本,这里也会不同,这里我们选择jsp
​ third-party:第三方插件(包括代码高亮,源码编辑等组件)
​ index.html:源码文件,用于演示完整的界面
​ ueditor.all.js:开发版代码合并的结果,目录下所有文件的打包文件
​ ueditor.all.min.js:ueditor.all.js文件的压缩版,建议在正式部署时采用
​ ueditor.config.js:编辑器的配置文件,建议和编辑器实例化页面置于同一目录
​ ueditor.parse.js:编辑的内容显示页面引用,会自动加载表格、列表、代码高亮等样式
​ ueditor.all.min.js:ueditor.parse.js文件的压缩版,建议在内容展示页正式部署时采用

03 写个小demo测试一下(layui)

第一步、把解压后的文件夹整个放到springboot项目中的static目录下

8437905718d9fdbbbf6e9b2e4b27a1b9 - springboot+layui 整合百度富文本编辑器ueditor入门使用教程(踩过的坑)

第二步、放入示例代码

testLayui_Ueditor.html

html>
<html>
<head>
    <title>layui ueditortitle>
    <meta charset="utf-8">
    <link rel="stylesheet" href="https://www.layuicdn.com/layui-v2.5.5/css/layui.css">
    <script src="https://www.layuicdn.com/layui-v2.5.5/layui.js">script>
    <style>
 .box {
 width: 60%;
 margin: 60px auto;
 }
 style>
head>
<body>

<form class="box" action="">
    <div class="layui-form-item">
        <label class="layui-form-label">标题label>
        <div class="layui-input-block">
            <input type="text" name="title" class="layui-input">
        div>
    div>
    <div class="layui-form-item layui-form-text">
        <label class="layui-form-label">内容label>
        <div class="layui-input-block">
            <textarea id="container" name="content">textarea>
        div>
    div>
    <div class="layui-form-item">
        <div class="layui-input-block">
            <button class="layui-btn" lay-submit lay-filter="formDemo">立即提交button>
            <button type="reset" class="layui-btn layui-btn-primary">重置button>
        div>
    div>
form>

<script type="text/javascript" src="../../../../../static/UEditor/ueditor.config.js">script>

<script type="text/javascript" src="../../../../../static/UEditor/ueditor.all.js">script>
<script type="text/javascript" src="../../../../../static/UEditor/lang/zh-cn/zh-cn.js">script>
<script>
 layui.use('form', function(){
 var form = layui.form;
 // 实例化编辑器
 var ue = UE.getEditor('container');
 // var content = ue.getContent();
 // console.log(content)
 //监听提交
 form.on('submit(formDemo)', function(data){
 console.log(data.field)
 return false;
 });
 });
script>
body>
html>

几个注意的点:

  1. 注意引入正确的layui.css和layui.js
  2. 引入ueditor需要的js文件,注意引入顺序必须为 .config 在前,之后 .all,其他的js文件可以引也可以不引,不引入也会自动调用到,主要是config和all,要按先后顺序引入!
  3. 实例化编辑器:

var ue = UE.getEditor('container'); //此处放的是id

小结

这个文件直接使用浏览器打开就是可以看到如下图的效果的。

但是注意,这里引入js文件的路径为完整的路径

855a9f3e5dde5076a80d76f03d4625ed - springboot+layui 整合百度富文本编辑器ueditor入门使用教程(踩过的坑)

04 整合到springboot项目中

基本步骤和上述静态整合类似,只不过上面的只需要打开静态html页面就可以看到效果了,而下面我们要做的是把ueditor整合到整个项目里,也就是说要在项目运行之后,加载页面。

第一步 还是把整个解压缩的文件放到static目录下

第二步 整合html页

  1. 首先引入js文件

这里有个坑需要注意!

因为Springboot默认的静态资源路径为static,我们不需要再添加/static/前缀,所以需要使用正确的方式来引用,否则就会导致404的问题。

也就是说如果我们的路径中多写了static,使用相对路径来获取js文件,可能会找不到。

例如:../static/UEditor/ueditor.all.js

  • 推荐使用thymeleaf方式(从static的下一个目录开始写相对路径!
<html xmlns:th="http://www.thymeleaf.org" >
<script type="text/javascript" th:src="@{/UEditor/ueditor.config.js}">script>
<script type="text/javascript" th:src="@{/UEditor/ueditor.all.js}">script>
  1. 然后把ueditor放在你需要放的地方(一般是textarea)

例如:

<div class="layui-input-block">
    <textarea id='container' name='text' >textarea>
div>
  1. 实例化

 <span class="hljs-keyword">if</span>(<span class="hljs-variable language\_">document</span>.<span class="hljs-title function\_">getElementById</span>(<span class="hljs-string">'container'</span>)!=<span class="hljs-literal">null</span>){
 <span class="hljs-keyword">var</span> ue = <span class="hljs-variable constant\_">UE</span>.<span class="hljs-title function\_">getEditor</span>(<span class="hljs-string">'container'</span>);
 }
 ue.<span class="hljs-title function\_">ready</span>(<span class="hljs-keyword">function</span>(<span class="hljs-params"></span>) {
 ue.<span class="hljs-title function\_">setHeight</span>(<span class="hljs-number">400</span>);
 <span class="hljs-keyword">var</span> html = ue.<span class="hljs-title function\_">getContent</span>();
 <span class="hljs-variable language\_">console</span>.<span class="hljs-title function\_">log</span>(<span class="hljs-string">"正文部分:"</span>+html)
 })

最关键的一步

!!!!!!

注意看

如果按上面的步骤跑了一遍,会发现还是会失败,因为静态加载和运行项目之后的加载,ueditor的运行状态是不一样的,下面我介绍一下ueditor大概是怎么跑起来的。

首先 当我们静态加载这个插件的时候,会发现路径大概是这个样子的:也就是我们可以看到localhost开始一直后面跟的是项目的完整路径!

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-oXFbkOiY-1654922957652)(springboot+layui 整合百度富文本编辑器ueditor使用教程(踩过的坑)/image-20220610232118981.png)]

那么这个插件我们只引入了两个js文件,那其他的文件是怎么运行的呢?

我们可以打开其中的 config.js 文件一探究竟!

ef0652d5eccc7e526488e2dc3325b301 - springboot+layui 整合百度富文本编辑器ueditor入门使用教程(踩过的坑)

所以我们不难发现,这个插件大概是这么运行的:

  1. 加载两个引入的js文件,通过js文件获取其他文件的访问路径,例如jsp文件夹、css文件等等。
  2. 通过路径访问加载其他文件,完成整个插件的部署配置!

下面我们打开jsp文件夹看看:

d9049249061ee7983e9860b91bad5b02 - springboot+layui 整合百度富文本编辑器ueditor入门使用教程(踩过的坑)

b8fd1e52550a5d284cefc37d6420e178 - springboot+layui 整合百度富文本编辑器ueditor入门使用教程(踩过的坑)

36bb83f15a0681bc1a90ba9ff815af0f - springboot+layui 整合百度富文本编辑器ueditor入门使用教程(踩过的坑)

虽然我没太看懂这些是啥,但是我大概可以猜到,这个文件可能和我们上面分析的调用其他资源有关系

下面我们来验证一下这个猜想,我们还是用静态的方式先看一下:

F12打开调试可以看到

817e493148ced49e67aa51e09be5b749 - springboot+layui 整合百度富文本编辑器ueditor入门使用教程(踩过的坑)

所以我们大致可以确定,其他文件需要通过这个jsp文件完成调度。


好了,讲完了上面的过程,下面我们分析一下,静态的和动态的有什么区别,也就是项目跑没跑到底为什么会影响ueditor的加载呢?

其实道理很简单,问题就出在访问的路径上!

静态的方式,访问路径是固定的本地路径,所以不存在配置问题,但是当你项目跑起来了,比如springboot项目是存在项目的路径的,而这个项目的路径,如果你不去告诉ueditor,它是不清楚在哪里的,所以也就没办法去用jsp调用其他资源了!

下面两张图告诉你区别:可以看到同样的 jsp?,但是前面是不一样的,这也就导致了如果不去配置前面的路径,ueditor的其他资源必然是找不到的!

  1. 静态页面

http://localhost:63342/science/static/UEditor/jsp/controller.jsp?action=config&&noCache=1654874890533

  1. 项目跑起来之后的访问路径

http://169.254.208.81:8008/UEditor/jsp/controller.jsp?action=config&&noCache=1654875217963

433fe80f426433b3d469946cbd46782a - springboot+layui 整合百度富文本编辑器ueditor入门使用教程(踩过的坑)

ueditor为我们提供了一种很方便的方式来配置这个路径,只需要在你引用了插件的html文件的最开头加上这样一句话:

"text/javascript"</span>>
 <span class="hljs-variable language\_">window</span>.<span class="hljs-property">UEDITOR\_HOME\_URL</span> = <span class="hljs-string">"http://169.254.208.81:8008/UEditor/"</span>;

之后再次运行项目可以看到ueditor正常显示!好了,分享完毕,希望对大家有帮助!

转载请注明:xuhss » springboot+layui 整合百度富文本编辑器ueditor入门使用教程(踩过的坑)

喜欢 (0)

您必须 登录 才能发表评论!