Slik implementerer du internasjonalisering i en Next.js-applikasjon som bruker Pages 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 forskjellige land og kulturer. En av nøkkelmetodene for å oppnå dette er internasjonalisering (i18n), som lar deg tilpasse applikasjonen din til ulike språk, valutaer og datoformater.
I denne veiledningen skal vi se på hvordan du legger til internasjonalisering i din React Next.js-applikasjon, med server-side rendering. TL;DR: Se hele eksempelet her.
Denne veiledningen gjelder Next.js-applikasjoner som bruker Pages Router.
Hvis du bruker App 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, inkludert next-intl. I dette eksempelet bruker vi imidlertid TacoTranslate.
TacoTranslate oversetter automatisk strengene dine til alle språk ved hjelp av banebrytende KI, og frigjør deg fra den tidkrevende håndteringen av JSON-filer.
La oss installere det med npm i terminalen din:
npm install tacotranslateSteg 2: Opprett en gratis TacoTranslate-konto
Nå som du har installert modulen, er det på tide å opprette en TacoTranslate-konto, et oversettelsesprosjekt og tilhørende API-nøkler. Opprett en konto her. Det er gratis, og du trenger ikke å oppgi et kredittkort.
Opprett et prosjekt i brukergrensesnittet til TacoTranslate, 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.
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 ekstra miljøvariabler: 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 tekststrengene 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_DEFAULT_LOCALE ?? '',
});
module.exports = tacoTranslate;Vi kommer snart til å definere TACOTRANSLATE_API_KEY automatisk.
Ved å opprette klienten i en separat fil blir det enklere å bruke den igjen senere. Nå skal vi, ved hjelp av en egendefinert /pages/_app.tsx, legge til TacoTranslate-leverandøren.
import React from 'react';
import {type AppProps} from 'next/app';
import {type Origin, type Locale, type Localizations} from 'tacotranslate';
import TacoTranslate from 'tacotranslate/react';
import TacoTranslateHead from 'tacotranslate/next/head';
import tacoTranslate from '../tacotranslate-client';
type PageProperties = {
origin: Origin;
locale: Locale;
locales: Locale[];
localizations: Localizations;
};
export default function App({Component, pageProps}: AppProps<PageProperties>) {
const {origin, locale, locales, localizations} = pageProps;
return (
<TacoTranslate
client={tacoTranslate}
origin={origin}
locale={locale}
localizations={localizations}
>
<TacoTranslateHead rootUrl="https://your-website.com" locales={locales} />
<Component {...pageProps} />
</TacoTranslate>
);
}Hvis du allerede har egendefinerte pageProps og _app.tsx, kan du utvide definisjonen med egenskapene og koden ovenfor.
Trinn 4: Implementering av server-side rendering
TacoTranslate støtter gjengivelse av oversettelsene dine på serversiden. Dette forbedrer brukeropplevelsen betraktelig ved å vise oversatt innhold 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 alle oversettelsene vi trenger.
Vi begynner med å opprette eller endre /next.config.js.
const withTacoTranslate = require('tacotranslate/next/config').default;
const tacoTranslateClient = require('./tacotranslate-client');
module.exports = async () => {
const config = {};
return withTacoTranslate(config, {
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'),
});
};Endre isProduction‑sjekken slik at den passer for ditt oppsett. Hvis true, vil TacoTranslate vise den offentlige API‑nøkkelen. Hvis vi er i et lokalt, test- eller stagingmiljø (isProduction is false), vil vi bruke den hemmelige read/write API‑nøkkelen for å sørge for at nye strenger sendes for oversettelse.
Frem til nå har vi bare satt opp Next.js-applikasjonen med en liste over støttede språk. Neste steg er å hente oversettelser for alle sidene dine. For å gjøre det vil du bruke enten getTacoTranslateStaticProps eller getTacoTranslateServerSideProps avhengig av kravene dine.
Disse funksjonene tar tre argumenter: ett Next.js Static Props Context‑objekt, konfigurasjon for TacoTranslate, og valgfrie Next.js‑egenskaper. Merk at revalidate på getTacoTranslateStaticProps er satt til 60 som standard, slik at oversettelsene dine holdes oppdatert.
For å bruke en av funksjonene i en side, la oss anta at du har en sidefil som /pages/hello-world.tsx.
import {Translate} from 'tacotranslate/react';
import getTacoTranslateStaticProps from 'tacotranslate/next/get-static-props';
import tacoTranslateClient from '../tacotranslate-client';
export async function getStaticProps(context) {
return getTacoTranslateStaticProps(context, {client: tacoTranslateClient});
}
export default function Page() {
return <Translate string="Hello, world!"/>;
}Du skal nå kunne bruke Translate‑komponenten til å oversette tekststrenger i alle React-komponentene dine.
import {Translate} from 'tacotranslate/react';
function Component() {
return <Translate string="Hello, world!"/>
}Steg 5: Distribuer og test!
Vi er ferdige! React-applikasjonen din blir nå automatisk oversatt når du legger til strenger i en Translate -komponent. Vær oppmerksom på at bare miljøer med read/write -tillatelser for API-nøkkelen vil kunne opprette nye strenger som skal oversettes. Vi anbefaler at du har et lukket og sikkert staging-miljø der du kan teste produksjonsapplikasjonen med en slik API-nøkkel, og legge til nye strenger før du går live. Dette vil hindre at noen stjeler den hemmelige API-nøkkelen din og potensielt fyller oversettelsesprosjektet ditt med nye, uvedkommende strenger.
Husk å sjekke ut det komplette eksemplet på vår GitHub-profil. Der finner du også et eksempel på hvordan du gjør dette ved å bruke App Router! Hvis du støter på problemer, ikke nøl med å ta kontakt, så hjelper vi deg mer enn gjerne.
TacoTranslate lar deg automatisk lokalisere React-applikasjonene dine raskt til og fra mer enn 75 språk. Kom i gang i dag!