@lingui/react
Advanced tools
@lingui/react is a library for internationalization (i18n) in React applications. It provides tools to manage translations, pluralization, and formatting of messages, making it easier to support multiple languages in your app.
Translation
This feature allows you to translate text in your React application. The `Trans` component is used to display translated messages based on the active locale.
import { I18nProvider, Trans } from '@lingui/react';
import { i18n } from '@lingui/core';
import { messages } from './locales/en/messages';
i18n.load('en', messages);
i18n.activate('en');
function App() {
return (
<I18nProvider i18n={i18n}>
<Trans id="hello" />
</I18nProvider>
);
}Pluralization
This feature handles pluralization of messages. The `Plural` component allows you to display different messages based on the count of items.
import { I18nProvider, Plural } from '@lingui/react';
import { i18n } from '@lingui/core';
import { messages } from './locales/en/messages';
i18n.load('en', messages);
i18n.activate('en');
function App() {
const itemCount = 5;
return (
<I18nProvider i18n={i18n}>
<Plural
value={itemCount}
one="{itemCount} item"
other="{itemCount} items"
/>
</I18nProvider>
);
}Message Formatting
This feature allows you to format messages with dynamic values. The `Trans` component can take a `values` prop to insert dynamic content into the translated message.
import { I18nProvider, Trans } from '@lingui/react';
import { i18n } from '@lingui/core';
import { messages } from './locales/en/messages';
i18n.load('en', messages);
i18n.activate('en');
function App() {
const userName = 'John';
return (
<I18nProvider i18n={i18n}>
<Trans id="welcome" values={{ name: userName }} />
</I18nProvider>
);
}react-intl is a popular library for internationalization in React applications. It provides components and an API to format dates, numbers, and strings, and to handle pluralization and translations. Compared to @lingui/react, react-intl has a larger community and more extensive documentation, but @lingui/react offers a more modern and flexible approach to message management.
i18next is a powerful internationalization framework that can be used with various JavaScript libraries, including React. It offers a wide range of features, such as language detection, interpolation, and pluralization. While i18next is more versatile and can be used outside of React, @lingui/react is specifically designed for React applications, making it easier to integrate and use within a React project.
react-i18next is a React binding for i18next, providing components and hooks to use i18next in React applications. It offers similar functionalities to @lingui/react, such as translation, pluralization, and context-based translations. However, @lingui/react has a more streamlined API and better integration with modern React features like hooks.
React components for internationalization
@lingui/react is part of LinguiJS. See the documentation for all information, tutorials and examples.
npm install --save @lingui/react
# yarn add @lingui/react
See the tutorial or reference documentation.
4.0.0 (2023-04-xx)
i18n._ / i18n.t calls (#1586)defineMessage + short alias (#1495)messageId and support order by message (#1515)i18._(foo.bar) without warning (#1492)i18n.setCatalogAndActivate for easier nextjs integration (#1541)process.env.LINGUI_CONFIG (#1447)Intl.PluralRules instead of i18n.loadLocaleData (#1486)other as required for ChoiceOptions (#1527)defaultProps from Trans component (#1494)I18nProvider (#1501)withI18n (#1503)arg macro (#1581)FAQs
React components for translations
The npm package @lingui/react receives a total of 139,890 weekly downloads. As such, @lingui/react popularity was classified as popular.
We found that @lingui/react demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 2 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Research
An advanced npm supply chain attack is leveraging Ethereum smart contracts for decentralized, persistent malware control, evading traditional defenses.
Security News
Research
Attackers are impersonating Sindre Sorhus on npm with a fake 'chalk-node' package containing a malicious backdoor to compromise developers' projects.
Security News
The npm package for the LottieFiles Player web component was hit with a supply chain attack after a software engineer's npmjs credentials were compromised.