Section widget allows you to start working on a new PDF page. This is also a handy widget if you want to add a background color to specific pages of your report.
By default, each section (widget) in your PDF report is placed one underneath the other and when the content doesn't fit in one page it will be automatically pushed to a new one. For formatting purposes you have to make sure that the content of your widgets between two sections fits exactly in one page. Otherwise, you have to split the content in more widgets and separate them with a section.
This guide will take you through:
1. Setting up the widget
1.2 Page Background
1.3 Page Grid
1.1 Basic Section set-up
When you've added the Section break widget, there's not much more you need to do! Just check that the page padding is as you want it. Adjust it using the arrows or by entering the desired value in mm.
The pages until the first page break will use the options that you set in the Design tab. After you have inserted a Section break, the page padding values will apply to all of the pages until the next page break.
Here's an example of how page breaks are used to ensure that each part of the report will start on a new page.
1.2 Page Background
PDF section widget also allows you to add a solid background color or an image as a background. So you can have different colored sections, and images in your report.
Backgrounds will only work when the page margins set in the Design tab are all set to 0.
Once you've set the page margins to 0, the page background options will be visible. If you want to use backgrounds (image or color), the first widget MUST be a page break (even though it has no background yet). Don't worry - this will not create a blank page.
Click the color box to select the background color you want.
1.3 Page Grid
You can add design elements to the background of your page by clicking Add image or Add text on your Page background grid.
- Drag, Delete or edit the Image you have added
- Fixed page count - Choose on how many pages you want this text to be displayed. If you leave it empty the PDF generator will determine the number of pages
- Name - This is only for you to see
- Click Add to add your image
- Image position - Choose whether you want your image to be displayed on the top, center, or bottom of your grid
Image position at the bottom of the grid
Image position at the top of the grid
When you add text or image to the Background Grid, the Page Background settings will be disabled.
The grid has a 4x4 size, you can change the size of it by dragging it behind the limits.
Here's an example of how you can use the Background grid.
2. Widget logic rules
You can add widget logic rules if you only want a section break to occur under certain conditions. If you want to show a general widget that is visualized every time a PDF report is generated, you can choose not to include a widget logic rule. Learn more about Widget Logic.
Once you've saved your logic rules, don't forget to save your PDF and you're ready to add more widgets!
What's next?
- You can use PDF scheduler if you want to send a PDF report to specified contacts on a regular basis, send team members a weekly report, email the marketing department with a report every Sunday etc. The reports sent out by the scheduler are aggregate reports with all data totaled, as opposed to personalized reports with just one set of information.
- Conditional Rendering is a way of displaying elements based on a condition. It allows you to create simple conditions inside a widget and reduce the number of widgets and rules. With Conditional Rendering, you can render different UI markups based on certain conditions.
- The custom results by respondent table is a dynamic type of widget that will add records automatically to the table once you have set it up. You can set the maximum number of records to show and set the table to sort records from low to high or high to low.