[Table of Contents] [docx version]

PresentationML Reference Material - Table of Contents

iterate (Iterate)

This element specifies how the animation should be successively applied to sub elements of the target element for a repeated effect. It can be applied to contained timing and animation structures over the letters, words, or shapes within a target element.

[Example: Consider a text animation where the words appear letter by letter. The <iterate> element should be used as follows:


<p:cTn id="1" >


<p:iterate type="lt">

<p:tmPct val="10000"/>





End Example]

Parent Elements



Child Elements


tmAbs (Time Absolute)


tmPct (Time Percentage)





backwards (Backwards)

This attribute specifies whether to go backwards in the timeline to the previous node.


The possible values for this attribute are defined by the XML Schema boolean datatype.

type (Iterate Type)

This attribute specifies the iteration behavior and applies it to each letter, word or shape within a container element.


Valid values are by word, by letter, or by element. If there is no text or block elements such as shapes within the container or a single word, letter, or shape (depending on iterate type) then no iteration will happen and the behavior is applied to the element itself instead.


The possible values for this attribute are defined by the ST_IterateType simple type (§4.8.8).

The following XML Schema fragment defines the contents of this element:

<complexType name="CT_TLIterateData">

   <choice minOccurs="1" maxOccurs="1">

   <element name="tmAbs" type="CT_TLIterateIntervalTime"/>

   <element name="tmPct" type="CT_TLIterateIntervalPercentage"/>


   <attribute name="type" type="ST_IterateType" use="optional" default="el"/>

   <attribute name="backwards" type="xsd:boolean" use="optional" default="false"/>