Columns
Structure
{mainTitle} | ||
{subTitle} | ||
importance secondary | importance primary | |
importance primary | ||
importance primary |
Behavior
Similarly to column groups, columns are produced by selecting the cells from the table style with the appropriate importance, copying them and filling them out with the column name.
The format is: importance <importance>
. Where importance can be either primary
, secondary
or a positive number.
The column alignment is determined by first looking at the value type
. Text columns are aligned left, all other value types are aligned right. If no value type is specified, the alignment specified in the table style is used.
Column widths can be set by either setting the columnWidth
or the columnWeight
property. If both are specified, the weight has priority. The column width is a value in percent (either from 0.0 to to 1.0 or from > 1.0 to 100). The weight can be any number and is used to assign the column width based on the available space and the other weights. Columns with neither a width or weight assigned use a default weight of 1.0. This also means that in the case where no weights are specified, the column widths are distributed evenly. It is important to realize that the specified widths and weights are relative to the entire table width. This means that when specifying a width for example, the width of the row header column and potential chart column width has to be taken into account. Please consult the example section for concrete applications of these rules.
Why is the row header name missing in the example structure?
The row header name, that is, the column for the row headers, is on the column level and described in the rows chapter.
Examples
Example 1: Showing how to use column widths
abstract-report-example_showing_column_widths.json output-example_showing_column_widths.docx template-example_showing_column_widths.docx
Example 2: Showing how to use column weights
template-example_showing_column_weights.docx output-example_showing_column_weights.docx abstract-report-example_showing_column_weights.json
Example 3: Showing a mix of column widths and weights
template-example_showing_column_widths_and_column_weights.docx output-example_showing_column_widths_and_column_weights.docx abstract-report-example_showing_column_widths_and_column_weights.json
Example 4: Showing how column alignments work
template-example_showing_column_alignments.docx abstract-report-example_showing_column_alignments.json output-example_showing_column_alignments.docx
Example 5: Showing how specifying different importances in the template works
template-example_showing_column_importances.docx output-example_showing_column_importances.docx abstract-report-example_showing_column_importances.json
Example 6: Showing how firstColumnLeftPadding and lastColumnRightPadding work
example-columns_firstcolumnleftpadding_lastcolumnrightpadding.docx abstract-report-columns_firstcolumnleftpadding_lastcolumnrightpadding.json template-columns_firstcolumnleftpadding_lastcolumnrightpadding.docx