Page Layout in HTML Rendering
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.
Report
Elements within the Report RDL element are rendered as elements, or tags, within the HEAD section of the HTML document. The following table describes how elements in the Report RDL element are rendered by the HTML rendering extension.
| RDL element | Renders as |
|---|---|
Name |
|
Description |
|
Author |
|
AutoRefresh |
|
Body
The contents of the Body RDL element are rendered in the BODY section of the HTML document. The BODY section contains a DIV tag which includes information for height, width, and border. Items contained within the Body RDL element are rendered as children of the BODY HTML element.
The following table describes how elements in the Body RDL element are rendered by the HTML rendering extension.
| RDL element | Renders as |
|---|---|
Height |
The height attribute of the DIV HTML element. |
Width |
The width attribute of the DIV HTML element. |
Page Height |
Ignored. |
Page Width |
Ignored. |
Columns |
Ignored. |
ColumnSpacing |
Ignored |
Note
Multiple ("snaking" or continuous) columns in the report body are not supported by the HTML rendering extension. All reports are rendered with a single column by the HTML rendering extension.
PageHeader
The page header is rendered as a DIV tag at the top of each page. The contents of the page header are contained within a TABLE tag. The following table describes how elements in the PageHeader RDL element are rendered by the HTML rendering extension.
| RDL element | Renders as |
|---|---|
Height |
The height of the TABLE HTML element. |
PrintOnFirstPage |
Indicates whether the page header is included on the first page. |
PrintOnLastPage |
Indicates whether the page header is included on the last page. |
PageFooter
The page footer is rendered as a DIV tag at the bottom of each page. The contents of the page footer are contained within a TABLE tag. The following table describes how elements in the PageFooter RDL element are rendered by the HTML rendering extension.
| RDL element | Renders as |
|---|---|
Height |
The height of the TABLE HTML element |
PrintOnFirstPage |
Indicates whether the page footer is included on the first page. |
PrintOnLastPage |
Indicates whether the page footer is included on the last page. |
Custom
The Custom RDL element is ignored by the HTML rendering extension.
Hyperlink
A hyperlink that is part of a report item is rendered as an A tag in the HTML document. The following table describes how elements in the Hyperlink RDL element are rendered by the HTML rendering extension.
| RDL element | Renders as |
|---|---|
URL |
The HREF attribute on the A tag. |
Visibility
If the value for the Hidden RDL sub-element is True, and the ToggleItem element is not set, then the report item is not rendered. If ToggleItem is set, the toggle image is displayed next to a toggle item. When the image is clicked, the report server refreshes the HTML to include the report item.
ToggleImage
If a text box has a child ToggleImage element, then a small + or - image is rendered to the left of the text in the textbox, inside the border and padding.
Style
Style elements are rendered as CSS styles for HTML 4.0 and as HTML attributes for HTML 3.2. For HTML 4.0, a single CSS style is rendered for each report item. The names of the styles are unique across reports and subreports. The following table indicates how RDL style attributes map to HTML styles.
| RDL style | Description | HTML 4.0 | HTML 3.2 |
|---|---|---|---|
BorderColor |
Color of the border |
border |
bordercolor |
BorderStyle |
Style of the border |
border |
Ignored |
BorderWidth |
Width of the border |
border |
border |
BackgroundColor |
Color of the background |
background-color |
bgcolor |
BackgroundImage |
URL of the background image |
background-image |
background |
BackgroundRepeat |
Repeat pattern of background image |
background-repeat |
Ignored (repeat) |
FontStyle |
Style of font (Normal, Italic) |
font-style |
<I> |
FontSize |
Size of font |
font-family |
<font face=> |
FontWeight |
Weight of text |
font-weight |
<B> |
TextDecoration |
Decoration of text (Underline, Strikethrough) |
text-decoration |
<U> |
TextAlign |
Horizontal alignment of text |
text-align |
align |
VerticalAlign |
Vertical alignment of text |
vertical-align |
valign |
Color |
Color of text |
color |
color |
PaddingLeft |
Size of padding between left border and text |
padding-left |
Ignored |
PaddingRight |
Size of padding between right border and text |
padding-right |
Ignored |
PaddingTop |
Size of padding between top border and text |
padding-top |
Ignored |
PaddingBottom |
Size of padding between bottom border and text |
padding-bottom |
Ignored |
LineHeight |
Height of the lines of text |
Line-height |
Ignored |
Direction |
Right-to-left or left-to-right |
DIR attribute |
Ignored |
Language |
Language of the text |
LANG attribute |
Ignored |
UnicodeBiDi |
Override of the bi-directional algorithm |
unicode-bidi |
<BDO> |
Note
Due to the different tags used for HTML 4.0 and HTML 3.2, the same items may appear differently between the two formats. For example, the tags used to control font weight are more precise in HTML 4.0. Depending on the font weight, text that is bold in HTML 4.0 may not appear bold in HTML 3.2.
Note
Borders with a border style of Double and a border width of less than 2 pt are rendered as a single line by the HTML rendering extension. A border with a border style of Double must have a border width of at least 2 pt to display both lines.