SeparatorTemplate Tag

Purpose

The GEN:SeparatorTemplate tag provides you finer control of the layout of a table by placing a separator between records.  The contents of the SeparatorTemplate tag are inserted after each ItemTemplate and AlternatingItemTemplate tag except the last one.  When the SeparatorTemplate is used, the resulting page will be as follows:

     [ItemTemplate Contents]

     [SeparatorTemplate Contents]

     [ItemTemplate Contents]

     [SeparatorTemplate Contents]

     …

     [ItemTemplate Contents]

When AlternatingItemTemplate tags are also used, the resulting page will be as follows:

     [ItemTemplate Contents]

     [SeparatorTemplate Contents]

     [AlternatingItemTemplate Contents]

     [SeparatorTemplate Contents]

     …

     [ItemTemplate or AlternatingItemTemplate Contents]

Note that the SeparatorTemplate contents are not used at the end of either of the two examples.

In general you can incorporate the separator layout within the ItemTemplate and AlternatingItemTemplate tags itself.  The reason to include a SeparatorTemplate is to get finer control of the layout – specifically related to the separator at the end of the final row.  If the separator layout is used directly within the ItemTemplate and AlternatingItemTemplate tags, then you will always get the separator, even at the end of the last record.

Used In

HTML Layout Pages and Page Templates.

The SeparatorTemplate tag is optional and can only be specified within a Table tag.

Code Generation Tag Attributes

None. The SeparatorTemplate tag does not require a Name attribute.

Examples

     <GEN:Table Name=”EmployeesTable”>

              <!-- table header and header row -->
              <table>
                 <tr><td colspan=10>Header Row</td></tr>
                 <!-- repeating row template -->
                 <GEN:ItemTemplate>
                   <tr bgcolor=”white”>
                    <td><GEN:FieldValue Name=”FirstName”/></td>
                    <td><GEN:FieldValue Name=”LastName”/></td>
                    <td><GEN:FieldValue Name=”Title”/></td>
                    <td><GEN:FieldValue Name=”Address”/></td>
                    <td><GEN:FieldValue Name=”City”/></td>
                    <td><GEN:FieldValue Name=”State”/></td>
                    <td><GEN:FieldValue Name=”ZipCode”/></td>
                    <td><GEN:FieldValue Name=”Country”/></td>
                    <td><GEN:FieldValue Name=”Phone”/></td>
                   </tr>

                </GEN:ItemTemplate>             

                 <GEN:AlternatingItemTemplate>
                   <tr bgcolor=”silver”>
                    <td><GEN:FieldValue Name=”FirstName”/></td>
                    <td><GEN:FieldValue Name=”LastName”/></td>
                    <td><GEN:FieldValue Name=”Title”/></td>
                    <td><GEN:FieldValue Name=”Address”/></td>
                    <td><GEN:FieldValue Name=”City”/></td>
                    <td><GEN:FieldValue Name=”State”/></td>
                    <td><GEN:FieldValue Name=”ZipCode”/></td>
                    <td><GEN:FieldValue Name=”Country”/></td>
                    <td><GEN:FieldValue Name=”Phone”/></td>
                   </tr>

                </GEN:AlternatingItemTempalte>

                 <GEN:SeparatorTemplate>
                   <tr bgcolor=”black”>
                    <td colspan=9></td>
                   </tr>

                </GEN:SeparatorTemplate >

                <!-- table footer -->
                <tr><td colspan=10>Table Footer Row</td></tr>

             </table>
     </GEN:Table>