function t in Drupal 8

Same name and namespace in other branches

1. 4 includes/common.inc \t()
2. 5 includes/common.inc \t()
3. 6 includes/common.inc \t()
4. 7 includes/bootstrap.inc \t()
5. 9 core/includes/bootstrap.inc \t()

Translates a string to the current language or to a given language.

In order for strings to be localized, make them available in one of the ways supported by the Localization API. When possible, use the \Drupal\Core\StringTranslation\StringTranslationTrait $this->t(). Otherwise create a new \Drupal\Core\StringTranslation\TranslatableMarkup object directly.

See \Drupal\Core\StringTranslation\TranslatableMarkup::__construct() for important security information and usage guidelines.

Parameters

string $string: A string containing the English text to translate.

array $args: (optional) An associative array of replacements to make after translation. Based on the first character of the key, the value is escaped and/or themed. See \Drupal\Component\Render\FormattableMarkup::placeholderFormat() for details.

array $options: (optional) An associative array of additional options, with the following elements:

• 'langcode' (defaults to the current language): A language code, to translate to a language other than what is used to display the page.
• 'context' (defaults to the empty context): The context the source string belongs to. See the Internationalization topic for more information about string contexts.

Return value

\Drupal\Core\StringTranslation\TranslatableMarkup An object that, when cast to a string, returns the translated string.

See also

\Drupal\Component\Render\FormattableMarkup::placeholderFormat()

\Drupal\Core\StringTranslation\StringTranslationTrait::t()

\Drupal\Core\StringTranslation\TranslatableMarkup::__construct()

Related topics

2198 calls to t()

AccessDeniedTest::testAccessDenied in core/modules/system/tests/src/Functional/System/AccessDeniedTest.php

AccessRoleUITest::testAccessRoleUI in core/modules/user/tests/src/Functional/AccessRoleUITest.php

Tests the role access plugin UI.

AccountForm::form in core/modules/user/src/AccountForm.php

Gets the actual form array to be built.

AccountPermissionsCacheContext::getLabel in core/lib/Drupal/Core/Cache/Context/AccountPermissionsCacheContext.php

Returns the label of the cache context.

ActionListBuilder::buildHeader in core/modules/action/src/ActionListBuilder.php

Builds the header row for the entity listing.

... See full list

83 string references to 't'

DatabaseTestController::pagerQueryEven in core/modules/system/tests/modules/database_test/src/Controller/DatabaseTestController.php

Runs a pager query and returns the results.

DatabaseTestController::pagerQueryOdd in core/modules/system/tests/modules/database_test/src/Controller/DatabaseTestController.php

Runs a pager query and returns the results.

DatabaseTestController::testTablesort in core/modules/system/tests/modules/database_test/src/Controller/DatabaseTestController.php

Runs a tablesort query and returns the results.

DatabaseTestController::testTablesortFirst in core/modules/system/tests/modules/database_test/src/Controller/DatabaseTestController.php

Runs a tablesort query with a second order_by after and returns the results.

DateHelper::days in core/lib/Drupal/Core/Datetime/DateHelper.php

Constructs an array of days in a month.

... See full list

File

core/includes/bootstrap.inc, line 355

Functions that need to be loaded on every Drupal request.

Code

function t($string, array $args = [], array $options = []) {
  return new TranslatableMarkup($string, $args, $options);
}