Toggles are generally stable and reliable but since they are based on HTML and JavaScript there are a few things you need to keep in mind when you are using them. Among other things, toggles only work in formats that support both HTML and JavaScript. They are converted to static text in all other formats and they are displayed expanded by default in browsers without JavaScript support or with JavaScript turned off.
When you need to enter IDs manually:
The ID field in all three toggle types is optional and we strongly recommend that you leave it blank unless you have a very good reason for using your own IDs – for example if you need to access the IDs with your own program code in the output generated by Help+Manual. If you need to do this you must enter your own IDs manually because the automatically-assigned IDs may change every time you publish your output.
If you enter your IDs manually you must make sure that there are no conflicts between them in the same topic. Duplicate IDs in different topics are OK but duplicate IDs within the same topic will cause problems and malfunctions.
Toggles don't work or clicking on one toggle "toggles" a different toggle:
This can happen if you have duplicate IDs in the same topic when you are entering your IDs manually. Check all the toggles in the topic for duplicate IDs. Invalid or duplicate IDs will be displayed highlighted in red in the editor.
|
Clicking on the header doesn't "toggle" the section:
If you don't have duplicate IDs (see above) you have probably entered more than one empty paragraph between the toggle header and the toggle table. You can have one empty paragraph between the two but not more.
Unwanted interaction with other images in the same line as the header:
The toggle header icon is a normal image. If you insert other images directly next to it the toggle may also attempt to toggle those images. You can usually solve these problems by editing the toggle (double-click on the header link) and saving it again with OK.
|
The toggle link is broken into several individual links:
This happens when you try to format different parts of the link text differently. You can format toggle links but you must format the entire text in exactly the same way, otherwise the link will be broken up.
CSS styles are not applied to the links:
CSS styles will only work if the Link style option is checked in the Edit Toggle dialog. If this option is not checked you must format the links in the editor, either manually or with styles.
|
This is normal because each image toggle must use two images instead of one. In addition to this you are probably using a larger image for the full-size version than you would normally use. It is thus advisable to use image toggles sparingly and not to use images that are larger than absolutely necessary, even in the full-size versions.
|
Help+Manual can create page breaks within table rows and not just at row boundaries. This means that it is OK to have a large expanding section toggle consisting of just one big table cell with multiple paragraphs of text and other content.
However, page breaks inside tables may not work correctly if you insert tables inside other tables. If you want to be sure your pages will break correctly in PDF don't insert additional tables inside your main toggle tables.
|
See also:
Formatting toggles with CSS
Working with Tables