i18next-browser-languageDetector

i18next-browser-languageDetector

i18next浏览器多语言检测插件

i18next-browser-languageDetector是一款浏览器语言检测插件,支持cookie、localStorage、navigator等多种检测方式。该插件易于集成,提供灵活配置,允许自定义检测顺序和缓存策略。它还支持添加自定义检测功能,为多语言网站开发提供便捷解决方案。

i18next语言检测插件浏览器国际化多语言支持Github开源项目

简介

npm 版本

这是一个用于在浏览器中检测用户语言的 i18next 语言检测插件,支持以下方式:

  • cookie(设置 cookie i18next=LANGUAGE)
  • sessionStorage(设置键 i18nextLng=LANGUAGE)
  • localStorage(设置键 i18nextLng=LANGUAGE)
  • navigator(设置浏览器语言)
  • querystring(在 URL 后附加 ?lng=LANGUAGE
  • htmlTag(添加 HTML 语言标签 <html lang="LANGUAGE" ...)
  • path(http://my.site.com/LANGUAGE/...)
  • subdomain(http://LANGUAGE.site.com/...)

入门

可以通过 npm、bower 加载源代码,或从本仓库下载

# npm 包
$ npm install i18next-browser-languagedetector

# bower
$ bower install i18next-browser-languagedetector
  • 如果您不使用模块加载器,它将被添加到 window.i18nextBrowserLanguageDetector

连接方式:

import i18next from 'i18next'; import LanguageDetector from 'i18next-browser-languagedetector'; i18next.use(LanguageDetector).init({ supportedLngs: ['de', 'en', 'fr'], ...i18nextOptions });

与所有模块一样,您可以将构造函数(类)传递给 i18next.use 或传递给具体实例。

supportedLngs 是可选的,但允许 i18next 从检测到的语言列表中选择最佳匹配。如果未设置,则 language 将被设置为第一个检测到的语言,无论您的应用程序是否有该语言的翻译。

检测器选项

默认选项可以在这里找到。

{ // 检测用户语言的顺序和来源 order: ['querystring', 'cookie', 'localStorage', 'sessionStorage', 'navigator', 'htmlTag', 'path', 'subdomain'], // 用于查找语言的键或参数 lookupQuerystring: 'lng', lookupCookie: 'i18next', lookupLocalStorage: 'i18nextLng', lookupSessionStorage: 'i18nextLng', lookupFromPathIndex: 0, lookupFromSubdomainIndex: 0, // 缓存用户语言的位置 caches: ['localStorage', 'cookie'], excludeCacheFor: ['cimode'], // 不持久化的语言(cookie、localStorage) // 可选的 cookie 过期时间和域名 cookieMinutes: 10, cookieDomain: 'myDomain', // 可选的带有 lang 属性的 htmlTag,默认为: htmlTag: document.documentElement, // 可选的设置 cookie 选项,参考:[MDN Set-Cookie 文档](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Set-Cookie) cookieOptions: { path: '/', sameSite: 'strict' }, // 可选的用于修改检测到的语言代码的转换函数 convertDetectedLanguage: 'Iso15897', convertDetectedLanguage: (lng) => lng.replace('-', '_') }

可以通过以下方式传递选项:

推荐 - 在 i18next.init 中设置 options.detection:

import i18next from 'i18next'; import LanguageDetector from 'i18next-browser-languagedetector'; i18next.use(LanguageDetector).init({ detection: options, });

在构造时:

import LanguageDetector from 'i18next-browser-languagedetector'; const languageDetector = new LanguageDetector(null, options);

通过调用 init:

import LanguageDetector from 'i18next-browser-languagedetector'; const languageDetector = new LanguageDetector(); languageDetector.init(options);

添加自定义检测功能

接口

export default { name: 'myDetectorsName', lookup(options) { // options -> 传入的选项 return 'en'; }, cacheUserLanguage(lng, options) { // options -> 传入的选项 // lng -> 当前语言,将在初始化和更改语言时调用 // 存储它 }, };

添加方法

import LanguageDetector from 'i18next-browser-languagedetector'; const languageDetector = new LanguageDetector(); languageDetector.addDetector(myDetector); i18next.use(languageDetector).init({ detection: options, });

请注意:您必须将检测器的名称(在本例中为 myDetectorsName)添加到 options 对象中的 order 数组中。否则,您的检测器将不会被使用。详见检测器选项部分


<h3 align="center">金牌赞助商</h3> <p align="center"> <a href="https://locize.com/" target="_blank"> <img src="https://yellow-cdn.veclightyear.com/0a4dffa0/a86c2e36-a70d-407d-a0ac-b0f3972245d5.gif" width="240px"> </a> </p>

本地化即服务 - locize.com

需要翻译管理?想要使用上下文编辑器编辑翻译?使用 i18next 维护者为您提供的原始服务!

locize

使用 locize 可以直接支持 i18next 和 react-i18next 的未来发展。


编辑推荐精选

TRAE编程

TRAE编程

AI辅助编程,代码自动修复

Trae是一种自适应的集成开发环境(IDE),通过自动化和多元协作改变开发流程。利用Trae,团队能够更快速、精确地编写和部署代码,从而提高编程效率和项目交付速度。Trae具备上下文感知和代码自动完成功能,是提升开发效率的理想工具。

AI工具TraeAI IDE协作生产力转型热门
商汤小浣熊

商汤小浣熊

最强AI数据分析助手

小浣熊家族Raccoon,您的AI智能助手,致力于通过先进的人工智能技术,为用户提供高效、便捷的智能服务。无论是日常咨询还是专业问题解答,小浣熊都能以快速、准确的响应满足您的需求,让您的生活更加智能便捷。

imini AI

imini AI

像人一样思考的AI智能体

imini 是一款超级AI智能体,能根据人类指令,自主思考、自主完成、并且交付结果的AI智能体。

Keevx

Keevx

AI数字人视频创作平台

Keevx 一款开箱即用的AI数字人视频创作平台,广泛适用于电商广告、企业培训与社媒宣传,让全球企业与个人创作者无需拍摄剪辑,就能快速生成多语言、高质量的专业视频。

即梦AI

即梦AI

一站式AI创作平台

提供 AI 驱动的图片、视频生成及数字人等功能,助力创意创作

扣子-AI办公

扣子-AI办公

AI办公助手,复杂任务高效处理

AI办公助手,复杂任务高效处理。办公效率低?扣子空间AI助手支持播客生成、PPT制作、网页开发及报告写作,覆盖科研、商业、舆情等领域的专家Agent 7x24小时响应,生活工作无缝切换,提升50%效率!

蛙蛙写作

蛙蛙写作

AI小说写作助手,一站式润色、改写、扩写

蛙蛙写作—国内先进的AI写作平台,涵盖小说、学术、社交媒体等多场景。提供续写、改写、润色等功能,助力创作者高效优化写作流程。界面简洁,功能全面,适合各类写作者提升内容品质和工作效率。

AI辅助写作AI工具蛙蛙写作AI写作工具学术助手办公助手营销助手AI助手
问小白

问小白

全能AI智能助手,随时解答生活与工作的多样问题

问小白,由元石科技研发的AI智能助手,快速准确地解答各种生活和工作问题,包括但不限于搜索、规划和社交互动,帮助用户在日常生活中提高效率,轻松管理个人事务。

热门AI助手AI对话AI工具聊天机器人
Transly

Transly

实时语音翻译/同声传译工具

Transly是一个多场景的AI大语言模型驱动的同声传译、专业翻译助手,它拥有超精准的音频识别翻译能力,几乎零延迟的使用体验和支持多国语言可以让你带它走遍全球,无论你是留学生、商务人士、韩剧美剧爱好者,还是出国游玩、多国会议、跨国追星等等,都可以满足你所有需要同传的场景需求,线上线下通用,扫除语言障碍,让全世界的语言交流不再有国界。

讯飞智文

讯飞智文

一键生成PPT和Word,让学习生活更轻松

讯飞智文是一个利用 AI 技术的项目,能够帮助用户生成 PPT 以及各类文档。无论是商业领域的市场分析报告、年度目标制定,还是学生群体的职业生涯规划、实习避坑指南,亦或是活动策划、旅游攻略等内容,它都能提供支持,帮助用户精准表达,轻松呈现各种信息。

AI办公办公工具AI工具讯飞智文AI在线生成PPTAI撰写助手多语种文档生成AI自动配图热门
下拉加载更多