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." />