Details Formatter

%%(details title="summary" open=1)%%


<details open>
  <summary>System Requirements</summary>
  <p>Requires a computer running an operating system. The computer
  must have some memory and ideally some kind of long-term storage.
  An input device as well as some form of output device is
  recommended.</p>
</details>

formatter/highlight/details.php

<?php

/*
    % %(details
        [title="Title"]
        [open=0|1]
        )
    content
    % %
*/

if (!isset($options['title']))        $options['title']    = null;
if (!isset($options['open']))        $options['open']    = 0;

$title    = $options['title'] ?? $this->_t('ShowHideDetails');
$open    = $options['open'] ? ' open' : '';

echo    '<ignore><details' . $open . '>' . "\n";
echo    ($title
            ? '<summary>' . Ut::html($title) . '</summary>' . "\n"
            : '');
include Ut::join_path(FORMATTER_DIR, 'wiki.php');
echo    "</details></ignore>\n";

Summary The HTML Details Element (<details>) creates a disclosure widget in which information is visible only when the widget is toggled into an "open" state. A summary or label can be provided using the <summary> element.

A disclosure widget is typically presented onscreen using a small triangle which rotates (or twists) to indicate open/closed status, with a label next to the triangle. If the first child of the <details> element is a <summary>, the contents of the <summary> element are used as the label for the disclosure widget.

Remarks

  • The Formatter does not support nesting. A formatter cannot invoke another formatter by design.
    • formatter + wrapper
    • it can be done via inline HTML, but this is rather inconvenient because you can't nest wiki syntax in between the <details> tags, the HTML SAX parser would close your <details> tag with </details> in advance

Links