/Drupal 8

Annotation for translatable text

Describes how to put translatable UI text into annotations.

When providing plugin annotation, properties whose values are displayed in the user interface should be made translatable. Much the same as how user interface text elsewhere is wrapped in t() to make it translatable, in plugin annotation, wrap translatable strings in the @ Translation() annotation. For example:

  title = @ Translation("Title of the plugin"),

Remove spaces after @ in your actual plugin - these are put into this sample code so that it is not recognized as annotation.

To provide replacement values for placeholders, use the "arguments" array:

  title = @ Translation("Bundle !title", arguments = {"!title" = "Foo"}),

It is also possible to provide a context with the text, similar to t():

  title = @ Translation("Bundle", context = "Validation"),

Other t() arguments like language code are not valid to pass in. Only context is supported.

See also




core/lib/Drupal/Core/Annotation/Translation.php, line 8


Name Location Description
PluralTranslation core/lib/Drupal/Core/Annotation/PluralTranslation.php Defines an annotation object for strings that require plural forms.
Translation core/lib/Drupal/Core/Annotation/Translation.php Defines a translatable annotation object.

© 2001–2016 by the original authors
Licensed under the GNU General Public License, version 2 and later.
Drupal is a registered trademark of Dries Buytaert.