Slik implementerer du internasjonalisering i en Next.js-applikasjon som bruker App Router
Gjør React-applikasjonen din mer tilgjengelig og nå nye markeder med internasjonalisering (i18n).
Etter hvert som verden blir mer globalisert, blir det stadig viktigere for webutviklere å bygge applikasjoner som kan imøtekomme brukere fra ulike land og kulturer. En av de viktigste måtene å oppnå dette på er gjennom internasjonalisering (i18n), som lar deg tilpasse applikasjonen din til forskjellige språk, valutaer og datoformater.
I denne artikkelen skal vi se på hvordan du legger til internasjonalisering i din React Next.js-applikasjon, med rendering på serversiden. TL;DR: Se hele eksemplet her.
Denne veiledningen gjelder Next.js-applikasjoner som bruker App Router.
Hvis du bruker Pages Router, kan du se denne veiledningen i stedet.
Steg 1: Installer et i18n-bibliotek
For å implementere internasjonalisering i Next.js-applikasjonen din, velger vi først et i18n-bibliotek. Det finnes flere populære biblioteker, blant annet next-intl. I dette eksempelet bruker vi imidlertid TacoTranslate.
TacoTranslate oversetter automatisk strengene dine til alle språk ved hjelp av banebrytende KI, og fritar deg fra den tidkrevende håndteringen av JSON-filer.
La oss installere det med npm i terminalen din:
npm install tacotranslateTrinn 2: Opprett en gratis TacoTranslate-konto
Nå som du har installert modulen, er det på tide å opprette TacoTranslate-kontoen din, et oversettelsesprosjekt og de tilhørende API-nøklene. Opprett en konto her. Det er gratis, og du trenger ikke å legge inn et kredittkort.
Opprett et prosjekt i TacoTranslate-applikasjonens brukergrensesnitt, og gå til fanen for API-nøkler. Opprett én read-nøkkel og én read/write-nøkkel. Vi lagrer dem som miljøvariabler. read-nøkkelen kaller vi public, og read/write-nøkkelen kaller vi secret. Du kan for eksempel legge dem til i en .env-fil i roten av prosjektet ditt.
TACOTRANSLATE_PUBLIC_API_KEY=123456
TACOTRANSLATE_SECRET_API_KEY=789010Pass på at du aldri eksponerer den hemmelige read/write API-nøkkelen i produksjonsmiljøer på klientsiden.
Vi legger også til to miljøvariabler til: TACOTRANSLATE_DEFAULT_LOCALE og TACOTRANSLATE_ORIGIN.
TACOTRANSLATE_DEFAULT_LOCALE: Standard reservekode for lokalitet. I dette eksempelet setter vi den tilenfor engelsk.TACOTRANSLATE_ORIGIN: «Mappen» der strengene dine lagres, for eksempel nettadressen til nettstedet ditt. Les mer om origins her.
TACOTRANSLATE_DEFAULT_LOCALE=en
TACOTRANSLATE_ORIGIN=your-website-url.comTrinn 3: Konfigurere TacoTranslate
For å integrere TacoTranslate med applikasjonen din må du opprette en klient ved hjelp av API-nøklene fra tidligere. Opprett for eksempel en fil med navnet /tacotranslate-client.js.
const {default: createTacoTranslateClient} = require('tacotranslate');
const tacoTranslate = createTacoTranslateClient({
apiKey:
process.env.TACOTRANSLATE_SECRET_API_KEY ??
process.env.TACOTRANSLATE_PUBLIC_API_KEY ??
process.env.TACOTRANSLATE_API_KEY,
projectLocale:
process.env.TACOTRANSLATE_IS_PRODUCTION === 'true'
? process.env.TACOTRANSLATE_PROJECT_LOCALE
: undefined,
});
module.exports = tacoTranslate;Vi kommer snart til å definere TACOTRANSLATE_API_KEY og TACOTRANSLATE_PROJECT_LOCALE automatisk.
Å opprette klienten i en egen fil gjør det enkelt å bruke den igjen senere. getLocales er bare en hjelpefunksjon med innebygd feilhåndtering. Opprett nå en fil med navnet /app/[locale]/tacotranslate.tsx, hvor vi skal implementere TacoTranslate provideren.
'use client';
import React, {type ReactNode} from 'react';
import {
type TranslationContextProperties,
TacoTranslate as ImportedTacoTranslate,
} from 'tacotranslate/react';
import tacoTranslateClient from '@/tacotranslate-client';
export default function TacoTranslate({
locale,
origin,
localizations,
children,
}: TranslationContextProperties & {
readonly children: ReactNode;
}) {
return (
<ImportedTacoTranslate
client={tacoTranslateClient}
locale={locale}
origin={origin}
localizations={localizations}
>
{children}
</ImportedTacoTranslate>
);
}Merk at 'use client'; angir at dette er en klientkomponent.
Når kontekstleverandøren er klar til bruk, oppretter du en fil med navnet /app/[locale]/layout.tsx, som er rotlayouten i applikasjonen vår. Merk at denne banen inneholder en mappe som bruker Dynamic Routes, der [locale] er den dynamiske parameteren.
import React, {type ReactNode} from 'react';
import {type Locale, isRightToLeftLocaleCode} from 'tacotranslate';
import './global.css';
import tacoTranslateClient from '@/tacotranslate-client';
import TacoTranslate from './tacotranslate';
export async function generateStaticParams() {
const locales = await tacoTranslateClient.getLocales();
return locales.map((locale) => ({locale}));
}
type RootLayoutParameters = {
readonly params: Promise<{locale: Locale}>;
readonly children: ReactNode;
};
export default async function RootLayout({params, children}: RootLayoutParameters) {
const {locale} = await params;
const origin = process.env.TACOTRANSLATE_ORIGIN;
const localizations = await tacoTranslateClient.getLocalizations({
locale,
origins: [origin /* , other origins to fetch */],
});
return (
<html lang={locale} dir={isRightToLeftLocaleCode(locale) ? 'rtl' : 'ltr'}>
<body>
<TacoTranslate
locale={locale}
origin={origin}
localizations={localizations}
>
{children}
</TacoTranslate>
</body>
</html>
);
}Det første du bør merke deg her, er at vi bruker Dynamic Route-parameteren [locale] til å hente oversettelser for dette språket. I tillegg sørger generateStaticParams for at alle lokalkodene du har aktivert for prosjektet, forhåndsgenereres.
La oss nå bygge vår første side! Opprett en fil med navnet /app/[locale]/page.tsx.
import React from 'react';
import {Translate} from 'tacotranslate/react';
export const revalidate = 60;
export default async function Page() {
return (
<Translate string="Hello, world!" />
);
}Legg merke til revalidate-variabelen, som forteller Next.js å bygge siden på nytt etter 60 sekunder og holde oversettelsene dine oppdaterte.
Trinn 4: Implementering av serverside-rendering
TacoTranslate støtter gjengivelse på serversiden. Dette forbedrer brukeropplevelsen betraktelig ved å vise det oversatte innholdet umiddelbart, i stedet for først å vise et kort øyeblikk med uoversatt innhold. I tillegg kan vi hoppe over nettverksforespørsler på klientsiden, fordi vi allerede har oversettelsene vi trenger for siden brukeren ser på.
For å konfigurere gjengivelse på serversiden, opprett eller endre /next.config.js:
const withTacoTranslate = require('tacotranslate/next/config').default;
const tacoTranslateClient = require('./tacotranslate-client');
module.exports = async () => {
const config = await withTacoTranslate(
{},
{
client: tacoTranslateClient,
isProduction:
process.env.TACOTRANSLATE_ENV === 'production' ||
process.env.VERCEL_ENV === 'production' ||
(!(process.env.TACOTRANSLATE_ENV || process.env.VERCEL_ENV) &&
process.env.NODE_ENV === 'production'),
}
);
// NOTE: Remove i18n from config when using the app router
return {...config, i18n: undefined};
};Endre sjekken isProduction slik at den passer ditt oppsett. Hvis true, vil TacoTranslate gjøre den offentlige API-nøkkelen tilgjengelig. Hvis vi er i et lokalt, test- eller staging-miljø (isProduction is false), vil vi bruke den hemmelige read/write API-nøkkelen for å sørge for at nye strenger sendes til oversettelse.
For å sikre at ruting og omdirigering fungerer som forventet, må vi opprette en fil med navnet /middleware.ts. Ved hjelp av Middleware kan vi omdirigere brukere til sider som vises på det foretrukne språket deres.
import {type NextRequest} from 'next/server';
import {middleware as tacoTranslateMiddleware} from 'tacotranslate/next';
import tacoTranslate from '@/tacotranslate-client';
export const config = {
matcher: ['/((?!api|_next|favicon.ico).*)'],
};
export async function middleware(request: NextRequest) {
return tacoTranslateMiddleware(tacoTranslate, request);
}Sørg for å konfigurere matcher i samsvar med dokumentasjonen for Next.js Middleware.
På klientsiden kan du endre locale-informasjonskapselen for å endre brukerens foretrukne språk. Se den komplette eksempelkoden for ideer til hvordan dette kan gjøres!
Trinn 5: Distribuer og test!
Vi er ferdige! React-applikasjonen din vil nå bli oversatt automatisk når du legger til tekststrenger i en Translatekomponent. Merk at bare miljøer med read/writetillatelser for API-nøkkelen kan opprette nye tekststrenger som skal oversettes. Vi anbefaler å ha et lukket og sikkert staging-miljø der du kan teste produksjonsapplikasjonen med en slik API-nøkkel og legge til nye tekststrenger før lansering. Dette hindrer at noen stjeler den hemmelige API-nøkkelen din og potensielt fyller opp oversettelsesprosjektet ditt med nye, irrelevante tekststrenger.
Be sure to check out the complete example over at our GitHub profile. There, you’ll also find an example of how to do this using the Pages Router! If you encounter any problems, feel free to reach out, and we’ll be more than happy to help.
TacoTranslate lets you automatically localize your React applications quickly to and from over 75 languages. Get started today!