NIH | National Cancer Institute | NCI Wiki  

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Multiple macros are available to show and hide blocks of content. For example, if you want to provide a transcript with a video, you can use one of these macros to hide the transcript. Readers who want to read the transcript can click the link to expand the text.  

  • If you want to specify different text for the expand and collapse links, use the combination of Cloak, Toggle Cloak, and Composition macros.
  • Otherwise, use the Expand macro. (It is easier to implement.) 

Key point for accessibility: Make sure the link text briefly and uniquely describes the hidden content or what the link does, as in the following examples:

  • Show
  • Hide

Avoid vague link text such as "Click here." 

Panel
borderColorblue
borderStylesolid
titleContents of this page

Table of Contents

Expand Macro

You can use the Expand macro to show and hide blocks of content. For examples of the Expand macro in use, try searching for the Expand macro. For instructions, refer to Atlassian help:

https://confluence.atlassian.com/conf613/expand-macro-964960814.html

Multiexcerpt include
MultiExcerptNameExitDisclaimer
nopaneltrue
PageWithExcerptwikicontent:Exit Disclaimer to Include

Make sure the text for the link is accessible, such as "Transcript of this video." Avoid vague link text such as "Click here." 

For an example of the Expand macro in use, refer to Video of Downloading a Collection via the GUI

Cloak, Toggle Cloak, and Composition Setup Macros

...

To enter the Composition Setup macro

  1. Type as much of the following as needed to open the macro browser. 

    Code Block
    {composition
  2. From Type {Com and from the list of macros, select Composition Setup.Enter
  3. In the

    parameters in the panel of the macro. Refer to the ServiceRocket site for documentation
    Multiexcerpt include
    MultiExcerptNameExitDisclaimer
    nopaneltrue
    PageWithExcerptwikicontent:Exit Disclaimer to Include

...

  1. macro panel, enter the parameters. The following code block lists example parameters. 

    Code Block
    cloak.toggle.type = text
    cloak.toggle.open=[show]
    cloak.toggle.close=[hide]

The Composition Setup macro follows. It is not visible on the completed page.

...

Panel
borderColorblue
borderStylesolid
titleContents of this page

Toggle Cloak
idTOC

Cloak
idTOC

To enter the macros

  1. Type as much of the following as needed to open the macro browser. 

    Code Block
    {cloak
  2. Type { and the first few characters.
  3. When the macro browser opens, select the Cloak or Toggle Cloak macro from the list.
  4. In the macro dialog box, enter the ID (such as TOC in the example). 
  5. Click Save.

...