{t('description.part4')}
}{t('description.part2')}
;
8 | }
9 |
--------------------------------------------------------------------------------
/example/react_native_windows/macos/react_native_windows-macOS/AppDelegate.h:
--------------------------------------------------------------------------------
1 | #import {t('description.part3')}
;
6 | }
7 |
8 | export default withTranslation()(CustomComponent);
9 |
--------------------------------------------------------------------------------
/example/react_native_windows/android/gradle/wrapper/gradle-wrapper.properties:
--------------------------------------------------------------------------------
1 | distributionBase=GRADLE_USER_HOME
2 | distributionPath=wrapper/dists
3 | distributionUrl=https\://services.gradle.org/distributions/gradle-6.2-all.zip
4 | zipStoreBase=GRADLE_USER_HOME
5 | zipStorePath=wrapper/dists
6 |
--------------------------------------------------------------------------------
/example/react_native_windows/ios/react_native_windows/AppDelegate.h:
--------------------------------------------------------------------------------
1 | #import {t('some.key', { some: 'variable' })}
;
8 | }
9 |
--------------------------------------------------------------------------------
/example/react-icu/src/setupTests.js:
--------------------------------------------------------------------------------
1 | // jest-dom adds custom jest matchers for asserting on DOM nodes.
2 | // allows you to do things like:
3 | // expect(element).toHaveTextContent(/react/i)
4 | // learn more: https://github.com/testing-library/jest-dom
5 | import '@testing-library/jest-dom/extend-expect';
6 |
--------------------------------------------------------------------------------
/example/react_native_windows/macos/react_native_windows-iOS/main.m:
--------------------------------------------------------------------------------
1 | #import description.part4
)).toBe(true);
10 | });
11 |
--------------------------------------------------------------------------------
/example/ReactNativeLocizeProject/ios/ReactNativeLocizeProject.xcworkspace/contents.xcworkspacedata:
--------------------------------------------------------------------------------
1 |
2 |
9 |
10 | description.part5 description.bold
11 |
12 |
13 | );
14 | }
15 |
--------------------------------------------------------------------------------
/example/ReactNativeLocizeProject/android/app/src/main/res/values/styles.xml:
--------------------------------------------------------------------------------
1 | description.part2
)).toBe(true);
10 | });
11 |
--------------------------------------------------------------------------------
/test/typescript/misc/useSSR.test.tsx:
--------------------------------------------------------------------------------
1 | import { it, expectTypeOf } from 'vitest';
2 | import { useSSR } from 'react-i18next';
3 | import { Resource } from 'i18next';
4 |
5 | it('useSSR', () => {
6 | expectTypeOf(useSSR).parameter(0).toEqualTypeOf
8 |
11 | );
12 | }
13 |
14 | export default Comp2;
15 |
--------------------------------------------------------------------------------
/example/react-typescript/simple/src/i18n/en/translation.json:
--------------------------------------------------------------------------------
1 | {
2 | "title": "Welcome {{name}}, to react using react-i18next fully type-safe",
3 | "description": {
4 | "part1": "This is a simple example.",
5 | "part2": "😉"
6 | },
7 | "userMessagesUnread_one": "You have {{count}} unread message.",
8 | "userMessagesUnread_other": "You have {{count}} unread messages."
9 | }
10 |
--------------------------------------------------------------------------------
/example/react/public/manifest.json:
--------------------------------------------------------------------------------
1 | {
2 | "short_name": "React App",
3 | "name": "Create React App Sample",
4 | "icons": [
5 | {
6 | "src": "favicon.ico",
7 | "sizes": "192x192",
8 | "type": "image/png"
9 | }
10 | ],
11 | "start_url": "./index.html",
12 | "display": "standalone",
13 | "theme_color": "#000000",
14 | "background_color": "#ffffff"
15 | }
16 |
--------------------------------------------------------------------------------
/example/react/src/index.js:
--------------------------------------------------------------------------------
1 | import React from 'react';
2 | import { createRoot } from 'react-dom/client';
3 | import './index.css';
4 | import App from './App';
5 |
6 | // import i18n (needs to be bundled ;))
7 | import './i18n';
8 |
9 | const root = createRoot(document.getElementById('root'));
10 | root.render(
11 | {t('description.part1')}
9 |{t('description.part2')}
10 |description.part3
)).toBe(true);
10 | });
11 |
--------------------------------------------------------------------------------
/example/ReactNativeProject/locales/de/translation.json:
--------------------------------------------------------------------------------
1 | {
2 | "description": {
3 | "part1": "Um loszulegen, ändere <1>src/App(DE).js speichern und neu laden.",
4 | "part2": "Ändere die Sprachen zwischen deutsch und englisch mit Hilfe der beiden Buttons."
5 | },
6 | "new": {
7 | "key": "Dies wird automatisch hinzugefügt"
8 | },
9 | "title": "Willkommen zu React"
10 | }
11 |
--------------------------------------------------------------------------------
/example/locize/public/manifest.json:
--------------------------------------------------------------------------------
1 | {
2 | "short_name": "React App",
3 | "name": "Create React App Sample",
4 | "icons": [
5 | {
6 | "src": "favicon.ico",
7 | "sizes": "192x192",
8 | "type": "image/png"
9 | }
10 | ],
11 | "start_url": "./index.html",
12 | "display": "standalone",
13 | "theme_color": "#000000",
14 | "background_color": "#ffffff"
15 | }
16 |
--------------------------------------------------------------------------------
/test/i18nNoLng.js:
--------------------------------------------------------------------------------
1 | import i18n from 'i18next';
2 |
3 | // set instance on hooks stuff
4 | import { setI18n } from '../src/context';
5 |
6 | setI18n(i18n);
7 |
8 | i18n.init({
9 | defaultNS: 'ns1',
10 | resources: {
11 | ns1: {
12 | testString: 'This has an interpolated
8 |
12 | );
13 | }
14 |
15 | export default Comp1;
16 |
--------------------------------------------------------------------------------
/example/test-jest/public/manifest.json:
--------------------------------------------------------------------------------
1 | {
2 | "short_name": "React App",
3 | "name": "Create React App Sample",
4 | "icons": [
5 | {
6 | "src": "favicon.ico",
7 | "sizes": "64x64 32x32 24x24 16x16",
8 | "type": "image/x-icon"
9 | }
10 | ],
11 | "start_url": "./index.html",
12 | "display": "standalone",
13 | "theme_color": "#000000",
14 | "background_color": "#ffffff"
15 | }
16 |
--------------------------------------------------------------------------------
/example/ReactNativeLocizeProject/android/settings.gradle:
--------------------------------------------------------------------------------
1 | pluginManagement { includeBuild("../node_modules/@react-native/gradle-plugin") }
2 | plugins { id("com.facebook.react.settings") }
3 | extensions.configure(com.facebook.react.ReactSettingsExtension){ ex -> ex.autolinkLibrariesFromCommand() }
4 | rootProject.name = 'ReactNativeLocizeProject'
5 | include ':app'
6 | includeBuild('../node_modules/@react-native/gradle-plugin')
7 |
--------------------------------------------------------------------------------
/example/react-typescript/simple-multi-namespaces/src/components/Comp3.tsx:
--------------------------------------------------------------------------------
1 | import { useTranslation } from 'react-i18next';
2 |
3 | function Comp2() {
4 | const { t } = useTranslation(['ns1', 'ns2']);
5 |
6 | return (
7 | {t('title')}
9 |{t('description.part1')}
10 |{t('description.part2')}
11 |
8 |
11 | );
12 | }
13 |
14 | export default Comp2;
15 |
--------------------------------------------------------------------------------
/example/react-icu/.gitignore:
--------------------------------------------------------------------------------
1 | # See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
2 |
3 | # dependencies
4 | /node_modules
5 | /.pnp
6 | .pnp.js
7 |
8 | # testing
9 | /coverage
10 |
11 | # production
12 | /build
13 |
14 | # misc
15 | .DS_Store
16 | .env.local
17 | .env.development.local
18 | .env.test.local
19 | .env.production.local
20 |
21 | npm-debug.log*
22 | yarn-debug.log*
23 | yarn-error.log*
24 |
--------------------------------------------------------------------------------
/example/react-icu/src/index.css:
--------------------------------------------------------------------------------
1 | body {
2 | margin: 0;
3 | font-family:
4 | -apple-system, BlinkMacSystemFont, 'Segoe UI', 'Roboto', 'Oxygen', 'Ubuntu', 'Cantarell',
5 | 'Fira Sans', 'Droid Sans', 'Helvetica Neue', sans-serif;
6 | -webkit-font-smoothing: antialiased;
7 | -moz-osx-font-smoothing: grayscale;
8 | }
9 |
10 | code {
11 | font-family: source-code-pro, Menlo, Monaco, Consolas, 'Courier New', monospace;
12 | }
13 |
--------------------------------------------------------------------------------
/example/react-typescript/simple/src/@types/i18next.d.ts:
--------------------------------------------------------------------------------
1 | import resources from './resources';
2 |
3 | declare module 'i18next' {
4 | interface CustomTypeOptions {
5 | resources: typeof resources;
6 | // if you see an error like: "Argument of type 'DefaultTFuncReturn' is not assignable to parameter of type xyz"
7 | // set returnNull to false (and also in the i18next init options)
8 | // returnNull: false;
9 | }
10 | }
11 |
--------------------------------------------------------------------------------
/example/storybook/.gitignore:
--------------------------------------------------------------------------------
1 | # See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
2 |
3 | # dependencies
4 | /node_modules
5 | /.pnp
6 | .pnp.js
7 |
8 | # testing
9 | /coverage
10 |
11 | # production
12 | /build
13 |
14 | # misc
15 | .DS_Store
16 | .env.local
17 | .env.development.local
18 | .env.test.local
19 | .env.production.local
20 |
21 | npm-debug.log*
22 | yarn-debug.log*
23 | yarn-error.log*
24 |
--------------------------------------------------------------------------------
/example/react-typescript/simple-multi-namespaces/src/App.tsx:
--------------------------------------------------------------------------------
1 | import './i18n/config';
2 | import Comp1 from './components/Comp1';
3 | import Comp2 from './components/Comp2';
4 | import Comp3 from './components/Comp3';
5 |
6 | function App() {
7 | return (
8 | {t('description.part1', { ns: 'ns1' })}
9 |{t('description.part2', { ns: 'ns2' })}
10 |
9 |
11 |
13 |
15 | );
16 | }
17 |
18 | export default App;
19 |
--------------------------------------------------------------------------------
/example/react-fluent/public/locales/en/translations.ftl:
--------------------------------------------------------------------------------
1 | title = Welcome to react using react-i18next with fluent
2 |
3 | description_1 = To get started, edit <1>src/App.js and save to reload.
4 | description_2 = Switch language between english and german using buttons above.
5 |
6 | emails =
7 | { $unreadEmails ->
8 | [one] You have <1>one unread email.
9 | *[other] You have <1>{ $unreadEmails } unread emails.
10 | }
--------------------------------------------------------------------------------
/example/react-typescript/simple/.gitignore:
--------------------------------------------------------------------------------
1 | # See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
2 |
3 | # dependencies
4 | /node_modules
5 | /.pnp
6 | .pnp.js
7 |
8 | # testing
9 | /coverage
10 |
11 | # production
12 | /build
13 |
14 | # misc
15 | .DS_Store
16 | .env.local
17 | .env.development.local
18 | .env.test.local
19 | .env.production.local
20 |
21 | npm-debug.log*
22 | yarn-debug.log*
23 | yarn-error.log*
24 |
--------------------------------------------------------------------------------
/example/react-typescript/simple/src/index.css:
--------------------------------------------------------------------------------
1 | body {
2 | margin: 0;
3 | font-family:
4 | -apple-system, BlinkMacSystemFont, 'Segoe UI', 'Roboto', 'Oxygen', 'Ubuntu', 'Cantarell',
5 | 'Fira Sans', 'Droid Sans', 'Helvetica Neue', sans-serif;
6 | -webkit-font-smoothing: antialiased;
7 | -moz-osx-font-smoothing: grayscale;
8 | }
9 |
10 | code {
11 | font-family: source-code-pro, Menlo, Monaco, Consolas, 'Courier New', monospace;
12 | }
13 |
--------------------------------------------------------------------------------
/example/react_native_windows/windows/react_native_windows/AutolinkedNativeModules.g.h:
--------------------------------------------------------------------------------
1 | // AutolinkedNativeModules.g.h contents generated by "react-native autolink-windows"
2 |
3 | #pragma once
4 |
5 | namespace winrt::Microsoft::ReactNative
6 | {
7 |
8 | void RegisterAutolinkedNativeModulePackages(winrt::Windows::Foundation::Collections::IVector11 |
13 |
{t('hello')}
;
10 | }
11 |
12 | export function MyCompFromOtherLib() {
13 | return (
14 |
11 |
15 | You have {{ count }} unread message.
16 |
17 |
18 | );
19 | }
20 |
21 | export default App;
22 |
--------------------------------------------------------------------------------
/example/razzle-ssr/src/index.js:
--------------------------------------------------------------------------------
1 | import express from 'express';
2 | import app from './server';
3 |
4 | if (module.hot) {
5 | module.hot.accept('./server', function () {
6 | console.log('🔁 HMR Reloading `./server`...');
7 | });
8 | console.info('✅ Server-side HMR Enabled!');
9 | }
10 |
11 | const port = process.env.PORT || 3000;
12 |
13 | export default express()
14 | .use((req, res) => app.handle(req, res))
15 | .listen(port, function (err) {
16 | if (err) {
17 | console.error(err);
18 | return;
19 | }
20 | console.log(`> Started on port ${port}`);
21 | });
22 |
--------------------------------------------------------------------------------
/example/ReactNativeProject/Gemfile:
--------------------------------------------------------------------------------
1 | source 'https://rubygems.org'
2 |
3 | # You may use http://rbenv.org/ or https://rvm.io/ to install and use this version
4 | ruby ">= 2.6.10"
5 |
6 | # Exclude problematic versions of cocoapods and activesupport that causes build failures.
7 | gem 'cocoapods', '>= 1.13', '!= 1.15.0', '!= 1.15.1'
8 | gem 'activesupport', '>= 6.1.7.5', '!= 7.1.0'
9 | gem 'xcodeproj', '< 1.26.0'
10 | gem 'concurrent-ruby', '< 1.3.4'
11 |
12 | # Ruby 3.4.0 has removed some libraries from the standard library.
13 | gem 'bigdecimal'
14 | gem 'logger'
15 | gem 'benchmark'
16 | gem 'mutex_m'
17 |
--------------------------------------------------------------------------------
/example/ReactNativeLocizeProject/Gemfile:
--------------------------------------------------------------------------------
1 | source 'https://rubygems.org'
2 |
3 | # You may use http://rbenv.org/ or https://rvm.io/ to install and use this version
4 | ruby ">= 2.6.10"
5 |
6 | # Exclude problematic versions of cocoapods and activesupport that causes build failures.
7 | gem 'cocoapods', '>= 1.13', '!= 1.15.0', '!= 1.15.1'
8 | gem 'activesupport', '>= 6.1.7.5', '!= 7.1.0'
9 | gem 'xcodeproj', '< 1.26.0'
10 | gem 'concurrent-ruby', '< 1.3.4'
11 |
12 | # Ruby 3.4.0 has removed some libraries from the standard library.
13 | gem 'bigdecimal'
14 | gem 'logger'
15 | gem 'benchmark'
16 | gem 'mutex_m'
17 |
--------------------------------------------------------------------------------
/example/react_native_windows/windows/react_native_windows/ReactPackageProvider.h:
--------------------------------------------------------------------------------
1 | #pragma once
2 |
3 | #include "winrt/Microsoft.ReactNative.h"
4 |
5 |
6 | namespace winrt::react_native_windows::implementation
7 | {
8 | struct ReactPackageProvider : winrt::implements{t('title', { name: 'John' })}
12 |{t('description.part1')}
13 |{t('description.part2')}
14 |{t('key1')}
}
22 | test
23 |
24 | `);
25 | });
26 | });
27 |
--------------------------------------------------------------------------------
/example/react_native_windows/windows/react_native_windows/App.h:
--------------------------------------------------------------------------------
1 | #pragma once
2 |
3 | #include "App.xaml.g.h"
4 |
5 | namespace activation = winrt::Windows::ApplicationModel::Activation;
6 |
7 | namespace winrt::react_native_windows::implementation
8 | {
9 | struct App : AppTsome.key
)).toBe(true);
24 |
25 | // If you want you can also check how the t function has been called,
26 | // but basically this is testing your mock and not the actual code.
27 | expect(tSpy).toHaveBeenCalledTimes(1);
28 | expect(tSpy).toHaveBeenLastCalledWith('some.key', { some: 'variable' });
29 | });
30 |
--------------------------------------------------------------------------------
/example/react_native_windows/package.json:
--------------------------------------------------------------------------------
1 | {
2 | "name": "react_native_windows",
3 | "version": "0.0.1",
4 | "private": true,
5 | "scripts": {
6 | "android": "react-native run-android",
7 | "ios": "react-native run-ios",
8 | "start": "react-native start",
9 | "start:macos": "react-native run-macos",
10 | "start:windows": "react-native run-macos",
11 | "test": "jest",
12 | "lint": "eslint ."
13 | },
14 | "dependencies": {
15 | "i18next": "20.0.0",
16 | "react": "16.13.1",
17 | "react-i18next": "11.7.3",
18 | "react-native": "0.63.3",
19 | "react-native-macos": "^0.62.0-0",
20 | "react-native-windows": "^0.63.0-0"
21 | },
22 | "devDependencies": {
23 | "@babel/core": "^7.8.4",
24 | "@babel/runtime": "^7.8.4",
25 | "@react-native-community/eslint-config": "^1.1.0",
26 | "babel-jest": "^25.1.0",
27 | "eslint": "^6.5.1",
28 | "jest": "^25.1.0",
29 | "metro-react-native-babel-preset": "^0.59.0",
30 | "react-test-renderer": "16.13.1"
31 | },
32 | "jest": {
33 | "preset": "react-native"
34 | }
35 | }
36 |
--------------------------------------------------------------------------------
/src/index.js:
--------------------------------------------------------------------------------
1 | export { Trans } from './Trans.js';
2 | export { Trans as TransWithoutContext } from './TransWithoutContext.js';
3 | export { IcuTrans } from './IcuTrans.js';
4 | export { IcuTransWithoutContext } from './IcuTransWithoutContext.js';
5 | export { useTranslation } from './useTranslation.js';
6 | export { withTranslation } from './withTranslation.js';
7 | export { Translation } from './Translation.js';
8 | export { I18nextProvider } from './I18nextProvider.js';
9 | export { withSSR } from './withSSR.js';
10 | export { useSSR } from './useSSR.js';
11 | export { initReactI18next } from './initReactI18next.js';
12 | export { setDefaults, getDefaults } from './defaults.js';
13 | export { setI18n, getI18n } from './i18nInstance.js';
14 |
15 | export { I18nContext, composeInitialProps, getInitialProps } from './context.js';
16 |
17 | // dummy functions for icu.macro support
18 |
19 | export const date = () => '';
20 | export const time = () => '';
21 | export const number = () => '';
22 | export const select = () => '';
23 | export const plural = () => '';
24 | export const selectOrdinal = () => '';
25 |
--------------------------------------------------------------------------------
/example/storybook/src/stories/components.stories.js:
--------------------------------------------------------------------------------
1 | import React, { Component, Suspense } from 'react';
2 | import { useTranslation, withTranslation, Trans } from 'react-i18next';
3 |
4 | class ClassComponent extends Component {
5 | render() {
6 | const { t } = this.props;
7 | return {t('title')}
; 8 | } 9 | } 10 | 11 | const ComponentUsingHOC = withTranslation()(ClassComponent); 12 | 13 | function ComponentUsingHook() { 14 | const { t } = useTranslation(); 15 | return{t('description.part2')}
;
16 | }
17 |
18 | function ComponentUsingTrans() {
19 | return (
20 | src/App.js and save to reload.
22 |
11 |
33 | );
34 | }
35 |
36 | export default Home;
37 |
--------------------------------------------------------------------------------
/test/unescape.spec.js:
--------------------------------------------------------------------------------
1 | import { describe, it, expect } from 'vitest';
2 | import { unescape } from '../src/unescape';
3 |
4 | describe('unescape', () => {
5 | /** @type {[string, string]} */
6 | const testCases = [
7 | ['&', '&'],
8 | ['&', '&'],
9 | ['<', '<'],
10 | ['<', '<'],
11 | ['>', '>'],
12 | ['>', '>'],
13 | [''', "'"],
14 | [''', "'"],
15 | ['"', '"'],
16 | ['"', '"'],
17 | [' ', ' '],
18 | [' ', ' '],
19 | ['©', '©'],
20 | ['©', '©'],
21 | ['®', '®'],
22 | ['®', '®'],
23 | ['…', '…'],
24 | ['…', '…'],
25 | ['/', '/'],
26 | ['/', '/'],
27 | ];
28 |
29 | testCases.forEach(([value, expected]) => {
30 | it(`should unescape "${value}" to "${expected}"`, () => {
31 | expect(unescape(value)).toStrictEqual(expected);
32 | });
33 | });
34 |
35 | it('should unescape long strings', () => {
36 | expect(unescape(testCases.map((test) => test[0]).join(' '))).toStrictEqual(
37 | testCases.map((test) => test[1]).join(' '),
38 | );
39 | });
40 | });
41 |
--------------------------------------------------------------------------------
/LICENSE:
--------------------------------------------------------------------------------
1 | The MIT License (MIT)
2 |
3 | Copyright (c) 2025 i18next
4 |
5 | Permission is hereby granted, free of charge, to any person obtaining a copy
6 | of this software and associated documentation files (the "Software"), to deal
7 | in the Software without restriction, including without limitation the rights
8 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9 | copies of the Software, and to permit persons to whom the Software is
10 | furnished to do so, subject to the following conditions:
11 |
12 | The above copyright notice and this permission notice shall be included in all
13 | copies or substantial portions of the Software.
14 |
15 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21 | SOFTWARE.
22 |
23 |
--------------------------------------------------------------------------------
/test/typescript/selector-custom-types/i18next.d.ts:
--------------------------------------------------------------------------------
1 | import 'i18next';
2 |
3 | declare module 'i18next' {
4 | interface CustomTypeOptions {
5 | defaultNS: 'custom';
6 | allowObjectInHTMLChildren: true;
7 | enableSelector: true;
8 | resources: {
9 | custom: {
10 | foo: 'foo';
11 | bar: 'bar';
12 |
13 | some: 'some';
14 | some_me: 'some context';
15 | };
16 |
17 | alternate: {
18 | baz: 'baz';
19 | foobar: {
20 | barfoo: 'barfoo';
21 | deep: {
22 | deeper: {
23 | deeeeeper: 'foobar';
24 | };
25 | };
26 | };
27 | };
28 |
29 | plurals: {
30 | foo_zero: 'foo';
31 | foo_one: 'foo';
32 | foo_two: 'foo';
33 | foo_many: 'foo';
34 | foo_other: 'foo';
35 | };
36 |
37 | context: {
38 | dessert_cake: 'a nice cake';
39 | dessert_muffin_one: 'a nice muffin';
40 | dessert_muffin_other: '{{count}} nice muffins';
41 |
42 | beverage: 'beverage';
43 | beverage_beer: 'beer';
44 | };
45 | };
46 | }
47 | }
48 |
--------------------------------------------------------------------------------
/example/ReactNativeLocizeProject/ios/ReactNativeLocizeProject/Images.xcassets/AppIcon.appiconset/Contents.json:
--------------------------------------------------------------------------------
1 | {
2 | "images": [
3 | {
4 | "idiom": "iphone",
5 | "scale": "2x",
6 | "size": "20x20"
7 | },
8 | {
9 | "idiom": "iphone",
10 | "scale": "3x",
11 | "size": "20x20"
12 | },
13 | {
14 | "idiom": "iphone",
15 | "scale": "2x",
16 | "size": "29x29"
17 | },
18 | {
19 | "idiom": "iphone",
20 | "scale": "3x",
21 | "size": "29x29"
22 | },
23 | {
24 | "idiom": "iphone",
25 | "scale": "2x",
26 | "size": "40x40"
27 | },
28 | {
29 | "idiom": "iphone",
30 | "scale": "3x",
31 | "size": "40x40"
32 | },
33 | {
34 | "idiom": "iphone",
35 | "scale": "2x",
36 | "size": "60x60"
37 | },
38 | {
39 | "idiom": "iphone",
40 | "scale": "3x",
41 | "size": "60x60"
42 | },
43 | {
44 | "idiom": "ios-marketing",
45 | "scale": "1x",
46 | "size": "1024x1024"
47 | }
48 | ],
49 | "info": {
50 | "author": "xcode",
51 | "version": 1
52 | }
53 | }
54 |
--------------------------------------------------------------------------------
/example/react-fluent/package.json:
--------------------------------------------------------------------------------
1 | {
2 | "name": "react_fluent_withhoc",
3 | "version": "0.1.0",
4 | "private": true,
5 | "dependencies": {
6 | "i18next": "^23.12.3",
7 | "i18next-browser-languagedetector": "^8.0.0",
8 | "i18next-fluent": "^2.0.0",
9 | "i18next-fluent-backend": "^1.0.0",
10 | "react": "^18.3.1",
11 | "react-dom": "^18.3.1",
12 | "react-i18next": "^15.0.1",
13 | "react-scripts": "^5.0.1"
14 | },
15 | "devDependencies": {
16 | "babel-plugin-macros": "^3.1.0"
17 | },
18 | "scripts": {
19 | "start": "react-scripts start",
20 | "build": "react-scripts build",
21 | "test": "react-scripts test --env=jsdom",
22 | "eject": "react-scripts eject"
23 | },
24 | "eslintConfig": {
25 | "extends": [
26 | "react-app",
27 | "react-app/jest"
28 | ]
29 | },
30 | "browserslist": {
31 | "development": [
32 | "last 2 chrome versions",
33 | "last 2 firefox versions",
34 | "last 2 edge versions"
35 | ],
36 | "production": [
37 | ">1%",
38 | "last 4 versions",
39 | "Firefox ESR",
40 | "not ie < 11"
41 | ]
42 | }
43 | }
44 |
--------------------------------------------------------------------------------
/example/ReactNativeProject/android/app/src/main/AndroidManifest.xml:
--------------------------------------------------------------------------------
1 |
12 | 
13 |
15 | {t('message.welcome')}
14 |
16 |
17 | To get started, edit
20 |
21 | src/App.js or src/Home.js and save to
18 | reload.
19 | -
22 |
- 23 | Docs 24 | 25 |
- 26 | Issues 27 | 28 |
- 29 | Community Slack 30 | 31 |
{t('deepKey1')}
;
22 | }
23 | }
24 |
25 | it('should render correct content', () => {
26 | const HocElement = withTranslation('translation', { keyPrefix: 'deepPath' })(
27 | TestComponentKeyPrefix,
28 | );
29 | const { container } = render(
32 | value1
33 |
34 | `);
35 | });
36 | });
37 |
--------------------------------------------------------------------------------
/example/react-typescript/simple-multi-namespaces/package.json:
--------------------------------------------------------------------------------
1 | {
2 | "name": "simple-multi-namespaces",
3 | "version": "1.0.0",
4 | "private": true,
5 | "dependencies": {
6 | "i18next": "^23.12.3",
7 | "react": "^18.3.1",
8 | "react-dom": "^18.3.1",
9 | "react-i18next": "^15.0.1"
10 | },
11 | "devDependencies": {
12 | "@types/react": "^18.3.3",
13 | "@types/react-dom": "^18.3.0",
14 | "i18next-resources-for-ts": "^1.5.0",
15 | "react-scripts": "^5.0.1",
16 | "typescript": "^5.5.4"
17 | },
18 | "scripts": {
19 | "start": "react-scripts start",
20 | "build": "react-scripts build",
21 | "eject": "react-scripts eject",
22 | "i18next-resources-for-ts": "i18next-resources-for-ts toc -i ./src/i18n/en -o ./src/@types/resources.ts"
23 | },
24 | "eslintConfig": {
25 | "extends": [
26 | "react-app"
27 | ]
28 | },
29 | "browserslist": {
30 | "production": [
31 | ">0.2%",
32 | "not dead",
33 | "not op_mini all"
34 | ],
35 | "development": [
36 | "last 1 chrome version",
37 | "last 1 firefox version",
38 | "last 1 safari version"
39 | ]
40 | }
41 | }
42 |
--------------------------------------------------------------------------------
/src/Trans.js:
--------------------------------------------------------------------------------
1 | import { useContext } from 'react';
2 | import { nodesToString, Trans as TransWithoutContext } from './TransWithoutContext.js';
3 | import { getI18n, I18nContext } from './context.js';
4 |
5 | export { nodesToString };
6 |
7 | export function Trans({
8 | children,
9 | count,
10 | parent,
11 | i18nKey,
12 | context,
13 | tOptions = {},
14 | values,
15 | defaults,
16 | components,
17 | ns,
18 | i18n: i18nFromProps,
19 | t: tFromProps,
20 | shouldUnescape,
21 | ...additionalProps
22 | }) {
23 | const { i18n: i18nFromContext, defaultNS: defaultNSFromContext } = useContext(I18nContext) || {};
24 | const i18n = i18nFromProps || i18nFromContext || getI18n();
25 |
26 | const t = tFromProps || i18n?.t.bind(i18n);
27 |
28 | return TransWithoutContext({
29 | children,
30 | count,
31 | parent,
32 | i18nKey,
33 | context,
34 | tOptions,
35 | values,
36 | defaults,
37 | components,
38 | // prepare having a namespace
39 | ns: ns || t?.ns || defaultNSFromContext || i18n?.options?.defaultNS,
40 | i18n,
41 | t: tFromProps,
42 | shouldUnescape,
43 | ...additionalProps,
44 | });
45 | }
46 |
--------------------------------------------------------------------------------
/test/backendLngAwareMock.js:
--------------------------------------------------------------------------------
1 | export class BackendLngAwareMock {
2 | constructor(services, options = {}) {
3 | this.init(services, options);
4 | this.type = 'backend';
5 | this.queue = [];
6 | }
7 |
8 | init(services, options) {
9 | this.services = services;
10 | this.options = options;
11 | }
12 |
13 | read(language, namespace, callback) {
14 | this.queue.push({ language, namespace, callback });
15 | }
16 |
17 | flush(what) {
18 | let q = [...this.queue];
19 | if (what) {
20 | const filterFor = [];
21 | if (what.language) filterFor.push('language');
22 | if (what.namespace) filterFor.push('namespace');
23 | if (filterFor.length > 0) {
24 | q = q.filter((item) => {
25 | const allOk = filterFor.map((ff) => item[ff] === what[ff]).every((r) => r);
26 | if (allOk) return true;
27 | return false;
28 | });
29 | }
30 | }
31 |
32 | q.forEach((item) => {
33 | this.queue.splice(this.queue.indexOf(item), 1);
34 |
35 | item.callback(null, {
36 | key1: `${item.language}/${item.namespace} for key1`,
37 | });
38 | });
39 | }
40 | }
41 |
--------------------------------------------------------------------------------
/example/react_native_windows/android/app/src/main/AndroidManifest.xml:
--------------------------------------------------------------------------------
1 |