Referencia de React

Ways

Root props

Propiedades raíz comunes:

PropTipoNotas
apiKeycadenaRequerido.
localizacióncadenaConfiguración regional actual.
baseLocalecadenaIdioma de origen.
persistLocaleCookiebooleanoPolítica de cookies de localización predeterminada para el tiempo de ejecución raíz.
contextocadena | objetoContexto raíz opcional.
cacheTtlnúmeroTTL de caché para solicitudes de traducción.
formateadorDeMensajes'waysParser' | 'ninguno' | fnAnulación de analizador o formateador.
suspenseTimeoutMsnúmeroEl tiempo máximo de bloqueo de renderizado permitido antes de que continúe el renderizado alternativo.
fetchertypeof fetchImplementación de búsqueda personalizada.
localesAceptadoscadena[]Lista de locales explícitos opcional.

Scoped props

Los ámbitos anidados aceptan:

PropTipoNotas
contextocadena | objetoRequerido.
localizacióncadenaDisponible, pero usa una raíz anidada para una sesión de configuración regional aislada.
baseLocalecadenaAnulación opcional de la configuración regional de origen para el subárbol.
componentesRegistro<string, componente>Componentes utilizados dentro del contenido traducible.

T

T es el primitivo de traducción que prioriza JSX.

PropTipoNotas
niñosReactNodeRequerido.
varsRegistro<string, desconocido>Entrada de interpolación.
contextocadena | objetoAnulación de contexto de hoja opcional.
componentesRegistro<string, componente>Mapeo de componentes para contenido enriquecido.
fijobooleanoOmitir la traducción de contenido fijo similar a marcas.

useT()

useT() devuelve una función de traducción para cadenas, atributos y lógica.

tsx
const t = useT();
const label = t('Save changes');

Ganchos de tiempo de ejecución

useTranslatedMemo()

Un valor memorizado que se recomputa cuando cambian las traducciones.

useTranslationLoading()

Devuelve true mientras el contexto actual aún se está cargando.

useCurrentLocale()

Lee la configuración regional seleccionada para el entorno de ejecución raíz actual.

useTargetLocale()

Lee la configuración regional de destino activa para el ámbito actual.

useBaseLocale()

Lee la configuración regional de origen para el runtime raíz actual.

useSetCurrentLocale()

Devuelve el setter para la configuración regional raíz en tiempo de ejecución.

useAcceptedLocales()

Lee la lista de configuraciones regionales aceptadas y resueltas desde el entorno de ejecución raíz.

LanguageSwitcher

Propiedades comunes:

PropTipoNotas
currentLocalecadenaLocalización controlada.
onLocaleChange(locale) => vacíoControlador de cambios.
dirección'arriba' | 'abajo'Dirección del menú.
estilos / nombresDeClaseobjetoSobrescrituras de estilo.
sin estilobooleanoDesactivar estilos integrados.

Utility exports

@18ways/react también re-exporta:

  • fetchAcceptedLocales
  • fetchConfig
  • resolverOrigen
Cambiando idioma
Referencia de React