草庐IT

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

靠谱杨 2023-03-28 原文

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

写在前面：

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

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

效果如图：

01 首先去官网下载ueditor包

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

02 解压

你会看到这样的界面：

​ 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目录下

第二步、放入示例代码

testLayui_Ueditor.html

<!DOCTYPE html>
<html>
<head>
    <title>layui ueditor</title>
    <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文件的路径为完整的路径

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. 实例化
<script>
    if(document.getElementById('container')!=null){
        var ue = UE.getEditor('container');
    }
    ue.ready(function() {
        ue.setHeight(400);
        var html = ue.getContent();
        console.log("正文部分："+html)
    })
</script>

最关键的一步

！！！！！！

注意看

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

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

![image-20220610232118981](springboot+layui 整合百度富文本编辑器ueditor使用教程（踩过的坑）/image-20220610232118981.png)

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

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

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

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

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

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

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

F12打开调试可以看到

所以我们大致可以确定，其他文件需要通过这个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

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

<script type="text/javascript">
    window.UEDITOR_HOME_URL = "http://169.254.208.81:8008/UEditor/";
</script>

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

富文springbootueditorgtltHtml/Css

有关springboot+layui 整合百度富文本编辑器ueditor入门使用教程（踩过的坑）的更多相关文章

  1. ruby - 如何使用 Nokogiri 的 xpath 和 at_xpath 方法 - 2

    我正在学习如何使用Nokogiri，根据这段代码我遇到了一些问题:require'rubygems'require'mechanize'post_agent=WWW::Mechanize.newpost_page=post_agent.get('http://www.vbulletin.org/forum/showthread.php?t=230708')puts"\nabsolutepathwithtbodygivesnil"putspost_page.parser.xpath('/html/body/div/div/div/div/div/table/tbody/tr/td/div

  2. ruby - 使用 RubyZip 生成 ZIP 文件时设置压缩级别 - 2

    我有一个Ruby程序，它使用rubyzip压缩XML文件的目录树。gem。我的问题是文件开始变得很重，我想提高压缩级别，因为压缩时间不是问题。我在rubyzipdocumentation中找不到一种为创建的ZIP文件指定压缩级别的方法。有人知道如何更改此设置吗？是否有另一个允许指定压缩级别的Ruby库？ 最佳答案 这是我通过查看ruby​​zip内部创建的代码。level=Zlib::BEST_COMPRESSIONZip::ZipOutputStream.open(zip_file)do|zip|Dir.glob("**/*")d

  3. ruby - 为什么我可以在 Ruby 中使用 Object#send 访问私有(private)/ protected 方法？ - 2

    类classAprivatedeffooputs:fooendpublicdefbarputs:barendprivatedefzimputs:zimendprotecteddefdibputs:dibendendA的实例a=A.new测试a.foorescueputs:faila.barrescueputs:faila.zimrescueputs:faila.dibrescueputs:faila.gazrescueputs:fail测试输出failbarfailfailfail.发送测试[:foo,:bar,:zim,:dib,:gaz].each{|m|a.send(m)resc

  4. ruby-on-rails - 使用 Ruby on Rails 进行自动化测试 - 最佳实践 - 2

    很好奇，就使用ruby​​onrails自动化单元测试而言，你们正在做什么？您是否创建了一个脚本来在cron中运行rake作业并将结果邮寄给您？git中的预提交Hook？只是手动调用？我完全理解测试，但想知道在错误发生之前捕获错误的最佳实践是什么。让我们理所当然地认为测试本身是完美无缺的，并且可以正常工作。下一步是什么以确保他们在正确的时间将可能有害的结果传达给您？ 最佳答案 不确定您到底想听什么，但是有几个级别的自动代码库控制:在处理某项功能时，您可以使用类似autotest的内容获得关于哪些有效，哪些无效的即时反馈。要确保您的提

  5. ruby - 在 Ruby 中使用匿名模块 - 2

    假设我做了一个模块如下:m=Module.newdoclassCendend三个问题:除了对m的引用之外，还有什么方法可以访问C和m中的其他内容？我可以在创建匿名模块后为其命名吗(就像我输入“module...”一样)？如何在使用完匿名模块后将其删除，使其定义的常量不再存在？ 最佳答案 三个答案:是的，使用ObjectSpace.此代码使c引用你的类(class)C不引用m:c=nilObjectSpace.each_object{|obj|c=objif(Class===objandobj.name=~/::C$/)}当然这取决于

  6. ruby - 使用 ruby​​ 和 savon 的 SOAP 服务 - 2

    我正在尝试使用ruby​​和Savon来使用网络服务。测试服务为http://www.webservicex.net/WS/WSDetails.aspx?WSID=9&CATID=2require'rubygems'require'savon'client=Savon::Client.new"http://www.webservicex.net/stockquote.asmx?WSDL"client.get_quotedo|soap|soap.body={:symbol=>"AAPL"}end返回SOAP异常。检查soap信封，在我看来soap请求没有正确的命名空间。任何人都可以建议我

  7. python - 如何使用 Ruby 或 Python 创建一系列高音调和低音调的蜂鸣声？ - 2

    关闭。这个问题是opinion-based.它目前不接受答案。想要改进这个问题？更新问题，以便editingthispost可以用事实和引用来回答它.关闭4年前。Improvethisquestion我想在固定时间创建一系列低音和高音调的哔哔声。例如:在150毫秒时发出高音调的蜂鸣声在151毫秒时发出低音调的蜂鸣声200毫秒时发出低音调的蜂鸣声250毫秒的高音调蜂鸣声有没有办法在Ruby或Python中做到这一点？我真的不在乎输出编码是什么(.wav、.mp3、.ogg等等)，但我确实想创建一个输出文件。

  8. ruby-on-rails - 'compass watch' 是如何工作的/它是如何与 rails 一起使用的 - 2

    我在我的项目目录中完成了compasscreate.和compassinitrails。几个问题:我已将我的.sass文件放在public/stylesheets中。这是放置它们的正确位置吗？当我运行compasswatch时，它不会自动编译这些.sass文件。我必须手动指定文件:compasswatchpublic/stylesheets/myfile.sass等。如何让它自动运行？文件ie.css、print.css和screen.css已放在stylesheets/compiled。如何在编译后不让它们重新出现的情况下删除它们？我自己编译的.sass文件编译成compiled/t

  9. ruby - 使用 ruby​​ 将 HTML 转换为纯文本并维护结构/格式 - 2

    我想将html转换为纯文本。不过，我不想只删除标签，我想智能地保留尽可能多的格式。为插入换行符标签，检测段落并格式化它们等。输入非常简单，通常是格式良好的html(不是整个文档，只是一堆内容，通常没有anchor或图像)。我可以将几个正则表达式放在一起，让我达到80%，但我认为可能有一些现有的解决方案更智能。 最佳答案 首先，不要尝试为此使用正则表达式。很有可能你会想出一个脆弱/脆弱的解决方案，它会随着HTML的变化而崩溃，或者很难管理和维护。您可以使用Nokogiri快速解析HTML并提取文本:require'nokogiri'h

  10. ruby - 在 64 位 Snow Leopard 上使用 rvm、postgres 9.0、ruby 1.9.2-p136 安装 pg gem 时出现问题 - 2

    我想为Heroku构建一个Rails3应用程序。他们使用Postgres作为他们的数据库，所以我通过MacPorts安装了postgres9.0。现在我需要一个postgresgem并且共识是出于性能原因你想要pggem。但是我对我得到的错误感到非常困惑当我尝试在rvm下通过geminstall安装pg时。我已经非常明确地指定了所有postgres目录的位置可以找到但仍然无法完成安装:$envARCHFLAGS='-archx86_64'geminstallpg--\--with-pg-config=/opt/local/var/db/postgresql90/defaultdb/po

随机推荐