Guide · Nästling av nycklar
Som standard delar Sonenta upp dina nycklar på . till ett nästlat JSON-träd i CDN-bunten — den klassiska i18next-formen. Det är perfekt för organiserade nycklar som checkout.review.confirm, men det förvanskar tyst nycklar vars text innehåller en punkt. Den här guiden täcker projektinställningen och det motsvarande SDK-alternativet så att dina uppslagningar alltid löses.
En nyckel är bara en sträng. När den strängen innehåller en bokstavlig punkt — en version som App Version 6.3.8, ett pris, ett filnamn, en bibelhänvisning som Jean 3.16 — förvandlar uppdelningen på . en nyckel till ett oavsiktligt nästlat objekt. Översättningen lagras fortfarande, men t("App Version 6.3.8") hittar den inte längre.
bundle.json 1// your source key — a literal label with dots in it2{ "App Version 6.3.8": "App Version 6.3.8" } 4// nested bundle (default) — split on "." → broken tree5{ "App Version 6": { "3": { "8": "App Version 6.3.8" } } } 7// flat bundle — the key stays literal, lookups just work8{ "App Version 6.3.8": "App Version 6.3.8" }Två inställningar på projektnivå styr hur CDN-bunten formas. Standardvärdena återskapar det nuvarande i18next-beteendet, så befintliga projekt påverkas inte förrän du väljer att aktivera det.
| Inställning | Värden | Standard |
|---|---|---|
| bundle_key_style | nested | flat | nested |
| bundle_key_separator | string | "." |
Ställ in dem på projektet — i din dashboards projektinställningar, eller via projekt-API:t. Den valda stilen bakas in i varje release, och varje publicerad version rapporterar tillbaka den, så att vilken klient som helst kan självkonfigurera sig.
versions/main 1# the version object reports the active key style2GET /v1/projects/<project_uuid>/versions/main 4{ "slug": "main", "key_style": "flat", "key_separator": "." }Nycklar delas aldrig — var och en lagras och slås upp bokstavligt. Välj detta när dina nycklar innehåller punkter eller är naturlig text: versioner, priser, filnamn, bibel- eller juridiska hänvisningar. App Version 6.3.8 förblir exakt det.
Nycklar delas på separatorn till ett JSON-träd — det klassiska i18next-upplägget. Välj detta för avsiktligt namespace-indelade nycklar som checkout.review.confirm. Detta är standardvärdet.
@sonenta/react-i18next (>= 0.11.0) tar ett keySeparator-alternativ: false för bokstavliga / platta uppslagningar, en sträng för nästlat, standard ".". Det finns också nsSeparator (standard ":"). SDK:t är bokstavligt först — det provar en exakt bundle[key]-matchning före all uppdelning, så nycklar med punkter löses även i nästlat läge. Vid start() autodetekterar det också key_style / key_separator från den publicerade versionen (best-effort).
main.tsx 1// src/main.tsx — match the bundle in @sonenta/react-i18next >= 0.11.02import { SonentaProvider } from "@sonenta/react-i18next"; 4<SonentaProvider5 projectUuid="<project_uuid>"6 token={import.meta.env.VITE_SONENTA_TOKEN}7 keySeparator={false} // literal lookup — for dotted / natural-text keys8 nsSeparator=":" // default; set false to disable ns parsing too9>10 <App />11</SonentaProvider> 13// then t() treats the whole string as one key — no splitting14t("App Version 6.3.8"); // ✓ exact matchAutodetekteringen läser versionsmetadata och behöver en nyckel med project:read. Om den läsningen nekas (403) faller SDK:t tillbaka snyggt på sina standardvärden — så vid tveksamhet, sätt keySeparator explicit för att matcha din bunt i stället för att förlita dig på detektering.
bundle_key_style: flat på projektet och keySeparator={false} i SDK:t. Bokstavligt i båda ändar — inga överraskningar. checkout.review.confirm)? Behåll den nästlade standarden; inget att ändra.