Editing Togglers

You can edit togglers that you have inserted into a topic in at least three different ways: (1) edit the content in the section that is "toggled," (2) edit the style of a toggler hotspot, and (3) associate the hotspot with another toggler element and/or style class.

How to Edit the Toggler Content

The first way to edit drop-down text is to change the actual content in the section that gets "toggled" when users click the hotspot.

  1. Open the content file.
  2. In the XML Editor, click in the area containing the toggler content. Then add, remove, or replace content as necessary.
  3. Click to save your work.

How to Edit the Style of a Toggler Hotspot

You can edit the style (e.g., font, color) of a toggler hotspot. When you do this, the style changes for all toggler hotspots in any topics in your project.

  1. From the Content Explorer, open the stylesheet that you want to modify.
  2. Complete one of the following sets of steps, depending on whether you want to use the Simplified view or Advanced view in the Stylesheet Editor.

    • Simplified The Simplified view displays styles in a grid view and is often best for brand new users.

      This view provides an easy way to apply properties to styles, with format options available from a toolbar and dialogs (similar to the way one would use an interface such as Microsoft Word). In some cases, only the most common property options are available in the Simplified view (e.g., font, letter/word spacing, paragraph alignment/indentation, autonumbering format, borders, background). One advantage of the Simplified view is that you can apply a property to multiple styles at the same time. You can also click a check box to hide the properties in the editor, allowing you to see only the styles.

    • Advanced The Advanced view displays styles in a tree structure, and despite the name, is user friendly for authors of all levels.

      For the properties, you can toggle between a grouped display and an alphabetical display. The Advanced view of the Stylesheet Editor lets you edit more settings than are available in the Simplified view. In addition, the Advanced view lets you see and apply settings to multiple mediums and media queries at the same time.

  3. If Using Simplified View

    1. In the local toolbar, make sure the first button displays (which means that the Simplified view is currently shown in the editor). If the button displays instead, then click it.
    2. In the upper-left corner of the editor, click in the drop-down field and select .
    3. From the grid in the bottom portion of the editor, find and select the style called MadCap|toggler (or a toggler style class you have created within it).
    4. In the local toolbar of the editor, click . The Properties dialog opens.
    5. Use the tabs and fields in the Properties dialog to change values for any of the style's properties.

      For more information see Styles and Stylesheets, as well as Editing Styles in a Regular Stylesheet.

    6. In the Properties dialog, click OK.

    If Using Advanced View

    1. In the local toolbar, make sure the first button displays . If the button displays instead, then click it.
    2. In the upper-left corner of the editor, click in the drop-down field and select .
    3. On the left side of the editor, find and select the style called MadCap|toggler (or a toggler style class you have created within it).
    4. From the Show drop-down list on the upper-right side of the editor, select . The most relevant properties for that style are shown on the right side of the editor.
    5. (Optional) You can use the toggle button in the local toolbar to show properties below in a group view or an alphabetical view .
    6. Locate the property you want to change.

      Following are some of the more common properties that you might change.

      • mc-closed-image This style, located in the Unclassified property group, lets you select an image to be shown next to the toggler effect when it is in a closed state.
      • mc-closed-image-alt-text This style, located in the Unclassified property group, lets you set alternate text for the toggler effect when it is in a closed state. See Accessibility .
      • mc-open-image This style, located in the Unclassified property group, lets you select an image to be shown next to the toggler effect when it is in an open state.
      • mc-open-image-alt-text This style, located in the Unclassified property group, lets you set alternate text for the toggler effect when it is in an open state. See Accessibility .
      • mc-image-spacing This style, located in the Unclassified property group, lets you set the spacing around the image next to the toggler effect.

      For more information see Styles and Stylesheets, as well as Editing Styles in a Regular Stylesheet.

    7. The area to the right of the property is used for selecting and entering values. If you know how to enter the information correctly, you can click in the value field and type it directly. Otherwise, click the ellipsis button to the right of the property. Depending on the type of property, the appropriate controls and options display, allowing you to choose or enter values (e.g., select from a drop-down list, click a button, complete fields in a dialog or popup). If you completed values in a popup, click OK at the bottom of the box.
  4. Click to save your work.

How to Associate a Hotspot With Another Toggler Element

The third way to edit a toggler is to associate the hotspot with another toggler element and/or style class.

Example You might have multiple sections of content in a topic that are open and closed via toggler hotspots. If you are using one hotspot to "toggle" one section of content, you can easily associate that hotspot with an additional section of content, so that it "toggles" both areas when a user clicks it.

  1. Open the content file.
  2. If you have not yet given a toggler element name to the content that you want to show and hide, follow the steps for inserting a toggler. See Inserting Togglers.
  3. In the XML Editor, right-click the icon at the beginning of the toggler hotspot.
  4. In the menu, select Edit Toggler. The Insert Toggler dialog opens.
  5. In the Toggler targets section, click the check box next to any toggler elements that you want to associate with the hotspot. You can select as many toggler elements as needed.
  6. In the Toggler class section, select a style class to be associated with the toggler.
  7. Click OK.
  8. Click to save your work.

What’s Noteworthy?

Note To edit alternate text for this feature in a specific language, you can modify the language skin. In the Language Skin Editor, select the desired language skin target, then adjust the values for the related AltText property. See Applying Alt Text.