Value Bar

Customizes the appearance of a (vertical or horizontal) bar in a bar chart.

The main idea of an arcadiaCharts theme ist that it should be appliable regardless of the size of the chart or the number of valueSets in a chart. So its not viable to define the width of a single column in a columnchart in pixels. You may use a stacked column chart with five columns containing four values and want to try out, if a clustered column chart may represent your data better. So instead of 5 columns the chart will draw 20 columns in 5 groups. Using a fixed value for the column width could break your design easily.

To avoid this arcadiaCharts lets you declare which percentage of the plot area width/height should be used for drawing columns/bars regardless of the number of bars. The default value for this ratio is 0.6 (60%)

Attributes:

  • style
    • Style of the valueBar
    • Available Styles: plain | 3d | beveled | glass
    • default: plain
  • sizePercentage
    • Ratio of the available plot area to be used for drawing valueBars.
    • sets ThemeProperty VALUE_BAR_SIZE_PERCENTAGE
    • Accepted values: Percentage value between 0 and 1.
    • default: 60% of plot area width
  • spacingRatio
    • Ratio between innerSpacings (gap between bars within a valueBar cluster) and spacings (gap between single valueBars or valueBar clusters).
    • sets ThemeProperty VALUE_BAR_SPACING_RATIO
    • Accepted values: Percentage value between 0 and 1.
    • default: innerSpacings are 20% the width of spacings
  • axisSpacingStart
    • Size of the spacing between the primary y-axis and the first valueBar. Overrides the automatically computed spacing and replaces it with the specified size in pixels. The axisSpacingStart and axisSpacingEnd values get removed from the available plot area during the calculation of bar sizes and spacings
    • sets ThemeProperty VALUE_BAR_AXIS_SPACING_START
    • Accepted values: Size in pixels.
    • default: none. The layouter tries to find an adequate spacing based on the size of the plot area, the number of valueBars and the number of spacings and innerSpacings in the chart
  • axisSpacingEnd
    • Size of the spacing between the last valueBar and the secondary y-axis or the end of the plot area. Overrides the automatically computed spacing and replaces it with the specified size in pixels. The axisSpacingStart and axisSpacingEnd values get removed from the available plot area during the calculation of bar sizes and spacings.
    • sets ThemeProperty VALUE_BAR_AXIS_SPACING_END
    • Accepted values: Size in pixels.
    • default: none. The layouter tries to find an adequate spacing based on the size of the plot area, the number of valueBars and the number of spacings and innerSpacings in the chart

Example:

<valueBar>
   <style>beveled</style>
   <sizePercentage>0.5</sizePercentage>
   <spacingRatio>0.25<spacingRatio>
   <axisSpacingStart>10</axisSpacingStart>
   <axisSpacingEnd>10</axisSpacingEnd>
</valueBar>