为了浏览图表的人可以迅速了解图表的内容,显示X轴标尺值是很重要的,而DataLabel构件的功能正是指定X轴标尺的值。
表 33.29. 构件信息
| Component Type | org.operamasks.faces.graph.DataLabel |
| Component Family | javax.faces.Output |
| Component Class | org.operamasks.faces.component.graph.UIDataLabel |
| Tag Class | org.operamasks.faces.webapp.graph.DataLabelTag |
+java.lang.Object
++javax.faces.component.UIComponent
+++javax.faces.component.UIComponentBase
++++javax.faces.component.UIOutput
+++++org.operamasks.faces.component.graph.UIDataLabel
表 33.30. 属性
| binding | 定义类 | javax.faces.component.UIComponentBase | ||
| 类型 | javax.el.ValueExpression(javax.faces.component.UIComponent) | |||
| 是否必须 | 否 | 延时求值 | 是 | |
| 一个值表达式,用于把该组件链接到一个ManagedBean的某个属性。 | ||||
| converter | 定义类 | javax.faces.component.UIOutput | ||
| 类型 | java.lang.String | |||
| 是否必须 | 否 | 延时求值 | 否 | |
| 构件注册的转换器 | ||||
| id | 定义类 | javax.faces.component.UIComponentBase | ||
| 类型 | java.lang.String | |||
| 是否必须 | 否 | 延时求值 | 否 | |
| 这个组件的组件标识符。这个值在最近的命名容器类型的父组件范围内,必须是唯一的。 | ||||
| rendered | 定义类 | javax.faces.component.UIComponentBase | ||
| 类型 | boolean(boolean) | |||
| 是否必须 | 否 | 延时求值 | 是 | |
| 一个标志,指出该组件是否要在任何随后的form提交过程中被渲染或处理。 这个属性的缺省值是true。 | ||||
| value | 定义类 | javax.faces.component.UIOutput | ||
| 类型 | java.lang.String | |||
| 是否必须 | 否 | 延时求值 | 否 | |
| 构件的当前值 | ||||
以下的例子介绍了g:dataLabel标签使用方法,尽管它的属性不多,但它是完整数据图表不可或缺的一部分。
<g:areaChart title="Area Chart Demo" xAxisLabel="Category"
yAxisLabel="Value" showLegend="true" foregroundAlpha="0.7">
<g:dataSeries value="#{CategoryData}" var="x" rows="5">
<g:dataLabel value="#{x.label}" />
......
</g:dataSeries>
</g:areaChart>