此ZIP文件包含Thymeleaf Extras Eclipse Plugin 2.1版本的最新更新代码和资源。适用于开发人员进行集成与测试。
Thymeleaf - Eclipse 插件
这是一个为 Eclipse IDE 开发的插件,用于添加 Thymeleaf 标准方言处理器和表达式工具对象的内容辅助功能。该插件使用的是 Eclipse Web Tools Platform HTML 源代码编辑器。
当前版本:2.1.2
发布日期:2016年3月4日
Eclipse 插件的 2.1.x 版本适用于 Thymeleaf 2.1。若要获取支持 Thymeleaf 2.0 的版本,请查看 2.0-master 分支。
最低要求:
- Java 6
- Thymeleaf 2.1.0
- Eclipse Indigo SR2 (3.7.2) 带有 Web Tools Platform 3.3.2(即 Java EE Developer bundle)
安装步骤:
在 Eclipse 中,选择 Help >> Install New Software... 然后使用更新站点 URL 或从 SourceForge 下载插件的 ZIP 归档文件。
内容辅助功能
只有当方言提供了特殊方言元数据文件时,才会提供内容辅助功能。thymeleaf-core、thymeleaf-spring3、thymeleaf-extras-springsecurity3 和 thymeleaf-extras-tiles2 项目已经包含这些文件。其他方言则取决于其开发者。
一旦有了帮助文件,可以通过以下两种方法在 HTML 文件中启用内容辅助功能:
1. 在 HTML 文件中声明方言的名称空间和前缀(这是最简单的方法):
```html
```
2. 将 Thymeleaf 项目特性应用到您的项目上。这种方法可以让所有 HTML 文件都获得内容辅助功能,适用于代码组织为包含大量可重用的 HTML 片段但没有共同根元素来放置 XML 名称空间的情况。
要添加 Thymeleaf 特性:右键点击一个项目 >> Thymeleaf >> Add Thymeleaf Nature。
使用这两种方法之一后,在您的 HTML 文件中显式声明了名称空间(第一种方法)或在项目的类路径中的所有方言(第二种方法),您应开始获得内容辅助功能。这包括输入时的建议、自动完成已输入的内容(如果只匹配一个结果,则可以手动调用 CTRL+SPACE 来触发这些操作),以及将光标悬停在一个 Thymeleaf 处理器上时显示的帮助文本。
为您的方言添加内容辅助
内容辅助特性由关于方言的元数据驱动,目前使用 XML 文件,并符合位于 http://www.thymeleaf.org/xsd/thymeleaf-extras-dialect-2.1.xsd 的模式。
当调用内容辅助功能时,此插件将在当前项目的类路径中查找名称空间为 http://www.thymeleaf.org/extras/dialect 的 XML 文件。如果找到这样的文件,则加载该文件并使用其中的信息来形成 Eclipse 插件使用的代码补全数据。
方言开发者可以利用这一点,在他们的方言 JAR 中包含 XML 帮助文件。
您需要做的就是创建一个符合上述模式的 XML 文件,然后将这个 XML 文件打包到您的 JAR 中。一些关于在 JAR 中放置该文件的位置说明:
- 不能放在默认包中
- 它所在的目录必须是一个有效的 Java 包名
这些是当前方言扫描方法的一些局限性,而这一方法本身建立于 Eclipse 的查找机制之上。