Newer Version Available

This content describes an older version of this product. View Latest

Dynamically Populating Label Parameters

Output and update labels using the format() expression function.

You can provide a string with placeholders, which are replaced by the substitution values at runtime.

Add as many parameters as you need. The parameters are numbered and are zero-based. For example, if you have three parameters, they will be named {0}, {1}, and {2}, and they will be substituted in the order they're specified.

Let's look at a custom label, $Label.mySection.myLabel, with a value of Hello {0} and {1}, where $Label is the global value provider that accesses your labels.

This expression dynamically populates the placeholder parameters with the values of the supplied attributes.

The label is automatically refreshed if one of the attribute values changes.

Always use the $Label global value provider to reference a label with placeholder parameters. You can't set a string with placeholder parameters as the first argument for format(). For example, this syntax doesn't work:

Use this expression instead.

where $Label.mySection.salutation is set to Hello {0}.

Note