React 参考

`Ways`

Root props

公共根属性：

道具	类型	笔记
`apiKey`	`字符串`	必填。
`区域设置`	`字符串`	当前目标区域设置。
`baseLocale`	`字符串`	源语言环境。
`persistLocaleCookie`	`布尔`	根运行时的默认区域设置 cookie 策略。
`上下文`	`字符串 \| 对象`	可选的根上下文。
`缓存生存时间`	`数字`	翻译请求的缓存生存时间（TTL）。
`消息格式化器`	`'waysParser' \| 'none' \| fn`	解析器或格式化程序覆盖。
`fetcher`	`typeof fetch`	自定义获取实现。
`acceptedLocales`	`字符串[]`	可选的显式区域设置列表。

Scoped props

嵌套作用域接受：

道具	类型	笔记
`上下文`	`字符串 \| 对象`	必填。
`区域设置`	`字符串`	可选的区域设置覆盖。
`baseLocale`	`字符串`	可选的基础区域设置覆盖。
`组件`	`记录<字符串, 组件>`	可在可翻译内容中使用的组件。

`T`

T 是 JSX 优先的翻译原语。

道具	类型	笔记
`儿童`	`ReactNode`	必填。
`变量`	`Record<string, unknown>`	插值输入。
`上下文`	`字符串 \| 对象`	可选的叶子上下文覆盖。
`组件`	`记录<字符串, 组件>`	丰富内容的组件映射。
`固定`	`布尔`	跳过固定品牌内容的翻译。

`useT()`

useT() 返回一个用于字符串、属性和逻辑的翻译函数。

tsx

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

运行时钩子

`useTranslatedMemo()`

一个在翻译更改时重新计算的备忘值。

`useTranslationLoading()`

在当前上下文仍在加载时返回 true。

`useCurrentLocale()`

读取根运行时区域设置。

`useSetCurrentLocale()`

返回根运行时区域设置的设置器。

`LanguageSwitcher`

常见属性：

道具	类型	笔记
`currentLocale`	`字符串`	受控区域。
`onLocaleChange`	`(locale) => 无返回值`	更改处理程序。
`方向`	`'上' \| '下'`	菜单方向。
`样式` / `类名`	对象	样式覆盖。
`未样式化`	`布尔`	禁用内置样式。

Utility exports

@18ways/react 还重新导出:

fetchAcceptedLocales
fetchConfig
resolveOrigin

React 参考

`Ways`

Root props

公共根属性：

道具	类型	笔记
`apiKey`	`字符串`	必填。
`区域设置`	`字符串`	当前目标区域设置。
`baseLocale`	`字符串`	源语言环境。
`persistLocaleCookie`	`布尔`	根运行时的默认区域设置 cookie 策略。
`上下文`	`字符串 \| 对象`	可选的根上下文。
`缓存生存时间`	`数字`	翻译请求的缓存生存时间（TTL）。
`消息格式化器`	`'waysParser' \| 'none' \| fn`	解析器或格式化程序覆盖。
`fetcher`	`typeof fetch`	自定义获取实现。
`acceptedLocales`	`字符串[]`	可选的显式区域设置列表。

Scoped props

嵌套作用域接受：

道具	类型	笔记
`上下文`	`字符串 \| 对象`	必填。
`区域设置`	`字符串`	可选的区域设置覆盖。
`baseLocale`	`字符串`	可选的基础区域设置覆盖。
`组件`	`记录<字符串, 组件>`	可在可翻译内容中使用的组件。

`T`

T 是 JSX 优先的翻译原语。

道具	类型	笔记
`儿童`	`ReactNode`	必填。
`变量`	`Record<string, unknown>`	插值输入。
`上下文`	`字符串 \| 对象`	可选的叶子上下文覆盖。
`组件`	`记录<字符串, 组件>`	丰富内容的组件映射。
`固定`	`布尔`	跳过固定品牌内容的翻译。

`useT()`

useT() 返回一个用于字符串、属性和逻辑的翻译函数。

tsx

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

运行时钩子

`useTranslatedMemo()`

一个在翻译更改时重新计算的备忘值。

`useTranslationLoading()`

在当前上下文仍在加载时返回 true。

`useCurrentLocale()`

