Overview
Version
Report Server Version |
---|
11.0 |
Application Scenario
Pagination Preview is the default preview method in FineReport, typically used when you need to view only the report data.
Function Description

1. You can open the designer, double-click the embedded template GettingStarted.cpt, click the drop-down key of Preview on the designer page, and click Pagination Preview to view the report. The following figure shows the effect.
2. A report will be opened in the browser after you click Pagination Preview, as shown in the following figure.

Pagination Preview Setting
You can choose Template > Web Attribute > Pagination Preview Setting to set the report page of the pagination preview. This setting is effective only for templates in the Pagination Preview mode, as shown in the following figure.
The following table describes the main functional modules.
Function | Content | Notes |
---|---|---|
Setting Method | Using Server Settings is selected by default. You can select Set for This Template Separately from the drop-down list of Following Settings. | / |
Report Display Location | You can set the location where the report is displayed in the browser. | The function does not take effect on mobile terminals. |
Page | You can configure some special settings on the page. | / |
Toolbar | You can determine whether to display the toolbar and to customize the content displayed on the toolbar. | Mobile terminals do not support toolbar settings. |
Event Setting | Mobile terminals only support the Loading Start and Loading End events. | |
Pagination Setting | You can set the report to be displayed with a fixed number of rows per page according to the specified cell. | You need to determine the pagination data cell. |
Setting Method
Using Server Settings
Use Server Settings is selected by default with all the following functions being grayed out and non-editable. This setting method is selected by default for all templates on the current server.
You can choose Server > Server Configuration > Pagination Preview Setting to modify the predefined data entry preview setting of the server.
Setting for This Template Separately
You can select Set for This Template Separately from the drop-down list of Following Settings. All the functions below are editable. The configured settings will only apply to the current template without affecting other templates.
Report Display Location
This function allows you to set the report display location in the browser during the preview, with two options Center and Left (default setting). The following figures show the corresponding effects.
Displayed in the Center
Displayed on the Left
Page Setting
You can configure some special settings for the previewed page(s).
1. Display as Image: During pagination preview, a report will be displayed as an image/images where characters cannot be selected by the mouse.
2. Auto Zoom During Iframe Embedding: When a template is embedded into another template via an iframe, the template size will be automatically adjusted during the preview to fit the iframe.
Take the example in Opening a Report Through a Dialog Box by JSt as an example.
When Auto Zoom During Iframe Embedding is not ticked for the embedded template, the following figure shows the effect.
When Auto Zoom During Iframe Embedding is ticked for the embedded template, the following figure shows the effect.
3. Fixed-size grid output: You can keep cell row heights and column widths unchanged regardless of how large the content is.
Toolbar
Showing the Toolbar
The Use Toolbar function is ticked by default in the system. That is, the toolbar is displayed above the report during the pagination preview. Deselect the function if you need to hide the toolbar.
Adding Tools
1. You can double-click a tool to add it to the top toolbar.
2. After selecting the tool, you can click to add the tool to the top toolbar, and click
to add the tool to the bottom toolbar.
3. You can click Restore to Default to return to the original state.
Customizing the Toolbar
You can click on the right of the toolbar to open the toolbar edit page, as shown in the following figure.
On the edit page, you can modify the attributes of and reorder added tools, delete individual tools, and customize the toolbar background, as shown in the following figure.

Deleting Tools
How to delete an added tool? The following two deletion methods are available in the designer.
1. Delete all tools.
You can click on the right of the toolbar to clear all tools in the toolbar, as shown in the following figure.
2. Delete a single tool.
You can click on the right of the toolbar to delete a single tool in the toolbar edit page, as shown in the following figure.
Event Setting
You can click in Event Settings and add JS events, which allows you to meet other preview needs through JavaScript codes.
Pagination Setting
You can tick Pagination by Row in Pagination Setting and set the number of rows displayed per page in the report. The default number of rows is 30. You can modify the number according to actual needs. You can set Number of Rows Displayed Per Page to be a value from 1 to 500. Empty values are not allowed. Any input number exceeding this range will automatically be adjusted to the nearest boundary value (1 or 500).