Lokalisering
React Aria har en rad inbyggda funktioner som underlättar skapandet av tillgängliga och internationella användargränssnitt. Midas komponenter, som bygger på React Aria uppdateras automatiskt när språkmiljön ändras. Detta innebär att din applikation kan anpassa sig dynamiskt till olika språk utan alltför mycket manuell handpåläggning. För mer ingående dokumentation, se React Aria Internationalization.
useLocale
För att säkerställa att lokalisering fungerar bör useLocale
användas i root av applikationen. På så sätt får
du tillgång till browserns språkinställning. Normalt fungerar locale
utan att hämta in den explicit men för till
exempel SSR bör useLocale
användas, se React Aria för referens.
import {useLocale} from 'react-aria-components';
function YourApp() {
let {locale, direction} = useLocale();
return (
<div lang={locale} dir={direction}>
{/* your app here */}
</div>
);
}
Nuvarande språk | Nuvarande textriktning |
---|---|
en-US | ltr |
I18nProvider
Om det finns behov av att skriva över användarens inställningar går det att använda I18nProvider
från React Aria.
Via I18nProvider går det att styra beteendet för datum och tidsrelaterade komponenter men inte ta kontroll över felmeddelanden
eller annan information, det sätts via browsern.
<I18nProvider locale={locale}>
<DateField/>
</I18nProvider>
useMessageFormatter
För att översätta eller anpassa enskilda strängar finns useMessageFormatter. Motsvarande för siffror och valutor är useNumberFormatter.
Midas komponenter
Officiellt har Midas inte fullt stöd för flera språk men i utgångsläget fungerar de flesta komponenter och respekterar användarens inställningar i browsern. Framtida uppdateringar eller nya komponenter bygger på React Arias ramverk så den allmänna rekommendationen är att använda metoder och hooks därifrån för att lösa eventuella lokaliseringsproblem. Buggrapport eller Feature requests kan skapas via