Float and paginal modes Leave feedback

The WordProcessing module of GroupDocs.Editor, which converts WordProcessing formats to an EditableDocument instance (and vice versa), supports two modes: float and paginal (also known as paged). By default, the float mode is enabled. These modes are controlled by a property in the WordProcessingEditOptions and WordProcessingSaveOptions classes:

getEnablePagination(): boolean;
setEnablePagination(enable: boolean): void;

The primary distinction between these two modes lies in how the WordProcessing document is represented:

• Float mode (default): The document is presented in a pageless form. Content is continuous, without page breaks, and entities like headers, footers, watermarks, and page numbers are not present. This mode is most compatible with client-side HTML editors like TinyMCE or CKEditor, which do not support page separation or real-time page recalculations.

• Paginal mode: The document is divided into pages, similar to how it appears in desktop applications like Microsoft Word. Page-related elements like headers, footers, watermarks, and page numbers are included. This mode must be manually enabled and is best suited for scenarios where the end-user can process page-divided content, such as in custom HTML editing software.

1. Float mode is ideal when using HTML editors that cannot handle page structures, allowing for smooth, continuous editing of document content.
2. Paginal mode is useful when page-based editing is required, or when you need to preserve the document’s original formatting with headers, footers, and page numbers.

Here’s how to enable paginal mode in Node.js during the conversion of a WordProcessing document:

const WordProcessingEditOptions = groupdocs.options.WordProcessingEditOptions;

let editOptions = new WordProcessingEditOptions();
editOptions.enablePagination = true;  // Enable paginal mode

Similarly, you can enable paginal mode when saving the edited document:

const WordProcessingSaveOptions = groupdocs.options.WordProcessingSaveOptions;

let saveOptions = new WordProcessingSaveOptions();
saveOptions.enablePagination = true;  // Ensure paginal mode is preserved during save

When performing a complete roundtrip (editing and saving a document), it is recommended to use the same mode for both conversion to and from the EditableDocument format. If you start with float mode during the conversion to EditableDocument, continue using float mode when saving. Similarly, if paginal mode is used, it should be maintained throughout the entire process.