#### 16.9.2 Setting up expandable sections for your document

To enable expandable drop-down sections in the HTML output from your DITA document:

    [DropDowns]
    ; UseDropDowns = No (default) or Yes (enable use of dropdowns)
    UseDropDowns = Yes

Simple drop-down sections

To provide simple drop-down sections:

- Use a dedicated block-element @outputclass for material you want to allow users to expand.
- Assign property DropDown to the resulting format.
- Let DITA2Go supply the drop-down links.

For example, suppose you apply @outputclass="ExpandThis" to each paragraph to be expanded. You would include the following setting in your project configuration file:

    [HTMLParaStyles]
    ExpandThis = DropDown

With this setting, DITA2Go would insert a drop-down link in HTML output just before each ExpandThis paragraph, and hide the paragraph when a user first displays the topic. The user clicks the link to show the paragraph; then clicks the link again (or clicks the paragraph) to hide it again.

Multiple drop-down paragraphs

To include multiple paragraphs in an expandable section, or to include material in some other format, surround the material to be expanded with Code PI markers in otherwise empty paragraphs; see §16.9.3 Delimiting expandable drop-down sections.

Customized drop-down section

To position drop-down links yourself, or to use existing text in your document for the links, or both:

- Place a paragraph with a dedicated @outputclass wherever you want a drop-down link; or choose an existing paragraph format (such as a heading or figure title) for this purpose, or even a character format.
- Assign a drop-down link format property to the format, and a corresponding drop-down block format property to the format of material to be expanded; see §16.9.3.1 Delimiting drop-down links and blocks with paragraph formats.
- For any existing link text that is not in the drop-down link format, surround the link text with Code PI markers that invoke drop-down link macros; do the same for blocks that are not in the drop-down block format, invoking the corresponding drop-down block macros. See §16.9.3.2 Delimiting drop-down links and blocks with markers.
- Specify display options for drop-down links and blocks; see §16.9.4 Configuring drop-down links and §16.9.5 Configuring drop-down blocks.

Previous Topic: 16.9.1 Understanding DITA2Go expandable drop-down sections

Next Topic: 16.9.3 Delimiting expandable drop-down sections

Parent Topic: 16.9 Including expandable sections in Help topics

Sibling Topics:

16.9.1 Understanding DITA2Go expandable drop-down sections

16.9.3 Delimiting expandable drop-down sections

16.9.4 Configuring drop-down links

16.9.5 Configuring drop-down blocks

16.9.6 Providing CSS for drop-down links and blocks

16.9.7 Deploying JavaScript code for drop-down sections

16.9.8 Emulating Web Works Publisher drop-down hotspots

Table of Contents • Index