Skip to main content

Tolgee wrapping

Tolgee offers two ways of wrapping, you can configure this through wrapperMode.

Text wrapping

In development mode Tolgee wraps every key and it's params into a specific format unless noWrap parameter is true.

<inputPrefix><translationKey>,[<defaultValue>]:[<param1>:<value1>,...,,<paramN>:<valueN>]<inputSuffix>

For example:

tolgee.instant("peter_has_n_dogs", {dogsCount: "5"});

returns:

%-%tolgee:peter_has_n_dogs:dogsCount:5%-%

when inputPrefix and inputSuffix configuration properties are default.

Tolgee is then able to find this wrapped string in DOM and replace it with Peter has 5 dogs. It also stores its metadata in suitable parent element and makes it clickable to allow in-context localization.

Invisible wrapping

Since version 3.0 we introduced invisible wrapping, which uses unicode zero width characters. This method is intended only for framework integrations and basically just adds a invisible mark to each translation, which is then picked up and translation is registered in parent element, so in-context can work properly (blog post). This only applies to development mode. In production mode no special characters are added.