MultiPage class

Create a multi-page section, with automatic overflow from one page to another

final pdf = Document();
pdf.addPage(MultiPage(build: (context) {
  return [
    Text('Hello'),
    Text('World'),
  ];
}));

An inner widget tree cannot be bigger than a page: A Widget cannot be drawn partially on one page and the remaining on another page: It's unbreakable.

A small set of Widget can automatically span over multiple pages, and can be used as a direct child of the build method: Flex, Partition, Table, Wrap, GridView, and Column.

final pdf = Document();
pdf.addPage(MultiPage(build: (context) {
  return [
    Text('Hello'),
    Wrap(
      children: [
        Text('One'),
        Text('Two'),
        Text('Three'),
      ]
    ),
  ];
}));

The Wrap Widget here is able to rearrange its children to span them across multiple pages. But a child of Wrap must fit in a page, or an error will raise.

Use Inseparable to control page breaking. By default (canSpan: false), widgets stay on one page. Set canSpan: true to allow spanning:

final pdf = Document();
pdf.addPage(MultiPage(build: (context) {
  return [
    Text('Header'),
    Inseparable(
      canSpan: true,  // Allows spanning if content is too large
      child: Wrap(
        children: [
          Text('This wrap can span'),
          Text('across multiple pages'),
        ]
      )
    ),
  ];
}));