如何在 Eclipse 中查看 jsf/facelets 元素的文档

2022-01-18 00:00:00 tags eclipse jsf facelets

我正在使用 helios 3.6.2.我用网页编辑器打开了一个 .xhtml

每当我将鼠标悬停在一个元素上时,例如f:view,我只看到:

<块引用>

元素:f:view

而不是根据 tld 假设如下的描述:

<块引用>

创建一个 JSF 视图,它是一个容纳所有的容器作为视图一部分的组件.

除非另有说明,所有属性接受静态值或 EL表达式.

查看javadoc对于 JSF 中的这个类规范以获取更多详细信息.

有没有我可以配置 eclipse 来做到这一点?

解决方案

这取决于使用的插件.当前的 Eclipse 版本 (Helios) 确实不支持开箱即用 (更新:自从 Kepler 是第一个具有内置 JSF 2.0 支持的 Eclipse 版本以来肯定支持).

当您使用例如 ,它可以按照 这里.不幸的是,这个插件不适用于 Tomcat.

I am using helios 3.6.2. I have an .xhtml opened with Web Page Editor

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
          "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml"
      xmlns:f="http://java.sun.com/jsf/core"
      xmlns:h="http://java.sun.com/jsf/html"
      xmlns:ui="http://java.sun.com/jsf/facelets"
      >
<f:view>
<h:head>
...
</h:head>

when ever I hover over an element,e.g. f:view, I only see :

Element : f:view

rather than the description which suppose to be the following according to the tld:

Creates a JSF View, which is a container that holds all of the components that are part of the view.

Unless otherwise specified, all attributes accept static values or EL expressions.

See the javadoc for this class in the JSF Specification for further details.

Is there anyway I can configure the eclipse to do that?

解决方案

That depends on plugins used. Current Eclipse version (Helios) indeed doesn't support this out the box (update: this is definitely supported since Kepler which is the first Eclipse version with builtin JSF 2.0 support).

When you're using for example Glassfish 3 and use the Glassfish server plugin and the project has Glassfish set as target runtime, then you'll see autocompletion and documentation for all tags and attributes in the Facelet XHTML page. You will even get an extra rightclick menu option on the project New > XHTML file.

Here are some screens of a Eclipse+Glassfish project:


Tag tooltip:


Tag autocompletion:


Attribute autocompletion:


When using for example Tomcat as target runtime, this feature is not available. Even more, syntax highlighting doesn't work at all. You would have to manually add *.xhtml extension to JSP editor settings to get the highlighting to work by Window > Preferences > General > Content Types > Text > JSP. But that's it.

For JBoss AS 6 you need the JBoss Tools plugin which can be installed as described here. This plugin by the way unfortunately doesn't work out for Tomcat.

相关文章