item-by-item

item-by-item(start: auto, cont)(source)

Display list, enum, or terms items one by one with animation.

Each item is revealed on a successive subslide. By default (start: auto), revealing is relative to the current pause position — items appear one per subslide starting from wherever the slide's animation has reached.

start also accepts a waypoint label (e.g. <my-wp>) or any waypoint marker (from-wp(<wp>), get-first(<wp>), etc.) to anchor the reveal sequence to a named position.

Examples

// Relative (auto) — items appear after any preceding #pause
#item-by-item[
  - first
  - second
  - third
]

// Anchored to a waypoint
#waypoint(<items>)
#item-by-item(start: <items>)[
  - alpha
  - beta
]

// Explicit absolute subslide number (backward compatible)
#item-by-item(start: 3)[
  - x
  - y
]

Parameters

start : auto | int | label | dictionary    default: auto

The subslide on which the first item appears. auto (default) makes it relative to the current pause position. An integer gives an absolute subslide number. A label or waypoint marker resolves to the waypoint's first subslide.

cont : content

The content containing a list, enum, or terms element.

Returns: content