Creation:2026-09-19Last update:2026-09-19
将此文档参考到您的 AI 助手ChatGPTClaudeDeepSeekGoogle AI modeGeminiPerplexityMistralGrok
使用您最喜欢的AI助手总结文档,并引用此页面和AI提供商
版本历史
- "useLocale 钩子初始文档"v9.5.52026/9/19
此页面的内容已使用 AI 翻译。
查看英文原文的最新版本编辑此文档
如果您有改善此文档的想法,请随时通过在GitHub上提交拉取请求来贡献。
文档的 GitHub 链接Copy
复制文档 Markdown 到剪贴板
useLocale 钩子文档
remix-intlayer 中的 useLocale 钩子提供对当前正在处理的 HTTP 请求的语言环境,以及项目中配置的默认语言环境和可用语言环境的访问。
使用方法
在 Remix 组件中(例如语言切换器):
src/components/LocaleSwitcher.tsx
复制代码
复制代码到剪贴板
在路由处理程序中:
src/server.ts
复制代码
复制代码到剪贴板
返回值
该钩子返回一个 UseLocaleResult 类型的对象:
显示表格的所有内容
在弹窗中打开表格以清晰地查看所有数据
| 属性 | 类型 | 描述 |
|---|---|---|
locale | DeclaredLocales | 为当前请求解析出的语言环境。 |
defaultLocale | DeclaredLocales | 在 intlayer.config.ts 中配置的默认回退语言环境。 |
availableLocales | DeclaredLocales[] | 在 intlayer.config.ts 中配置的所有可用语言环境的数组。 |
说明
- 请求作用域解析: 在由
intlayer()中间件处理的活动请求中,useLocale从请求存储中读取解析出的语言环境。 - 平滑回退 (Fallback): 如果在请求上下文之外调用(例如在初始化脚本或测试套件中),它将默认返回配置的
defaultLocale。
