Bookmark

Top Previous Topic Next Topic  Print this topic

Overview: This dialog allows adding or editing bookmarks in XF Designer 2011 documents.  A bookmark is similar to a hyperlink, only it points to an object inside the document rather than having an external destination.

 

Accessing:

Select the Bookmark checkbox under the View tab in the Show/Hide group (the Bookmarks dialog bar should appear in the upper left corner of the screen).
Click the Add Bookmark icon in the upper left corner noted with a star.

 

add.bookmark.jw

 

The following dialog will be displayed:

NOTE:  THE LESS/MORE BUTTON TOGGLES THE DISPLAY OF THE DYNAMIC FEATURES FRAME.

 

add.bookmark.2.jw

 

 

Usage:

Assign a Label (the text that appears in the bookmark tree) by selecting the icon labeled "..." (the Property Value dialog will open).  Assign a Static, Dynamic, or Conditional value to be given as the label.
Select the Target Object (the object the bookmark points to inside the document) by selecting the down arrow.  This will display all elements possessing an id which can be used for bookmarking.
Use the Dynamic Features options to create dynamic bookmarks.  In order create a dynamic bookmark, the target object must point to a repeating element such as a repeating block (xfd:block-repeat).  This repeating element must have an id set.

 

Condition: allows filtering by an XPath condition. The context of the XPath is set by the Repeat field.

Repeat: sets the context of all XPath values in this bookmark: Label, Condition and Sort. It is used to set the context of the dynamic bookmark to that of the repeating element that it targets.

Sort: allows sorting the bookmarks in the output by an XPath value. The context of the XPath is set by the Repeat field.

 

NOTE: THE VALUES IN THE DYNAMIC FEATURES FRAME ARE GENERALLY SET TO MATCH THOSE OF THE REPEATING ELEMENT.  FIRST SET THE REPEAT VALUE TO THE REPEATING ELEMENT'S XPATH, USE SORT IF IT HAS BEEN USED ON THE REPEATING ELEMENT AND SET THE EXPRESSION TO MATCH, THEN FINALLY, SET THE CONDITION TO FILTER OUT CERTAIN ELEMENTS (FOR INSTANCE, IF THE ELEMENT HAS ITS VISIBILITY CONDITIONED BY THE XML DATA)

 

When all fields have been specified accordingly, click OK.
The bookmark will now appear in the Bookmarks dialog bar.

 

bookmark.show.jw

 

 

Example:

The bookmark shown below points to an fo:block with the id value of "fblock".  It's label is set to display "First Block".  There are no Dynamic Features set in this example.

 

edit.bookmark.jw

 

See the How To section for a dynamic bookmark example.