读取根运行时区域设置。

`useSetCurrentLocale()`

返回根运行时区域设置的设置器。

`LanguageSwitcher`

常见属性：

道具	类型	笔记
`currentLocale`	`字符串`	受控区域。
`onLocaleChange`	`(locale) => 无返回值`	更改处理程序。
`方向`	`'上' \| '下'`	菜单方向。
`样式` / `类名`	对象	样式覆盖。
`未样式化`	`布尔`	禁用内置样式。

Utility exports

@18ways/react 还重新导出:

fetchAcceptedLocales
fetchConfig
resolveOrigin

React 参考

`Ways`

Root props

公共根属性：

道具	类型	笔记
`apiKey`	`字符串`	必填。
`区域设置`	`字符串`	当前目标区域设置。
`baseLocale`	`字符串`	源语言环境。
`persistLocaleCookie`	`布尔`	根运行时的默认区域设置 cookie 策略。
`上下文`	`字符串 \| 对象`	可选的根上下文。
`缓存生存时间`	`数字`	翻译请求的缓存生存时间（TTL）。
`消息格式化器`	`'waysParser' \| 'none' \| fn`	解析器或格式化程序覆盖。
`fetcher`	`typeof fetch`	自定义获取实现。
`acceptedLocales`	`字符串[]`	可选的显式区域设置列表。

Scoped props

嵌套作用域接受：

道具	类型	笔记
`上下文`	`字符串 \| 对象`	必填。
`区域设置`	`字符串`	可选的区域设置覆盖。
`baseLocale`	`字符串`	可选的基础区域设置覆盖。
`组件`	`记录<字符串, 组件>`	可在可翻译内容中使用的组件。

`T`

T 是 JSX 优先的翻译原语。

道具	类型	笔记
`儿童`	`ReactNode`	必填。
`变量`	`Record<string, unknown>`	插值输入。
`上下文`	`字符串 \| 对象`	可选的叶子上下文覆盖。
`组件`	`记录<字符串, 组件>`	丰富内容的组件映射。
`固定`	`布尔`	跳过固定品牌内容的翻译。

`useT()`

useT() 返回一个用于字符串、属性和逻辑的翻译函数。

tsx

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

运行时钩子

`useTranslatedMemo()`

一个在翻译更改时重新计算的备忘值。

`useTranslationLoading()`

在当前上下文仍在加载时返回 true。

`useCurrentLocale()`

读取根运行时区域设置。

`useSetCurrentLocale()`

返回根运行时区域设置的设置器。

`LanguageSwitcher`

常见属性：

道具	类型	笔记
`currentLocale`	`字符串`	受控区域。
`onLocaleChange`	`(locale) => 无返回值`	更改处理程序。
`方向`	`'上' \| '下'`	菜单方向。
`样式` / `类名`	对象	样式覆盖。
`未样式化`	`布尔`	禁用内置样式。

Utility exports

@18ways/react 还重新导出:

fetchAcceptedLocales
fetchConfig
resolveOrigin

React 参考

`Ways`

Root props

公共根属性：

道具	类型	笔记
`apiKey`	`字符串`	必填。
`区域设置`	`字符串`	当前目标区域设置。
`baseLocale`	`字符串`	源语言环境。
`persistLocaleCookie`	`布尔`	根运行时的默认区域设置 cookie 策略。
`上下文`	`字符串 \| 对象`	可选的根上下文。
`缓存生存时间`	`数字`	翻译请求的缓存生存时间（TTL）。
`消息格式化器`	`'waysParser' \| 'none' \| fn`	解析器或格式化程序覆盖。
`fetcher`	`typeof fetch`	自定义获取实现。
`acceptedLocales`	`字符串[]`	可选的显式区域设置列表。

Scoped props

嵌套作用域接受：

道具	类型	笔记
`上下文`	`字符串 \| 对象`	必填。
`区域设置`	`字符串`	可选的区域设置覆盖。
`baseLocale`	`字符串`	可选的基础区域设置覆盖。
`组件`	`记录<字符串, 组件>`	可在可翻译内容中使用的组件。

`T`

T 是 JSX 优先的翻译原语。

