Multi-Page Content
The drawing.drawDOM allows you to create multi-page PDF content, specify manual page breaks and prevent page splitting.
- Rendering multi-page content
- Automatic page breaking
- Manual page breaking
- Preventing page breaking in elements
Rendering Multi-Page Content
To render a multiple-page PDF file, pass multiPage: true to the Group object, which you pass to exportPDF (master group). This group is then expected to contain in turn only Group shapes, one for each page (page groups). The PDF options that you pass to the master group apply to each page group, unless the page group overrides them.
You can override the following options:
If the
paperSizeoption for the master group is set to"auto"and the page groups do not override it, the paper size for each individual page is determined by its corresponding group. This means that the pages of the final document might be of different sizes.
Automatic Page Breaking
The drawDOM method supports automatic page breaking. To automatically implement the page breaks, set the paperSize and margin options. You will still be able to apply the forcePageBreak configuration to manually specify the break points.
<div id="grid"></div>
<script>
$(document).ready(function() {
var data = [];
for (var i = 1; i < 200; ++i) {
data.push({ title: "Item " + i, id: i });
}
$("#grid").kendoGrid({ dataSource: data });
kendo.drawing.drawDOM("#grid", {
paperSize: "A4",
margin: "2cm"
}).then(function(group){
kendo.drawing.pdf.saveAs(group, "grid.pdf");
});
});
</script>
Manual Page Breaking
A page break occurs before each element that matches the forcePageBreak CSS selector of your choice. The option accepts CSS selectors that are passable to querySelector. The following example demonstrates how to draw a multi-page Kendo UI Grid which matches elements with class .page-break.
<div id="grid" style="width: 900px;"></div>
<script>
$(document).ready(function() {
var data = [];
for (var i = 1; i < 50; ++i) {
data.push({ title: "Item " + i, id: i });
}
$("#grid").kendoGrid({
dataSource: data,
rowTemplate: $("#rowTemplate").html()
});
kendo.drawing
.drawDOM("#grid", { forcePageBreak: ".page-break" })
.then(function(group){
kendo.drawing.pdf.saveAs(group, "multipage.pdf")
});
});
</script>
<script id="rowTemplate" type="x/kendo-template">
<!-- to every tenth row, add the "page-break" class -->
<tr data-uid="#= uid #" class="#= (id%10 == 0 ? 'page-break' : '') #">
<td>#: title #</td>
<td>#: id #</td>
</tr>
</script>
Preventing Page Breaking in Elements
To prevent specific elements from being split across pages, use the keepTogether option. keepTogether accepts CSS selectors that are passable to querySelector.
All elements from the following example which have the "prevent-split" CSS class are kept within the boundaries of the pages and their content is not split. If they fall on a margin, they will be moved to the next page.
drawing.drawDOM("#content", {
paperSize: "A4",
margin: "2cm",
keepTogether: ".prevent-split"
}).then(function(group){
drawing.pdf.saveAs(group, "filename.pdf");
});