Data Regions in HTML Rendering
The HTML rendering extension renders the layout of data regions and data as elements in an HTML file. How each item is rendered varies depending on the data region.
Data Regions
Data regions (table, matrix, list, chart) are rendered as TD elements within the table for the containing ReportItems RDL element. The following table describes how common data region sub-elements are rendered in the TD element by the HTML rendering extension. Sub-elements specific to each data region are discussed later in this topic.
RDL element | Renders as |
---|---|
KeepTogether |
The page-break-inside property of the TD element is set to avoid (HTML 4.0). |
NoRows |
Text in place of the data region if the data region contains no rows. The text is rendered in a text box. Page break properties are ignored, and style properties for the data region are applied to the text. If no text is specified in NoRows, no data region or text is rendered. |
List
A list is rendered as a DIV tag in the HTML document. The DIV tag contains the child items of the list.
Grouping
The Label RDL element within the Grouping element provides the text in the document map for the report.
Matrix
A matrix is rendered as a TABLE tag in the HTML document. This table contains the matrix corner, columns, and rows, in separate cells. A TR tag is rendered for each column element and each row value or subtotal.
Corner
The Corner RDL element is rendered as a TD tag in the HTML document. This tag contains ROWSPAN attribute with a value equal to the number of column elements, and a COLSPAN attribute with a value equal to the number of row elements.
ColumnGrouping
The ColumnGrouping RDL element is rendered as a TR tag in the HTML document. This tag contains a TD element for each data value and subtotal, and also has a COLSPAN attribute with a value equal to the number of columns in the column grouping. Hidden column groupings display a subtotal in place of the hidden columns.
The Height element within the ColumnGrouping RDL element determines the height of the column grouping TR tag.
RowGrouping
The RowGrouping RDL element is rendered as a TR tag for each row value or subtotal in the HTML document. This tag contains a TD element for each data value and subtotal, and also has a ROWSPAN attribute with a value equal to the number of rows in the row grouping. Hidden row groupings display a subtotal in place of the hidden rows.
The Width element within the RowGrouping RDL element determines the width of the row grouping TR tag.
Subtotal
The Subtotal RDL element is rendered as a TD tag containing the name of the subtotal. This TD tag also has a COLSPAN or ROWSPAN attribute.
MatrixCell
The report items contained within a matrix cell are rendered as TD tags for each row and column. The height and width of the TD element is determined by the width of the matrix column and the height of the matrix row.
Table
A table is rendered as a TABLE tag in the HTML document. This table contains the table header, table footer, columns, rows, and details in separate cells. A table with all of its contents hidden will still render its background color and borders.
TableColumn
The Width element within the TableColumn RDL element determines the width of the column.
TableRow
Each row is rendered as a TR tag in the HTML document. The Height element within the TableRow RDL element determines the height of the table row TR tag.
Header
The entire set of header TR tags are repeated on each page if the value for RepeatOnNewPage is True. For HTML 4.0, a header row is enclosed in a THEAD element.
Footer
The entire set of footer TR tags are repeated on each page if the value for RepeatOnNewPage is True. For HTML 4.0, a header row is enclosed in a THEAD element.
TableCell
A table cell is rendered as a TD tag in the HTML document.
Chart
A chart is rendered as an IMG tag in the HTML document.