diff options
Diffstat (limited to 'src/qdoc/qdoc/doc/qdoc-manual-markupcmds.qdoc')
-rw-r--r-- | src/qdoc/qdoc/doc/qdoc-manual-markupcmds.qdoc | 40 |
1 files changed, 40 insertions, 0 deletions
diff --git a/src/qdoc/qdoc/doc/qdoc-manual-markupcmds.qdoc b/src/qdoc/qdoc/doc/qdoc-manual-markupcmds.qdoc index 04d9f7cc3..714db3664 100644 --- a/src/qdoc/qdoc/doc/qdoc-manual-markupcmds.qdoc +++ b/src/qdoc/qdoc/doc/qdoc-manual-markupcmds.qdoc @@ -173,6 +173,46 @@ See also \l {tt-command} {\\tt} and \l {code-command} {\\code}. + \target details-command + \section1 \\details + + The \\details and \\enddetails commands generates a collapsible <details> + element with a <summary> to control the hidden/visible state. + + When generating HTML output, use the \\details and \\enddetails commands to + generate a collapsible \c{<details>} HTML element. The command takes an + optional summary string enclosed in curly braces. This optional argument + specifies a visible heading for the details. + + For example, with the following input: + \badcode * + /\1! + \details {QDoc details} + \note You're looking at detailed information. + \enddetails + \1/ + \endcode + + If QDoc is generating HTML, it will translate these commands to: + + \badcode + <summary>QDoc details</summary><div class="admonition note"><p><b>Note: </b>You're looking at detailed information.</p></div> + \endcode + + QDoc renders this as: + + \raw HTML + <details> + <summary>QDoc details</summary> + <div class="admonition note"> + <p><b>Note: </b>You're looking at detailed information.</p> + </div> + </details> + \endraw + + For any other output format, QDoc generates the contents as a normal paragraph, + ignoring the summary string. + \target div-command \section1 \\div |