Structure
{mainTitle} | |||
{subTitle} | |||
importance secondary | importance primary | Chart Legend | |
importance primary | |||
importance primary |
Behavior
It is possible to produce a bar chart inside a table by adding a column, marking it with the text “Chart Legend” and adding a DimensionGroup
of type bars
.
...
Usage
Add a new “Chart Legend” column in a table style to allow for horizontal bar charts to be inserted
...
“Chart Legend” text should be on the level of the column groups. The chart legend is then produced by merging the column group and column cells together.
If any chart column does not have a name set or is set to empty string (““), the chart legend will not be generated
Bar coloring follows the defined theme.
...
The bars themselves are generated by placing in the chart column for each row a table which consists of two cells. One cell is the filled out bar and the other is basically the padding.
The bars start with the height defined in the configuration file setting tablechart.barheightInPt
and shrink proportionally until tablechart.minimumbarheightInPt
is reached.
The axis can be styled by setting tablechart.axisbordercolor
and tablechart.axisborderwidth
in the configuration file.
...
Once all colors are used, they start cycling.
The column width can be set by setting the metadata (see below on how to set metadata) or the
DimensionGroup.width
property
Table Style Metadata
Table Style Metadata Parameter | Explanation | Default | Visualization |
---|---|---|---|
| Defines the color of the border line between negative and positive bar chart. This value is set in Hex. | #000000 (Black) | |
| Defines the width of the border line between negative and positive bar chart. This value is set in pt. | 0.5 pt | |
| Defines the desired bar height in the chart. This value is only effective if no resizing (proportional shrinking) of the chart is required. This value is set in pt. | 8.50394pt (0.3 cm) | |
| Defines the minimal width of the negative and positive bar chart side. This value is set in mm. | 4 mm | |
| Defines the minimum bar height in the chart. This value is guaranteed and will force the cell height to grow if necessary. This value is set in pt. | 4.25197 pt (0.15 cm) | |
(new) | Defines the minimal vertical padding for the bar chart. Notes:
This value is set in pt. | Depends |
Setting Table Style metadata
For all occurring table styles in the template file (.docx) | For a single table style |
---|---|
Note: Some parameters are mandatory and need to be set either for all styles occurring in the section “Vertical Table Style” at once or individually
Behavior
The axis is positioned based on the data in the abstract report. There are four positions with a distance of 25% of the column width of eachother. If there are no negative values, the axis is placed at position 0 (i.e. to the left). If there are only negative values smaller than 25% of the total, the axis is positioned at position 1 (which is at 25% of the column width) and so forth. Please see the the examples section for concrete applications of this principle.
The formatting of the cell with the text “Chart Legend” is copied and used for formatting the produced chart legend. It is also possible to specify left and right margins in each cell beneath the “Chart Legend” cell.
The column width can be set by either setting the metadata (the JSON comment), the DimensionGroup.width
property or if nothing is set, the actual column width in percent in the table style.
The chart legend is not created if at least one chart column does not have its name set or if it is set to an empty string.Removed after ngr-3538
Examples
Example 1: Showing a simple case with a one bar chart
...
View file | ||
---|---|---|
|
View file | ||
---|---|---|
|
View file | ||
---|---|---|
|
Example 7: Various minimumChartPaddingInPt
set with table bar charts with 3 and 4 charts
View file | ||
---|---|---|
|
View file | ||
---|---|---|
|
View file | ||
---|---|---|
|