2022.1

This function can only be used in a Post Pagination Script ; see "Post Pagination Script API" on
page1504.
For an example see: "Creating a Table Of Contents" on page972.
next()
next() returns the next sibling of an HTML element, which can be:
l The elements that match the selector of a script (see "results" on page1509).
l One element that matches the selector of a script that runs for "Each matched element"
(see "this" on page1425 and "Setting the scope of a script" on page924).
l The elements returned by a query in the template (see "query()" on page1379).
In HTML, siblings are HTML elements that share the same parent, i.e. HTML elements in the
same container element.
Note that a sibling can be a different type of element. For example, if a paragraph, an image
and a table follow each other in the same Box, they are siblings.
Tip
To get the previous sibling, use previous() (see "prev()" on page1458).
What if there are no siblings?
If you call prev() or next() on a collection of elements (either "results" on page1509 or the
result set of "query()" on page1379), the function will return a collection of siblings. If none of
the elements has a previous or next sibling, the collection will be empty. Actions performed on
an empty collection will simply have no effect.
If you call prev() or next() on a single element (this in an 'Each matched element' script), and
the element has no previous or next sibling, the function returns null. Performing an operation
on a null value will result in an error, which means that the rest of the script won't be executed.
In this case, it is useful to check the return value, unless it's certain that it will never be null.
Page 1451