Open topic with navigation

Inserting Togglers into Topics

A toggler is a feature that lets you "toggle" between hiding and showing a tagged chunk of content. When users open the topic in the output, they will see a link (also called a "toggler hotspot"). This hotspot can be any text in the topic. When users click the hotspot, the hidden content is displayed. When users click the hotspot again, the content becomes hidden once more.

We have assigned a toggler element to this paragraph. Click the "Hide Me" hotspot text below to hide this paragraph. Then click the hotspot again to show the paragraph.

Hide Me

How to insert a toggler into a topic

1. Open the topic where you want to insert the toggler.
2. Click anywhere in the paragraph that you want to toggle (the content that will open when users click the hotspot).

3. Select Format>Name.

   The Manage Named Elements dialog opens.

4. Type a name for the toggled element (anything that will help you identify it).

5. Click OK.

   The named element is added, with a yellow flag next to it. The flag will not display in the output. It is simply used to show you where a named element has been inserted. You can hide or show this flag by selecting the option in the View menu.

6. In the topic, highlight the text that you want to use as the toggler hotspot.

7. Select Insert>Toggler.

   The Insert Toggler dialog opens.

8. In the Toggler targets section, click the check box next to the toggler element that you created.
9. (Optional) In the Toggler class section, select a style class to be associated with the toggler.

10. Click OK.

    The toggler hotspot now has the toggler icon next to it in the XML Editor. (The icon will not display in the output. It is simply used to show you where a named element has been inserted.)

    

11. Press CTRL+S or click to save your work.

See Also

Open topic with navigation