2022.1

Table Of Contents

html(value)

Replaces the contents of the <body> of a section or Master Page with the supplied value. This

function is only available in Control Scripts. See also: "section" on page1515 and

"masterpage" on page1470.

value

A String that may contain HTML tags.

Examples

The following script uses html() to retrieve the contents of a section and add a paragraph to it.

var foo = merge.context.sections["Section 1"].html();

foo += "<p>hello world</p>";

merge.context.sections["Section 1"].html( foo );

The following script loads a snippet based on the value of a field, and then replaces the content

of a Print section with the snippet using html().

var mySection = merge.context.sections["Section 1"];

var promoTxt = loadhtml('snippets/promo-' + record.fields['City'] +

'.html');

mySection.html(promoTxt);

paginate()

This method of the section object (see "section" on page1515) triggers pagination of the

current section. The pagination process re-establishes page boundaries, updates page

numbers and page counts, and reapplies Master Pages.

Depending on whether page numbering restarts in each section this may affect the page

numbers in other sections as well (see "Configuring page numbers" on page533).

When the pagination process has ended, the script resumes.

The 'current section' is always a Print section, since this method can only be used in Post

Pagination Scripts, and Post Pagination Scripts only run on the Print context (see "Post

Pagination Scripts" on page970).

You only need to call merge.section.paginate() in a Post Pagination Script if the script has

added or removed content to such an extent that the page boundaries need to be renewed.

For an example see: "Creating a Table Of Contents" on page972.

Page 1496