Note: This release is in preview. Features described here don’t become generally available until the latest general availability date that Salesforce announces for this release. Before then, and where features are noted as beta, pilot, or developer preview, we can’t guarantee general availability within any particular time frame or at all. Make your purchase decisions only on the basis of generally available products and features.

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.

1{!format($Label.mySection.myLabel, v.attribute1, v.attribute2)}

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:

1{!format('Hello {0}', v.name)}

Use this expression instead.

1{!format($Label.mySection.salutation, v.name)}

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

Note

Lightning Aura Components Developer Guide

Dynamically Populating Label Parameters