解决thymeleaf严格html5校验的方法

本文介绍如何在Spring应用中使用Thymeleaf模板引擎时禁用严格的HTML语法校验,通过添加特定依赖及配置项实现更灵活的HTML处理。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

在spring中使用thymeleaf的时候,会对html进行严格的语法校验,实际并没有什么必要,如下是解决方法:

1 在pom.xml文件中添加如下依赖:

<dependency>
   <groupId>net.sourceforge.nekohtml</groupId>
   <artifactId>nekohtml</artifactId>
   <version>1.9.21</version>
</dependency>

在application.properties中添加如下属性

spring.thymeleaf.mode=LEGACYHTML5

 

设置解析器参数   为了更加精确的控制解析的动作,nekohtml提供了相应的设置函数。如下列: // settings on HTMLConfiguration org.apache.xerces.xni.parser.XMLParserConfiguration config = new org.cyberneko.html.HTMLConfiguration(); config.setFeature("http://cyberneko.org/html/features/augmentations", true); config.setProperty("http://cyberneko.org/html/properties/names/elems", "lower"); // settings on DOMParser org.cyberneko.html.parsers.DOMParser parser = new org.cyberneko.html.parsers.DOMParser(); parser.setFeature("http://cyberneko.org/html/features/augmentations", true); parser.setProperty("http://cyberneko.org/html/properties/names/elems", "lower");nekohtml功能(feature)列表 功能 默认值 描述 http://cyberneko.org/html/features/balance-tags True 是否允许增补缺失的标签。如果要以XML方式操作HTML文件,此值必须为真。此处提供设置功能,为了性能的原因。 http://cyberneko.org/html/features/balance-tags/ignore-outside-content False 是否忽略文档根元素以后的数据。如果为false,<html>和<bod>被忽略,所有的内容都被解析。 http://cyberneko.org/html/features/document-fragment False 解析HTML片段时是否作标签增补。此功能不要用在DOMParser上,而要用在DOMFragmentParser上。 http://apache.org/xml/features/scanner/notify-char-refs False 当遇到字符实体引用(如&#x20;)是否将(#x20)报告给相应地文档处理器。 http://apache.org/xml/features/scanner/notify-builtin-refs False 当遇到XML内建的字符实体引用(如&amp;)是否将(amp)报告给相应地文档处理器。 http://cyberneko.org/html/features/scanner/notify-builtin-refs False 当遇到HTML内建的字符实体引用(如&copy;)是否将(copy)报告给相应地文档处理器。 http://cyberneko.org/html/features/scanner/script/strip-comment-delims False 是否剥掉<script>元素中的<!-- -->等注释符。 http://cyberneko.org/html/features/augmentations False 是否将与HTML事件有关的infoset项包括在解析管道中。 http://cyberneko.org/html/features/report-errors False 是否报告错误。nekohtml属性列表 属性 默认值 值域 描述 http://cyberneko.org/html/properties/filters null XMLDocumentFilter[] 在解析管道的最后按数组顺序追加自定义的处理组件(过滤器),必须为数组类型。 http://cyberneko.org/html/properties/default-encoding Windows-1252 IANA encoding names 默认的HTML文件编码 http://cyberneko.org/html/properties/names/elems upper upper,lower,match 如果整理识别出的元素名称 http://cyberneko.org/html/properties/names/attrs lower upper,lower,no-change 如果整理识别出的属性名称
### Thymeleaf 语法检查 插件 开发工具 IDE 对于希望提高开发效率以及确保代码质量的开发者而言,选择合适的集成开发环境(IDE)及其配套插件至关重要。某些IDE提供专门针对Thymeleaf模板的功能支持,比如语法高亮显示和错误检测机制,这有助于迅速定位并修正可能出现的问题[^1]。 #### IntelliJ IDEA 中配置 Thymeleaf 支持 IntelliJ IDEA 是一款广泛使用的 Java 集成开发环境,它内置了对多种Web框架的良好支持,当然也包括 Thymeleaf 。为了启用 Thymeleaf 的高级特性: - 安装 **Spring Initializr Web Support** 插件来增强 Spring Boot 和 Thymeleaf 工程的支持。 - 使用 `File -> Settings` 或者 `Ctrl+Alt+S` 打开设置窗口,在左侧菜单栏找到 `Languages & Frameworks -> Thymeleaf` ,确认已勾选此选项以激活相关服务。 ```bash # 如果需要手动安装插件可以通过如下路径操作 Preferences/Settings -> Plugins -> Marketplace -> Search "Thymeleaf" ``` 一旦完成上述步骤,IDE 就能够识别 `.html` 文件中的 Thymeleaf 特定标签,并给予实时反馈如颜色区分、自动补全提示等功能,从而有效防止常见的拼写失误或逻辑缺陷。 #### Eclipse STS (Spring Tool Suite) Eclipse 提供了一个名为 Spring Tools 4 for Eclipse 的扩展包,其中包含了强大的 Thymeleaf 编辑器组件。该编辑器不仅限于基本的颜色编码,还集成了智能感知技术,可以在编写过程中提供建议;更重要的是,它可以即时验证 HTML 结构的有效性和 Thymeleaf 表达式的准确性。 要利用这些优势,只需按照常规流程下载并安装最新版本的 Spring Tools 4 即可获得完整的 Thymeleaf 功能集合。 #### Visual Studio Code 尽管 VSCode 并不是专门为 Java 应用程序设计的IDE,但它凭借灵活多样的市场插件同样能很好地处理 Thymeleaf 模板文件。推荐安装由 Pivotal Software Inc. 发布的 “Thymeleaf” 插件,这个轻量级工具为用户提供了一套全面的服务——从简单的语法规则到复杂的表达式解析均有所覆盖。 ```json { "editor.quickSuggestions": { "other": true, "comments": false, "strings": true }, "thymeleaf.validate": true } ``` 以上 JSON 片段展示了如何通过修改用户设置进一步优化VSCode内的Thymeleaf体验,开启快速建议的同时允许更严格校验规则。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值