NIB Report Items in HTML Rendering
[This topic is pre-release documentation and is subject to change in future releases. Blank topics are included as placeholders.]
The HTML rendering extension renders the layout of report items and data as elements in an HTML file. How each item is rendered varies depending on the report item.
The ReportItems RDL element is rendered as a TABLE element by the HTML rendering extension. The TR elements within the table are rendered according to the extension's positioning algorithm. If the ReportItems element contains one child item, that item is rendered directly. If the ReportItems element contains no child items, the table is not rendered in HTML.
Items within the ReportItems RDL element (table, matrix, list, chart, line, rectangle, text box, image, and subreport) are rendered within the table as TD elements. The following table describes how common report item sub-elements are rendered in the TD element by the HTML rendering extension. Sub-elements specific to each report item are discussed later in this topic.
| RDL element | Renders as |
|---|---|
Name |
Ignored. |
Top |
Determines the top position of the item. Also determines which item is positioned first in the case of overlapping items. |
Left |
Determines the left position of the item. Also determines which item is positioned first in the case of overlapping items. |
Height |
The HEIGHT attribute for items with a height that cannot change. |
Width |
The WIDTH attribute for items with a width that cannot change. |
ZIndex |
Determines which item is position first in the case of overlapping items. |
Label |
The TITLE attribute. Also rendered as the ALT attribute for images. |
HTML does not support overlapping items, and will position these items next to each other on the page. To determine the position of overlapping items, the rendering extension first considers the value of the Top element for the items, then the value of the Left element, and then the value of ZIndex.
Horizontal and vertical lines are rendered as a table border, and are clipped by other elements. Diagonal lines that are not overlapped with other items are drawn using VML. Diagonal lines that are overlapped are not rendered. Diagonal lines are not rendered if the output format is HTML 3.2.
A rectangle is drawn using the TD element in HTML4.0, and as a separate TABLE element with a single cell in HTML 3.2. If there is a single item within the rectangle, it is rendered directly within that element. If there is more than one item inside the rectangle, an additional TABLE element is created and the items are rendered inside that table.
A text box is rendered as a DIV element that contains a SPAN attribute in the HTML document. If the output format is HTML 3.2, the text box is rendered as a TABLE element with a single cell. The following table describes how elements in the Hyperlink RDL element are rendered by the HTML rendering extension.
| RDL element | Renders as |
|---|---|
Value |
The text inside the DIV, TABLE, or TD element. |
HideDuplicates |
Item is not rendered when the data is the same as the previous record and is not the first instance on the page. |
The CanGrow and CanShrink RDL elements are rendered by the HTML rendering extension as follows:
| CanGrow | CanShrink | HTML 4.0 | HTML 3.2 |
|---|---|---|---|
False |
False |
The height and width of the text box are rendered; overflow is hidden. |
The height and width of the text box are rendered. |
True |
False |
The height and width of the text box are rendered; overflow is visible. |
The width of the text box is rendered. The height is ignored. |
False |
True |
The text is rendered inside a parent DIV element. Height and width of the DIV are rendered; overflow is hidden. |
The height and width of the text box are rendered. |
True |
True |
The width of the text box is rendered, overflow-y is visible, and overflow-x is hidden. Height is ignored. |
The width of the text box is rendered. The height is ignored. |
An image is rendered as an IMG tag in the HTML document. The following table describes how elements in the Image RDL element are rendered by the HTML rendering extension.
| RDL element | Renders as |
|---|---|
Source |
The SRC attribute on the IMG tag. |
The Sizing RDL element is rendered by the HTML rendering extension as follows:
| Sizing | HTML 4.0 | HTML 3.2 |
|---|---|---|
Clip |
The IMG tag is placed inside a DIV tab and overflow is hidden. The height and width are applied to the DIV as styles. |
Width and height are converted to pixels and rendered as attributes. |
Fit |
Width and height are rendered as styles. |
Width and height are converted to pixels and rendered as attributes. |
FitProportional |
The IMG tag is placed inside a DIV tag and overflow is hidden. The height and width are applied to the DIV tag as styles. If JavaScript is enabled, a JScript script is included to resize the image after it is downloaded to the browser. |
Width and height are converted to pixels and rendered as attributes. |
Autosize |
Width and height are not rendered. |
Width and height are not rendered. |
A subreport is rendered as a DIV tag in the HTML document. The contents of the report are rendered as HTML inside the DIV tag. If the subreport fails, an error is shown in a text box on the report.