jsf - 如何将文档添加到复合组件的属性

Question

我有一个看起来像这样的复合组件：

<composite:interface>           
    <composite:attribute name="confirmUnload" type="java.lang.Boolean" default="false" />
    <composite:attribute name="showLoader" type="java.lang.Boolean" default="true" />
    <composite:attribute title="test test" name="menuFormIds" type="java.lang.String" default="menuForm" />
    <composite:attribute name="unloadMessage" type="java.lang.String" default="You have unsaved data" />            
</composite:interface>

<composite:implementation>
    <div title="unloadEventComponent">...</div>
</composite:implementation>

在页面中使用此组件时，eclipse 自动完成将帮助处理属性。但是，有时不看代码很难理解属性的作用，这对用户体验没有帮助。

有没有办法将属性描述添加到复合组件中，使其显示在 eclipse 自动完成中？

PrimeFaces 组件在选择属性时通常有描述，但它们使用自定义组件而不是复合组件。

Answer 1

为此，shortDescription应使用该属性。例如

<composite:attribute name="confirmUnload" type="java.lang.Boolean" default="false" 
    shortDescription="Set to true to enable the confirm unload message. Defaults to false." />