道具	类型	笔记
`儿童`	`ReactNode`	必填。
`变量`	`Record<string, unknown>`	插值输入。
`上下文`	`字符串 \| 对象`	可选的叶子上下文覆盖。
`组件`	`记录<字符串, 组件>`	丰富内容的组件映射。
`固定`	`布尔`	跳过固定品牌内容的翻译。

`useT()`

useT() 返回一个用于字符串、属性和逻辑的翻译函数。

tsx

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

运行时钩子

`useTranslatedMemo()`

一个在翻译更改时重新计算的备忘值。

`useTranslationLoading()`

在当前上下文仍在加载时返回 true。

`useCurrentLocale()`

读取根运行时区域设置。

`useSetCurrentLocale()`

返回根运行时区域设置的设置器。

`LanguageSwitcher`

常见属性：

道具	类型	笔记
`currentLocale`	`字符串`	受控区域。
`onLocaleChange`	`(locale) => 无返回值`	更改处理程序。
`方向`	`'上' \| '下'`	菜单方向。
`样式` / `类名`	对象	样式覆盖。
`未样式化`	`布尔`	禁用内置样式。

Utility exports

@18ways/react 还重新导出:

fetchAcceptedLocales
fetchConfig
resolveOrigin

React 参考

`Ways`

Root props

公共根属性：

道具	类型	笔记
`apiKey`	`字符串`	必填。
`区域设置`	`字符串`	当前目标区域设置。
`baseLocale`	`字符串`	源语言环境。
`persistLocaleCookie`	`布尔`	根运行时的默认区域设置 cookie 策略。
`上下文`	`字符串 \| 对象`	可选的根上下文。
`缓存生存时间`	`数字`	翻译请求的缓存生存时间（TTL）。
`消息格式化器`	`'waysParser' \| 'none' \| fn`	解析器或格式化程序覆盖。
`fetcher`	`typeof fetch`	自定义获取实现。
`acceptedLocales`	`字符串[]`	可选的显式区域设置列表。

Scoped props

嵌套作用域接受：

道具	类型	笔记
`上下文`	`字符串 \| 对象`	必填。
`区域设置`	`字符串`	可选的区域设置覆盖。
`baseLocale`	`字符串`	可选的基础区域设置覆盖。
`组件`	`记录<字符串, 组件>`	可在可翻译内容中使用的组件。

`T`

T 是 JSX 优先的翻译原语。

道具	类型	笔记
`儿童`	`ReactNode`	必填。
`变量`	`Record<string, unknown>`	插值输入。
`上下文`	`字符串 \| 对象`	可选的叶子上下文覆盖。
`组件`	`记录<字符串, 组件>`	丰富内容的组件映射。
`固定`	`布尔`	跳过固定品牌内容的翻译。

`useT()`

useT() 返回一个用于字符串、属性和逻辑的翻译函数。

tsx

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

运行时钩子

`useTranslatedMemo()`

一个在翻译更改时重新计算的备忘值。

`useTranslationLoading()`

在当前上下文仍在加载时返回 true。

`useCurrentLocale()`

读取根运行时区域设置。

`useSetCurrentLocale()`

返回根运行时区域设置的设置器。

`LanguageSwitcher`

常见属性：

道具	类型	笔记
`currentLocale`	`字符串`	受控区域。
`onLocaleChange`	`(locale) => 无返回值`	更改处理程序。
`方向`	`'上' \| '下'`	菜单方向。
`样式` / `类名`	对象	样式覆盖。
`未样式化`	`布尔`	禁用内置样式。

Utility exports

@18ways/react 还重新导出:

fetchAcceptedLocales
fetchConfig
resolveOrigin

React 参考

`Ways`

Root props

公共根属性：

道具	类型	笔记
`apiKey`	`字符串`	必填。
`区域设置`	`字符串`	当前目标区域设置。
`baseLocale`	`字符串`	源语言环境。
`persistLocaleCookie`	`布尔`	根运行时的默认区域设置 cookie 策略。
`上下文`	`字符串 \| 对象`	可选的根上下文。
`缓存生存时间`	`数字`	翻译请求的缓存生存时间（TTL）。
`消息格式化器`	`'waysParser' \| 'none' \| fn`	解析器或格式化程序覆盖。
`fetcher`	`typeof fetch`	自定义获取实现。
`acceptedLocales`	`字符串[]`	可选的显式区域设置列表。

