Embed React Elements Inside Your I18next Translation Strings

Embed React Elements Inside Your I18next Translation Strings

i18next-react-postprocessor .embed React elements inside your i18next translation strings .because sometimes you just want to dump some JSX into your l10n'd text and don't want to be bothered with the whole react-i18next dog-and-pony show.

i18next-react-postprocessor

embed React elements inside your i18next translation strings

About

because sometimes you just want to dump some JSX into your l10n'd text and don't want to be bothered with the whole react-i18next dog-and-pony show.

Getting Started

$ npm install --save i18next-react-postprocessor

Usage

import the package in the usual way, and use a new instance of the exported class as i18next middleware:

import i18next from 'i18next';
import ReactPostprocessor from 'i18next-react-postprocessor';

i18next
  .use(new ReactPostprocessor())
  .init();

then when it's time to render translated strings, make sure you set the postProcess option to 'reactPostprocessor':

import i18next from 'i18next';
import React from 'react';

function MyComponent(props) {
  return (
    <div>
      {i18next.t(`myKey`, {
        postProcess: `reactPostprocessor`
      })}
    </div>
  );
}

or, if you're using it in more than just a few places, it might be worth adding to i18next's init options instead:

i18next
  .use(new ReactPostprocessor())
  .init({
    postProcess: [ `reactPostprocessor` ]
  });

// now you don't need to specify "postProcess: 'reactPostprocessor'" when calling i18next.t

the postprocessor by default looks for tokens delimited by <angleyBrackets> to perform interpolation of React elements:

i18next
  .use(new ReactPostprocessor())
  .init({
    lng: `en`,
    postProcess: [ `reactPostprocessor` ],
    resources: {
      en: {
        translation: {
          myKey: `just <clickHere> to do the things`
        }
      },
      fr: {
        translation: {
          myKey: `<clickHere> et voila`
        }
      }
    }
  });

element interpolation is done just like regular ol' string interpolation:

render() {
  return (
    <div>
      {i18next.t(`myKey`, {
        clickHere: ( <img onClick={() => console.log(`click!`)} src="pug.jpg" /> )
      })}
    </div>
  );
}

API

ReactPostprocessor({opts})

const middleware = new ReactPostprocessor({
  keepUnknownVariables: Boolean
  prefix: String
  suffix: String
});

all fields are optional.

keepUnknownVariables controls whether or not to preserve any interpolation tokens which aren't present in the options passed to i18next.t; it defaults to false (meaning tokens with no corresponding value are replaced with the empty string). prefix and suffix define the beginning and end of the interpolation token to look for; they default to '<' and '>' respectively.

Development & Example App

$ git clone https://www.github.com/orzechowskid/i18next-react-postprocessor
$ npm install
[ edit edit edit... ]
$ npm run example
$ open http://localhost:8080
[ verify verify verify... ]
$ npm run build

Testing

a full test suite is located in src/tests . npm run test should run jest --verbose --coverage.

Download Details:

Author: orzechowskid

Source Code: https://github.com/orzechowskid/i18next-react-postprocessor

reactjs javascript react

Bootstrap 5 Complete Course with Examples

Bootstrap 5 Tutorial - Bootstrap 5 Crash Course for Beginners

Nest.JS Tutorial for Beginners

Hello Vue 3: A First Look at Vue 3 and the Composition API

Building a simple Applications with Vue 3

Deno Crash Course: Explore Deno and Create a full REST API with Deno

How to Build a Real-time Chat App with Deno and WebSockets

Convert HTML to Markdown Online

HTML entity encoder decoder Online

How native is React Native? | React Native vs Native App Development

Article covers: How native is react native?, React Native vs (Ionic, Cordova), Similarities and difference between React Native and Native App Development.

Increase Performance of React Applications Via Array JavaScript Methods

Increase Performance of React Applications Via Array JavaScript Methods. We will create a simple event management application in the react to add, update, and delete an event.

Routing in React without React-Router

I have been using React JS in my projects for quite some time now and am used to managing routing in my app using the react-router package. I have always been keen on having as little dependencies in my apps as possible, so, I always felt perturbed by the use of this particular package in simpler apps which did not have complex routes.

The Ugly Side of React Hooks

In this post, I will share my own point of view about React Hooks, and as the title of this post implies, I am not a big fan.

ReactJS: The Javascript Developer’s Guide

This article will walk you through the concepts you would need to know to step into the world of widely used ReactJS.