Referencia de React
Ways
Root props
Propiedades raíz comunes:
| Prop | Tipo | Notas |
|---|---|---|
apiKey | cadena | Requerido. |
localización | cadena | Configuración regional actual. |
baseLocale | cadena | Idioma de origen. |
persistLocaleCookie | boolean | Política de cookies de localización predeterminada para el tiempo de ejecución raíz. |
context | cadena | objeto | Contexto raíz opcional. |
cacheTtl | número | TTL de caché para solicitudes de traducción. |
formateadorDeMensajes | 'waysParser' | 'ninguno' | fn | Anulación de analizador o formateador. |
suspenseTimeoutMs | número | Tiempo máximo de bloqueo de renderizado permitido antes de que continúe el renderizado de reserva. |
fetcher | typeof fetch | Implementación de búsqueda personalizada. |
localesAceptados | cadena[] | Lista de locales explícitos opcional. |
Scoped props
Los ámbitos anidados aceptan:
| Prop | Tipo | Notas |
|---|---|---|
context | cadena | objeto | Requerido. |
localización | cadena | Disponible, pero usa una raíz anidada para una sesión de configuración regional aislada. |
baseLocale | cadena | Anulación opcional de la configuración regional de origen para el subárbol. |
componentes | Registro<string, componente> | Componentes utilizados dentro del contenido traducible. |
T
T es el primitivo de traducción basado en JSX.
| Prop | Tipo | Notas |
|---|---|---|
niños | ReactNode | Requerido. |
vars | Registro<string, desconocido> | Entrada de interpolación. |
context | cadena | objeto | Anulación de contexto de hoja opcional. |
componentes | Registro<string, componente> | Mapeo de componentes para contenido enriquecido. |
fijo | boolean | Saltar la traducción para contenido fijo similar a marcas. |
useT()
useT() devuelve una función de traducción para cadenas, atributos y lógica.
const t = useT();
const label = t('Save changes');Ganchos de tiempo de ejecución
useTranslatedMemo()
Un valor memorizado que se recalcula 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 idiomas aceptados resuelta desde el entorno de ejecución raíz.
LanguageSwitcher
Propiedades comunes:
| Prop | Tipo | Notas |
|---|---|---|
currentLocale | cadena | Localización controlada. |
onLocaleChange | (locale) => vacío | Controlador de cambios. |
dirección | 'arriba' | 'abajo' | Dirección del menú. |
estilos / nombresDeClase | objeto | Anulaciones de estilo. |
sin estilo | boolean | Desactivar estilos integrados. |
Utility exports
@18ways/react también re-exporta:
fetchAcceptedLocalesfetchConfigresolverOrigen