33.14. <g:histogramDataItem>

与DataSeries构件和DataItem构件相仿,HistogramDataSeries构件需与HistogramDataItem构件结合使用,生成柱状图。HistogramDataSeries构件接受数据并每次遍历出一行数据,HistogramDataItem构件接受数据,进行统计,最后绘制出柱状图。

33.14.1. 构件信息

表 33.38. 构件信息

Component Typeorg.operamasks.faces.graph.HistogramDataItem
Component Familyorg.operamasks.faces.graph.DataItem
Component Classorg.operamasks.faces.component.graph.UIHistogramDataItem
Tag Classorg.operamasks.faces.webapp.graph.HistogramDataItemTag

继承体系

+java.lang.Object

++javax.faces.component.UIComponent

+++javax.faces.component.UIComponentBase

++++org.operamasks.faces.component.graph.UIDataItem

+++++org.operamasks.faces.component.graph.UIHistogramDataItem

33.14.2. 属性

表 33.39. 属性

binding 定义类 javax.faces.component.UIComponentBase
类型 javax.el.ValueExpression(javax.faces.component.UIComponent)
是否必须 延时求值
一个值表达式,用于把该组件链接到一个ManagedBean的某个属性。
bins 定义类 org.operamasks.faces.component.graph.UIHistogramDataItem
类型 javax.el.ValueExpression(int)
是否必须 延时求值
指定构件分区的数目
color 定义类 org.operamasks.faces.component.graph.UIDataItem
类型 javax.el.ValueExpression(java.lang.Object)
是否必须 延时求值
指定构件描绘图形的颜色
drawItemLabel 定义类 org.operamasks.faces.component.graph.UIDataItem
类型 javax.el.ValueExpression(java.lang.Boolean)
是否必须 延时求值
指定是否显示数据值,默认值是false
drawLines 定义类 org.operamasks.faces.component.graph.UIDataItem
类型 javax.el.ValueExpression(boolean)
是否必须 延时求值
指定是否描绘数据间的连线,默认值时true,此属性只会在构件包含在LineChart或CurveChart构件里才有效
drawMarkers 定义类 org.operamasks.faces.component.graph.UIDataItem
类型 javax.el.ValueExpression(boolean)
是否必须 延时求值
指定构件是否显示数据点标记,默认值时false,此属性只会在构件包含在LineChart或CurveChart构件里才有效
drawOutline 定义类 org.operamasks.faces.component.graph.UIDataItem
类型 javax.el.ValueExpression(boolean)
是否必须 延时求值
指定是否显示图例的图标边框,默认值是true
fillMarkers 定义类 org.operamasks.faces.component.graph.UIDataItem
类型 javax.el.ValueExpression(boolean)
是否必须 延时求值
指定构件显示数据点标记时,标记是否被填充,默认值是true
id 定义类 javax.faces.component.UIComponentBase
类型 java.lang.String
是否必须 延时求值
这个组件的组件标识符。这个值在最近的命名容器类型的父组件范围内,必须是唯一的。
itemLabelColor 定义类 org.operamasks.faces.component.graph.UIDataItem
类型 javax.el.ValueExpression(java.lang.Object)
是否必须 延时求值
指定数据值的颜色
itemLabelFont 定义类 org.operamasks.faces.component.graph.UIDataItem
类型 javax.el.ValueExpression(java.lang.Object)
是否必须 延时求值
指定数据值的字体
legend 定义类 org.operamasks.faces.component.graph.UIDataItem
类型 javax.el.ValueExpression(java.lang.String)
是否必须 延时求值
指定图例名称
lineStyle 定义类 org.operamasks.faces.component.graph.UIDataItem
类型 javax.el.ValueExpression(org.operamasks.faces.component.graph.LineStyleType)
是否必须 延时求值
指定数据间连线的样式
lineWidth 定义类 org.operamasks.faces.component.graph.UIDataItem
类型 javax.el.ValueExpression(java.lang.Float)
是否必须 延时求值
指定数据间连线的宽度,此属性只会在构件包含在LineChart或CurveChart构件里才有效
markerFillColor 定义类 org.operamasks.faces.component.graph.UIDataItem
类型 javax.el.ValueExpression(java.lang.Object)
是否必须 延时求值
指定填充数据点标记的颜色
maximumValue 定义类 org.operamasks.faces.component.graph.UIHistogramDataItem
类型 javax.el.ValueExpression(java.lang.Double)
是否必须 延时求值
指定接受数据统计的最大值
minimumValue 定义类 org.operamasks.faces.component.graph.UIHistogramDataItem
类型 javax.el.ValueExpression(java.lang.Double)
是否必须 延时求值
指定接受数据统计的最小值
outlineColor 定义类 org.operamasks.faces.component.graph.UIDataItem
类型 javax.el.ValueExpression(java.lang.Object)
是否必须 延时求值
指定图例的图标边框颜色
rendered 定义类 javax.faces.component.UIComponentBase
类型 boolean(boolean)
是否必须 延时求值
一个标志,指出该组件是否要在任何随后的form提交过程中被渲染或处理。 这个属性的缺省值是true。
showLegend 定义类 org.operamasks.faces.component.graph.UIDataItem
类型 javax.el.ValueExpression(boolean)
是否必须 延时求值
指定否显示图例,默认值是false

33.14.3. 构件API

33.14.3.1. LineStyleType(枚举类型)

表 33.40. 枚举成员

名称 说明
Solid实线
Dot点线
Dash虚线
DashDot点-虚线
DashDotDot点-点-虚线

33.14.4. 示例

以下的例子介绍了g:histogramDataItem标签常用方法,由于histogramDataItem与histogramDataSeries结合使用,所以与g:histogramDataSeries的示例相似,关于Bean的代码可以看HistogramDataSeries的示例。

下面是jsp页面关于HistogramDataItem的代码:

<g:barChart>
    <g:histogramDataSeries value="#{HistogramData}" var="h">
        <g:histogramDataItem legend="H1" value="#{h}" bins="60"/>
    </g:histogramDataSeries>
</g:barChart>