Like a table, a list frame needs to be grouped to a node from the XML tree to specify the place to begin from in the XML structure. You can do this e.g. with the menu commands List->Add or edit grouping or via the inspector window:
Below the Object name and the Uneditable function, the function Grouping is available which opens the familiar Grouping dialog. Select the desired node and click "OK".
Also like in a table, the grouping is now visible in a tab on the frame:
You can also see that XSLfast sets the enumeration type to "1." by default.
Now the grouping is done but there is no specified content for the frame so far.
Like in a text frame, the content can be assigned by double clicking the frame. The familiar window opens:
Select the correct node from the tree by dragging and dropping it into the right frame.
The selected node is displayed in the frame, like in a regular text frame:
If you processed the layout now, the frame would look like this:
After you specified the content for the list frame, XSLfast offers some more functions for it:
It is possible to assign alternating background colors for the list items, like in a table. Check the check box next to the command Use alternate colors and select both colors the way we described it in the chapter Tables.
Like in a table, the contents of a list can be sorted. We explained the sorting function in the chapter for tables.
The function XPath shows you the node you specified for the list. It also allows you to apply XPath expressions to this element via the editor window.
The function Kind offers a selection of enumeration and bullet types for the list.
Attention: Not all fonts support all bullet types from this selection.
Font, Background color and Text color match the functions for the text frames.
Set the gap between the list number and the list item with the function Label start indent. This property may also have a negative value which implies an outdent.
Label end indent specifies the distance from the end edge of the text to the end edge of the frame.
Provisional distance between starts specifies the provisional distance between the start indent of the list item label (the bullet or the number) and the start indent of the list item body; in short: this property specifies how far the left side of the label is away from the left side of the body.
The function Provisional label separation specifies the provisional distance between the end of the list item label and the start of the list item body; in short: this specifies the separation between the right side of the label and the left edge of the body.
The functions Keep together, Keep with next and Keep with previous were explained in the chapter Table.
The frame properties are used as described in the chapter Text.
In the menu, XSL-FO options you will find the commands Generate FO-Block and Generate FO-Block Container.
This is XSL-FO specific and prevents the creation of a blocks and block containers for the frame if deactivated. We explained these functions briefly in the chapter Text elements. Please also see relevant technical XSL literature for details and further information. The function For each was explained in the chapter Text elements.
The list frame can also be used as a template. The handling of templates is explained in the chapter Use templates.