Scoped props

嵌套作用域接受：

道具	类型	笔记
`上下文`	`字符串 \| 对象`	必填。
`区域设置`	`字符串`	可选的区域设置覆盖。
`baseLocale`	`字符串`	可选的基础区域设置覆盖。
`组件`	`记录<字符串, 组件>`	可在可翻译内容中使用的组件。

`T`

T 是 JSX 优先的翻译原语。

道具	类型	笔记
`儿童`	`ReactNode`	必填。
`变量`	`Record<string, unknown>`	插值输入。
`上下文`	`字符串 \| 对象`	可选的叶子上下文覆盖。
`组件`	`记录<字符串, 组件>`	丰富内容的组件映射。
`固定`	`布尔`	跳过固定品牌内容的翻译。

`useT()`

useT() 返回一个用于字符串、属性和逻辑的翻译函数。

tsx

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

运行时钩子

`useTranslatedMemo()`

一个在翻译更改时重新计算的备忘值。

`useTranslationLoading()`

在当前上下文仍在加载时返回 true。

`useCurrentLocale()`

读取根运行时区域设置。

`useSetCurrentLocale()`

返回根运行时区域设置的设置器。

`LanguageSwitcher`

常见属性：

道具	类型	笔记
`currentLocale`	`字符串`	受控区域。
`onLocaleChange`	`(locale) => 无返回值`	更改处理程序。
`方向`	`'上' \| '下'`	菜单方向。
`样式` / `类名`	对象	样式覆盖。
`未样式化`	`布尔`	禁用内置样式。

Utility exports

@18ways/react 还重新导出:

fetchAcceptedLocales
fetchConfig
resolveOrigin

React 参考

`Ways`

Root props

公共根属性：

道具	类型	笔记
`apiKey`	`字符串`	必填。
`区域设置`	`字符串`	当前目标区域设置。
`baseLocale`	`字符串`	源语言环境。
`persistLocaleCookie`	`布尔`	根运行时的默认区域设置 cookie 策略。
`上下文`	`字符串 \| 对象`	可选的根上下文。
`缓存生存时间`	`数字`	翻译请求的缓存生存时间（TTL）。
`消息格式化器`	`'waysParser' \| 'none' \| fn`	解析器或格式化程序覆盖。
`fetcher`	`typeof fetch`	自定义获取实现。
`acceptedLocales`	`字符串[]`	可选的显式区域设置列表。

Scoped props

嵌套作用域接受：

道具	类型	笔记
`上下文`	`字符串 \| 对象`	必填。
`区域设置`	`字符串`	可选的区域设置覆盖。
`baseLocale`	`字符串`	可选的基础区域设置覆盖。
`组件`	`记录<字符串, 组件>`	可在可翻译内容中使用的组件。

`T`

T 是 JSX 优先的翻译原语。

道具	类型	笔记
`儿童`	`ReactNode`	必填。
`变量`	`Record<string, unknown>`	插值输入。
`上下文`	`字符串 \| 对象`	可选的叶子上下文覆盖。
`组件`	`记录<字符串, 组件>`	丰富内容的组件映射。
`固定`	`布尔`	跳过固定品牌内容的翻译。

`useT()`

useT() 返回一个用于字符串、属性和逻辑的翻译函数。

tsx

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

运行时钩子

`useTranslatedMemo()`

一个在翻译更改时重新计算的备忘值。

`useTranslationLoading()`

在当前上下文仍在加载时返回 true。

`useCurrentLocale()`

读取根运行时区域设置。

`useSetCurrentLocale()`

返回根运行时区域设置的设置器。

`LanguageSwitcher`

常见属性：

道具	类型	笔记
`currentLocale`	`字符串`	受控区域。
`onLocaleChange`	`(locale) => 无返回值`	更改处理程序。
`方向`	`'上' \| '下'`	菜单方向。
`样式` / `类名`	对象	样式覆盖。
`未样式化`	`布尔`	禁用内置样式。

Utility exports

@18ways/react 还重新导出:

fetchAcceptedLocales
fetchConfig
resolveOrigin