Runtime Utilities

Bundled with fbt come a few useful utilities for constructing strings.

intlList(...)

intlList creates fbt instances with selectable conjunctions given an array.

As an example

$CONJUNCTIONS = \fbt\Runtime\Shared\intlList::CONJUNCTIONS;

$DELIMITER = \fbt\Runtime\Shared\intlList::DELIMITER;

$people = ['Adam', 'Becky', fbt('4 others', 'last item')];

intlList($people, $CONJUNCTIONS['AND'], $DELIMITER['COMMA']);

produces the fbt

<fbt

desc="A list of items of various types. {previous items} and {following items} are themselves lists that contain one or more items.">

<fbt:param name="previous items">{$output}</fbt:param>,

<fbt:param name="following items">{$items[$i]}</fbt:param>

</fbt>

recursively combining fbts. Note that genders are not used in this fbt:param instances, so they default to UNKNOWN

intlNumUtils and intlSummarizeNumber

There are a few utilities in both intlNumUtils and intlSummarizeNumber that are documented in the source.

In fact fbt::param and fbt::plural default to displaying numbers using intlNumUtils::formatNumberWithThousandDelimiters. You can override this behavior in fbt:param by setting the number option and using your own string in the replacement.

You can override this in fbt::plural by providing the value option.

createElement

We use this function internally to generate HTML for FBT.

\fbt\createElement('div', 'content', ['id' => 'container']);