User`s guide

13 Create a Report Program

13-14

Add Content as a Group

You can use a group to include the same content in different parts of a report. The DOM

API clones the members of a group before appending them to another object.

This example shows the key code to include. After describing the steps involved in using

a group, this example includes code for a complete report that uses a group.

Define the DOM objects that you want to include repeatedly in a report.

disclaimerHead = Heading(2,'Results May Vary');

disclaimerIntro = Paragraph('The following results assume:');

disclaimerList = UnorderedList(...

{'Temperature between 30 and 70 degrees F',...

'Wind less than 20 MPH','Dry road conditions'});

Define a Group object that includes the DOM objects for the group. For example:

disclaimer = Group();

append(disclaimer,disclaimerHead);

append(disclaimer,disclaimerIntro);

append(disclaimer,disclaimerList);

Append the Group object in the place in the report where you want to repeat the

content. For example, if the document object is doc:

append(doc,disclaimer);

This code builds on the code shown above.

import mlreportgen.dom.*;

doc = Document('groupReport','html');