@wordpress/i18n Edit

Internationalization utilities for client-side localization. See How to Internationalize Your Plugin for server-side documentation.

Installation Installation

Install the module:

npm install @wordpress/i18n --save

This package assumes that your code will run in an ES2015+ environment. If you’re using an environment that has limited or no support for ES2015+ such as lower versions of IE then using core-js or @babel/polyfill will add support for these methods. Learn more about it in Babel docs.

Top ↑

Usage Usage

import { sprintf, _n } from '@wordpress/i18n';

sprintf( _n( '%d hat', '%d hats', 4, 'text-domain' ), 4 );
// 4 hats

For a complete example, see the Internationalization section of the Block Editor Handbook.

Top ↑

API API

# setLocaleData

Merges locale data into the Tannin instance by domain. Accepts data in a
Jed-formatted JSON object shape.

Related

Parameters

  • data ?Object: Locale data configuration.
  • domain ?string: Domain for which configuration applies.

# sprintf

Returns a formatted string. If an error occurs in applying the format, the
original format string is returned.

Related

Parameters

  • format string: The format of the string to generate.
  • args ...string: Arguments to apply to the format.

Returns

  • string: The formatted string.

# _n

Translates and retrieves the singular or plural form based on the supplied
number.

Related

Parameters

  • single string: The text to be used if the number is singular.
  • plural string: The text to be used if the number is plural.
  • number number: The number to compare against to use either the singular or plural form.
  • domain ?string: Domain to retrieve the translated text.

Returns

  • string: The translated singular or plural form.

# _nx

Translates and retrieves the singular or plural form based on the supplied
number, with gettext context.

Related

Parameters

  • single string: The text to be used if the number is singular.
  • plural string: The text to be used if the number is plural.
  • number number: The number to compare against to use either the singular or plural form.
  • context string: Context information for the translators.
  • domain ?string: Domain to retrieve the translated text.

Returns

  • string: The translated singular or plural form.

# _x

Retrieve translated string with gettext context.

Related

Parameters

  • text string: Text to translate.
  • context string: Context information for the translators.
  • domain ?string: Domain to retrieve the translated text.

Returns

  • string: Translated context string without pipe.

# __

Retrieve the translation of text.

Related

Parameters

  • text string: Text to translate.
  • domain ?string: Domain to retrieve the translated text.

Returns

  • string: Translated text.

Code is Poetry.