/*
国际化,网页自动翻译。
作者:管雷鸣
开原仓库:https://github.com/xnx3/translate
*/
if (typeof translate == "object" && typeof translate.version == "string") {
throw new Error(
"translate.js 已经加载过一次了,当前是重复加载,避免你的翻译出现异常,已帮你拦截此次加载。本信息只是给你一个提示,你可以检查一下你的项目中是否出现了重复引入 translate.js ,当然,这个异常并不会影响到你的具体使用,它已经自动帮你处理拦截了这个异常,只不过提示出来是让你知道,你的代码里出现了重复引入的情况。",
);
}
var translate = {
/**
* 当前的版本
* 由 npm 脚本自动更新,无需手动修改
* 格式:major.minor.patch.date
*/
// AUTO_VERSION_START
version: "3.17.17.20250808",
// AUTO_VERSION_END
/*
当前使用的版本,默认使用v2. 可使用 setUseVersion2();
来设置使用v2 ,已废弃,主要是区分是否是v1版本来着,v2跟v3版本是同样的使用方式
*/
useVersion: "v2",
/*js translate.setUseVersion2 start*/
setUseVersion2: () => {
translate.useVersion = "v2";
console.log(
"提示:自 v2.10 之后的版本默认就是使用V2版本(当前版本为:" +
translate.version +
"), translate.setUseVersion2() 可以不用再加这一行了。当然加了也无所谓,只是加了跟不加是完全一样的。",
);
},
/*js translate.setUseVersion2 end*/
/*
* 翻译的对象,也就是 new google.translate.TranslateElement(...)
* 已废弃,v1使用的
*/
translate: null,
/*js translate.includedLanguages end*/
/*
* 支持哪些语言切换,包括:de,hi,lt,hr,lv,ht,hu,zh-CN,hy,uk,mg,id,ur,mk,ml,mn,af,mr,uz,ms,el,mt,is,it,my,es,et,eu,ar,pt-PT,ja,ne,az,fa,ro,nl,en-GB,no,be,fi,ru,bg,fr,bs,sd,se,si,sk,sl,ga,sn,so,gd,ca,sq,sr,kk,st,km,kn,sv,ko,sw,gl,zh-TW,pt-BR,co,ta,gu,ky,cs,pa,te,tg,th,la,cy,pl,da,tr
* 已废弃,请使用 translate.selectLanguageTag.languages
*/
includedLanguages: "zh-CN,zh-TW,en",
/*js translate.includedLanguages end*/
/*js translate.resourcesUrl start*/
/*
* 资源文件url的路径
* 已废弃,v1使用的
*/
resourcesUrl: "//res.zvo.cn/translate",
/*js translate.resourcesUrl end*/
/**
* 默认出现的选择语言的 select 选择框,可以通过这个选择切换语言。
*/
selectLanguageTag: {
/*
v3.1 增加,将 select切换语言的选择框赋予哪个id,这里是具体的id的名字。
如果这个id不存在,会创建这个id的元素
*/
documentId: "translate",
/* 是否显示 select选择语言的选择框,true显示; false不显示。默认为true */
show: false,
/*
支持哪些语言切换
v1.x 版本包括:de,hi,lt,hr,lv,ht,hu,zh-CN,hy,uk,mg,id,ur,mk,ml,mn,af,mr,uz,ms,el,mt,is,it,my,es,et,eu,ar,pt-PT,ja,ne,az,fa,ro,nl,en-GB,no,be,fi,ru,bg,fr,bs,sd,se,si,sk,sl,ga,sn,so,gd,ca,sq,sr,kk,st,km,kn,sv,ko,sw,gl,zh-TW,pt-BR,co,ta,gu,ky,cs,pa,te,tg,th,la,cy,pl,da,tr
v2.x 版本根据后端翻译服务不同,支持的语言也不同。具体支持哪些,可通过 http://api.translate.zvo.cn/doc/language.json.html 获取 (如果您私有部署的,将请求域名换为您自己私有部署的域名)
*/
languages: "",
alreadyRender: false, //当前是否已渲染过了 true为是 v2.2增加
selectOnChange: (event) => {
var language = event.target.value;
translate.changeLanguage(language);
},
//重新绘制 select 语种下拉选择。比如进行二次开发过translate.js,手动进行了设置 translate.to ,但是手动改动后的,在select语种选择框中并不会自动进行改变,这是就需要手动重新绘制一下 select语种选择的下拉选择框
refreshRender: () => {
// 获取元素
const element = document.getElementById(
translate.selectLanguageTag.documentId + "SelectLanguage",
);
// 删除元素
if (element) {
element.parentNode.removeChild(element);
}
//设置为未 render 状态,允许进行 render
translate.selectLanguageTag.alreadyRender = false;
translate.selectLanguageTag.render();
},
/*
自定义切换语言的样式渲染 v3.2.4 增加
*/
customUI: (languageList) => {
//select的onchange事件
var onchange = (event) => {
translate.selectLanguageTag.selectOnChange(event);
};
//创建 select 标签
var selectLanguage = document.createElement("select");
selectLanguage.id =
translate.selectLanguageTag.documentId + "SelectLanguage";
selectLanguage.className =
translate.selectLanguageTag.documentId + "SelectLanguage";
var to = translate.language.getCurrent();
for (var i = 0; i < languageList.length; i++) {
var option = document.createElement("option");
option.setAttribute("value", languageList[i].id);
//判断 selectLanguageTag.languages 中允许使用哪些
if (translate.selectLanguageTag.languages.length > 0) {
//设置了自定义显示的语言
//都转小写判断
var langs_indexof = (
"," +
translate.selectLanguageTag.languages +
","
).toLowerCase();
//console.log(langs_indexof)
if (
langs_indexof.indexOf(
"," + languageList[i].id.toLowerCase() + ",",
) < 0
) {
//没发现,那不显示这个语种,调出
continue;
}
}
/*判断默认要选中哪个语言*/
if (to != null && typeof to != "undefined" && to.length > 0) {
//设置了目标语言,那就进行判断显示目标语言
if (to == languageList[i].id) {
option.setAttribute("selected", "selected");
}
} else {
//没设置目标语言,那默认选中当前本地的语种
if (languageList[i].id == translate.language.getLocal()) {
option.setAttribute("selected", "selected");
}
}
option.appendChild(document.createTextNode(languageList[i].name));
selectLanguage.appendChild(option);
}
//增加 onchange 事件
if (window.addEventListener) {
// Mozilla, Netscape, Firefox
selectLanguage.addEventListener("change", onchange, false);
} else {
// IE
selectLanguage.attachEvent("onchange", onchange);
}
//将select加入进网页显示
document
.getElementById(translate.selectLanguageTag.documentId)
.appendChild(selectLanguage);
},
render: () => {
//v2增加
if (translate.selectLanguageTag.alreadyRender) {
return;
}
translate.selectLanguageTag.alreadyRender = true;
//判断如果不显示select选择语言,直接就隐藏掉
if (!translate.selectLanguageTag.show) {
return;
}
//判断translate 的id是否存在,不存在就创建一个
if (
document.getElementById(translate.selectLanguageTag.documentId) == null
) {
var findBody = document.getElementsByTagName("body");
if (findBody.length == 0) {
console.log(
"body tag not find, translate.selectLanguageTag.render() is not show Select Language",
);
return;
}
var body_trans = findBody[0];
var div = document.createElement("div"); //创建一个script标签
div.id = translate.selectLanguageTag.documentId;
body_trans.appendChild(div);
} else {
//存在,那么判断一下 select是否存在,要是存在就不重复创建了
if (
document.getElementById(
translate.selectLanguageTag.documentId + "SelectLanguage",
) != null
) {
//select存在了,就不重复创建了
return;
}
}
//从服务器加载支持的语言库
if (
typeof translate.request.api.language == "string" &&
translate.request.api.language.length > 0
) {
//从接口加载语种
translate.request.post(
translate.request.api.language,
{},
(data) => {
if (data.result == 0) {
console.log("load language list error : " + data.info);
return;
}
//console.log(data.list);
translate.selectLanguageTag.customUI(data.list);
},
null,
);
} else if (typeof translate.request.api.language == "object") {
//无网络环境下,自定义显示语种
translate.selectLanguageTag.customUI(translate.request.api.language);
}
},
},
/*
* 当前本地语言
* 已废弃,v1使用的
*/
//localLanguage:'zh-CN',
/*js translate.localLanguage start*/
localLanguage: "zh-CN",
/*js translate.localLanguage end*/
/*js translate.googleTranslateElementInit start*/
/**
* google翻译执行的
* 已废弃,v1使用的
*/
googleTranslateElementInit: () => {
var selectId = "";
if (document.getElementById("translate") != null) {
// && document.getElementById('translate').innerHTML.indexOf('translateSelectLanguage') > 0
//已经创建过了,存在
selectId = "translate";
}
translate.translate = new google.translate.TranslateElement(
{
//这参数没用,请忽略
pageLanguage: "zh-CN",
//一共80种语言选择,这个是你需要翻译的语言,比如你只需要翻译成越南和英语,这里就只写en,vi
//includedLanguages: 'de,hi,lt,hr,lv,ht,hu,zh-CN,hy,uk,mg,id,ur,mk,ml,mn,af,mr,uz,ms,el,mt,is,it,my,es,et,eu,ar,pt-PT,ja,ne,az,fa,ro,nl,en-GB,no,be,fi,ru,bg,fr,bs,sd,se,si,sk,sl,ga,sn,so,gd,ca,sq,sr,kk,st,km,kn,sv,ko,sw,gl,zh-TW,pt-BR,co,ta,gu,ky,cs,pa,te,tg,th,la,cy,pl,da,tr',
includedLanguages: translate.selectLanguageTag.languages,
//选择语言的样式,这个是面板,还有下拉框的样式,具体的记不到了,找不到api~~
layout: 0,
//自动显示翻译横幅,就是翻译后顶部出现的那个,有点丑,设置这个属性不起作用的话,请看文章底部的其他方法
//autoDisplay: false,
//disableAutoTranslation:false,
//还有些其他参数,由于原插件不再维护,找不到详细api了,将就了,实在不行直接上dom操作
},
selectId, //触发按钮的id
);
},
/*js translate.googleTranslateElementInit end*/
/**
* 初始化,如加载js、css资源
* 已废弃,v1使用的
*/
/* v2.11.11.20240124 彻底注释掉,有新的init方法替代
init:function(){
var protocol = window.location.protocol;
if(window.location.protocol == 'file:'){
//本地的,那就用http
protocol = 'http:';
}
if(this.resourcesUrl.indexOf('://') == -1){
//还没设置过,进行设置
this.resourcesUrl = protocol + this.resourcesUrl;
}
//this.resourcesUrl = 'file://G:/git/translate';
},
*/
/*js translate.execute_v1 start*/
/**
* 执行翻译操作
* 已废弃,v1使用的
*/
execute_v1: () => {
console.log("=====ERROR======");
console.log(
"The v1 version has been discontinued since 2022. Please use the latest V3 version and refer to: http://translate.zvo.cn/41162.html",
);
},
/*js translate.execute_v1 end*/
/*js translate.setCookie start*/
/**
* 设置Cookie,失效时间一年。
* @param name
* @param value
* * 已废弃,v1使用的
*/
setCookie: (name, value) => {
var cookieString = name + "=" + escape(value);
document.cookie = cookieString;
},
/*js translate.setCookie end*/
/*js translate.getCookie start*/
//获取Cookie。若是不存再,返回空字符串
//* 已废弃,v1使用的
getCookie: (name) => {
var strCookie = document.cookie;
var arrCookie = strCookie.split("; ");
for (var i = 0; i < arrCookie.length; i++) {
var arr = arrCookie[i].split("=");
if (arr[0] == name) {
return unescape(arr[1]);
}
}
return "";
},
/*js translate.getCookie end*/
/*js translate.currentLanguage start*/
/*
获取当前页面采用的是什么语言
返回值如 en、zh-CN、zh-TW (如果是第一次用,没有设置过,那么返回的是 translate.localLanguage 设置的值)
已废弃,v1使用的
*/
currentLanguage: () => {
//translate.check();
var cookieValue = translate.getCookie("googtrans");
if (cookieValue.length > 0) {
return cookieValue.substr(
cookieValue.lastIndexOf("/") + 1,
cookieValue.length - 1,
);
}
return translate.localLanguage;
},
/*js translate.currentLanguage end*/
/**
* 切换语言,比如切换为英语、法语
* @param languageName 要切换的语言语种。传入如 english
* 会自动根据传入的语言来判断使用哪种版本。比如传入 en、zh-CN 等,则会使用v1.x版本
* 传入 chinese_simplified 、english 等,则会使用 v2.x版本
*/
changeLanguage: (languageName) => {
//判断使用的是否是v1.x
var v1 =
",en,de,hi,lt,hr,lv,ht,hu,zh-CN,hy,uk,mg,id,ur,mk,ml,mn,af,mr,uz,ms,el,mt,is,it,my,es,et,eu,ar,pt-PT,ja,ne,az,fa,ro,nl,en-GB,no,be,fi,ru,bg,fr,bs,sd,se,si,sk,sl,ga,sn,so,gd,ca,sq,sr,kk,st,km,kn,sv,ko,sw,gl,zh-TW,pt-BR,co,ta,gu,ky,cs,pa,te,tg,th,la,cy,pl,da,tr,";
if (v1.indexOf("," + languageName + ",") > -1) {
//用的是v1.x
console.log(
"您使用的是v1版本的切换语种方式,v1已在2021年就以废弃,请更换为v2,参考文档: http://translate.zvo.cn/41549.html",
);
translate.check();
var googtrans = "/" + translate.localLanguage + "/" + languageName;
//先清空泛解析域名的设置
var s = document.location.host.split(".");
if (s.length > 2) {
var fanDomain = s[s.length - 2] + "." + s[s.length - 1];
document.cookie =
"googtrans=;expires=" +
new Date(1) +
";domain=" +
fanDomain +
";path=/";
document.cookie =
"googtrans=" + googtrans + ";domain=" + fanDomain + ";path=/";
}
translate.setCookie("googtrans", "" + googtrans);
translate.refreshCurrentPage();
return;
}
//用的是v2.x或更高
//translate.setUseVersion2();
translate.useVersion = "v2";
//判断是否是第一次翻译,如果是,那就不用刷新页面了。 true则是需要刷新,不是第一次翻译
if (translate.to != null && translate.to.length > 0) {
//当前目标值有值,且目标语言跟当前语言不一致,那当前才是已经被翻译过的
if (translate.to != translate.language.getLocal()) {
var isReload = true; //标记要刷新页面
}
}
translate.to = languageName;
translate.storage.set("to", languageName); //设置目标翻译语言
/*
1. 先触发父级,免得当前刷新了,导致父级不执行翻译了
*/
//检测当前是否处于iframe中,如果当前是在iframe中,有父级页面,也要触发父级进行翻译
try {
if (window.self !== window.top) {
if (
typeof window.parent.translate == "object" &&
typeof window.parent.translate.version == "string"
) {
//iframe页面中存在 translate,那么也控制iframe中的进行翻译
if (window.parent.translate.language.getCurrent() != languageName) {
//如果父页面当前的语种不是需要翻译的语种,对其进行翻译
window.parent.translate.changeLanguage(languageName);
}
}
}
} catch (e) {
//增加try,避免异常导致无法用
console.log(e);
}
if (isReload) {
location.reload(); //刷新页面
} else {
//不用刷新,直接翻译
translate.execute(); //翻译
//检测是否有iframe中的子页面,如果有,也对子页面下发翻译命令。这个是针对 LayuiAdmin 框架的场景适配,它的主体区域是在 iframe 中的,不能点击切换语言后,只翻译外面的大框,而iframe中的不翻译
const iframes = document.querySelectorAll("iframe");
for (let i = 0; i < iframes.length; i++) {
const iframe = iframes[i];
// 获取 iframe 的 window 对象
const iframeWindow = iframe.contentWindow;
try {
if (
typeof iframeWindow.translate == "object" &&
typeof iframeWindow.translate.version == "string"
) {
//iframe页面中存在 translate,那么也控制iframe中的进行翻译
if (iframeWindow.translate.to != languageName) {
iframeWindow.translate.to = languageName;
iframeWindow.translate.storage.set("to", languageName); //设置目标翻译语言
iframeWindow.translate.execute();
}
}
} catch (e) {
//增加try,避免异常,比如跨域,中断导致无法用
console.log(e);
}
}
}
//当用户代码设置里启用了 translate.listener.start() 然后用户加载页面后并没有翻译(这时listener是不启动的只是把listener.use标记为true),然后手动点击翻译按钮翻译为其他语种(这是不会刷新页面),翻译后也要跟着启动监听
if (translate.listener.use == true && translate.listener.isStart == false) {
if (typeof translate.listener.start != "undefined") {
translate.listener.start();
}
}
},
/**
* 自检提示,适用于 v1.x, 在 v2.x中已废弃
* english
* 已废弃,v1使用的
*/
/*js translate.check start*/
check: () => {
if (window.location.protocol == "file:") {
console.log(
"\r\n---WARNING----\r\ntranslate.js 主动翻译组件自检异常,当前协议是file协议,翻译组件要在正常的线上http、https协议下才能正常使用翻译功能\r\n------------",
);
}
},
/*js translate.check end*/
/**************************** v2.0 */
to: "", //翻译为的目标语言,如 english 、chinese_simplified
//用户第一次打开网页时,自动判断当前用户所在国家使用的是哪种语言,来自动进行切换为用户所在国家的语种。
//如果使用后,第二次在用,那就优先以用户所选择的为主,这个就不管用了
//默认是false,不使用,可设置true:使用
//使用 setAutoDiscriminateLocalLanguage 进行设置
autoDiscriminateLocalLanguage: false,
documents: [], //指定要翻译的元素的集合,可设置多个,如设置: document.getElementsByTagName('DIV')
/*
v2.11.5增加
正在进行翻译的节点,会记录到此处。
这里是最底的节点了,不会再有下级了。这也就是翻译的最终节点,也就是 translate.element.findNode() 发现的节点
也就是扫描到要进行翻译的节点,在翻译前,加入到这里,在这个节点翻译结束后,将这里面记录的节点删掉。
格式如
[
{
node: node节点的对象
number: 2 (当前正在翻译进行中的次数,比如一个节点有中英文混合的文本,那么中文、英文 会同时进行两次翻译,也就是最后要进行两次替换,会导致这个node产生两次改动。每次便是+1、-1)
},
{
......
}
]
生命周期:
translate.execute() 执行后,会扫描要翻译的字符,扫描完成后首先会判断缓存中是否有,是否会命中缓存,如果缓存中有,那么在加入 task.add 之前就会将这个进行记录 ++
在浏览器缓存没有命中后,则会通过网络api请求进行翻译,此时在发起网络请求前,会进行记录 ++
当使用 translate.listener.start() 后,网页中动态渲染的部分会触发监听,触发监听后首先会判断这个节点是否存在于这里面正在被翻译,如果存在里面,那么忽略, 如果不存在里面,那么再进行 translate.execute(变动的节点) 进行翻译 (当然执行这个翻译后,自然也就又把它加入到此处进行记录 ++)
【唯一的减去操作】 在task.execute() 中,翻译完成并且渲染到页面执行完成后,会触发延迟50毫秒后将这个翻译的节点从这里减去
*/
inProgressNodes: [],
//翻译时忽略的一些东西,比如忽略某个tag、某个class等
ignore: {
tag: ["style", "script", "link", "pre", "code"],
class: ["ignore", "translateSelectLanguage"],
id: [],
/*
传入一个元素,判断这个元素是否是被忽略的元素。 这个会找父类,看看父类中是否包含在忽略的之中。
return true是在忽略的之中,false不再忽略的之中
*/
isIgnore: (ele) => {
if (ele == null || typeof ele == "undefined") {
return false;
}
var parentNode = ele;
var maxnumber = 100; //最大循环次数,避免死循环
while (maxnumber-- > 0) {
if (parentNode == null || typeof parentNode == "undefined") {
//没有父元素了
return false;
}
//判断Tag
//var tagName = parentNode.nodeName.toLowerCase(); //tag名字,小写
var nodename = translate.element.getNodeName(parentNode).toLowerCase(); //tag名字,小写
if (nodename.length > 0) {
//有nodename
if (
nodename == "body" ||
nodename == "html" ||
nodename == "#document"
) {
//上层元素已经是顶级元素了,那肯定就不是了
return false;
}
if (translate.ignore.tag.indexOf(nodename) > -1) {
//发现ignore.tag 当前是处于被忽略的 tag
return true;
}
}
//判断class name
if (parentNode.className != null) {
var classNames = parentNode.className;
if (classNames == null || typeof classNames != "string") {
continue;
}
//console.log('className:'+typeof(classNames));
//console.log(classNames);
classNames = classNames.trim().split(" ");
for (var c_index = 0; c_index < classNames.length; c_index++) {
if (
classNames[c_index] != null &&
classNames[c_index].trim().length > 0
) {
//有效的class name,进行判断
if (translate.ignore.class.indexOf(classNames[c_index]) > -1) {
//发现ignore.class 当前是处于被忽略的 class
return true;
}
}
}
}
//判断id
if (parentNode.id != null && typeof parentNode.id != "undefined") {
//有效的class name,进行判断
if (translate.ignore.id.indexOf(parentNode.id) > -1) {
//发现ignore.id 当前是处于被忽略的 id
return true;
}
}
//赋予判断的元素向上一级
parentNode = parentNode.parentNode;
}
return false;
},
/*
* 忽略不被翻译的文本,这里出现的文本将不会被翻译。
* 这个其实是借用了 自定义术语 的能力,设置了自定义术语的原字符等于翻译后的字符, 于是这个字符就不会被翻译了
* 这里可以是多个,数组,如 ['你好','世界']
*/
text: [],
/*
下面的 textRegex 、 setTextRegexs 正则方式设置忽略不翻译text的能力,有 https://github.com/wangliangyu 提交贡献, 弥补 translate.ignore.text 固定设置的不足
*/
textRegex: [],
/*
使用方式如:
translate.ignore.setTextRegexs([/请求/g, /[\u4a01-\u4a05]+/g]);
*/
setTextRegexs: function (arr) {
if (!Array.isArray(arr)) throw new Error("参数必须为数组");
for (let i = 0; i < arr.length; i++) {
if (!(arr[i] instanceof RegExp)) {
throw new Error("第" + i + "项不是RegExp对象");
}
}
//this.textRegex = [...this.textRegex, ...arr];
//改为兼容 es5 的方式,提供更多兼容
this.textRegex = this.textRegex.concat(arr);
},
},
//刷新页面,你可以自定义刷新页面的方式,比如在 uniapp 打包生成 apk 时,apk中的刷新页面就不是h5的这个刷新,而是app的刷新方式,就需要自己进行重写这个刷新页面的方法了
refreshCurrentPage: () => {
location.reload();
},
//自定义翻译术语
nomenclature: {
/*
术语表
一维:要转换的语种,如 english
二维:翻译至的目标语种,如 english
三维:要转换的字符串,如 "你好"
结果:自定义的翻译结果,如 “Hallo”
*/
data: [],
/*
原始术语表,可编辑的
一维:要自定义目标词
二维:针对的是哪个语种
值:要翻译为什么内容
其设置如
var data = new Array();
data['版本'] = {
english : 'banben',
korean : 'BanBen'
};
data['国际化'] = {
english : 'guojihua',
korean : 'GuoJiHua'
};
【已过时】
*/
old_Data: [],
/*
set:function(data){
translate.nomenclature.data = data;
},
*/
set: (data) => {
alert(
"请将 translate.nomenclature.set 更换为 append,具体使用可参考: https://github.com/xnx3/translate ",
);
},
/*
向当前术语库中追加自定义术语。如果追加的数据重复,会自动去重
传入参数:
from 要转换的语种
to 翻译至的目标语种
properties 属于配置表,格式如:
你好=Hello
世界=ShiJie
*/
append: (from, to, properties) => {
if (typeof translate.nomenclature.data[from] == "undefined") {
translate.nomenclature.data[from] = [];
}
if (typeof translate.nomenclature.data[from][to] == "undefined") {
translate.nomenclature.data[from][to] = [];
}
//将properties进行分析
//按行拆分
var line = properties.split("\n");
//console.log(line)
for (var line_index = 0; line_index < line.length; line_index++) {
var item = line[line_index].trim();
if (item.length < 1) {
//空行,忽略
continue;
}
var kvs = item.split("=");
//console.log(kvs)
if (kvs.length != 2) {
//不是key、value构成的,忽略
continue;
}
var key = kvs[0].trim();
var value = kvs[1].trim();
//console.log(key)
if (key.length == 0 || value.length == 0) {
//其中某个有空,则忽略
continue;
}
//加入,如果之前有加入,则会覆盖
translate.nomenclature.data[from][to][key] = value;
//console.log(local+', '+target+', key:'+key+', value:'+value);
}
//追加完后,对整个对象数组进行排序,key越大越在前面
translate.nomenclature.data[from][to] = translate.util.objSort(
translate.nomenclature.data[from][to],
);
},
//获取当前定义的术语表
get: () => translate.nomenclature.data,
//对传入的str字符进行替换,将其中的自定义术语提前进行替换,然后将替换后的结果返回
//v3.11 后此方法已废弃,不再使用
dispose: (str) => {
if (str == null || str.length == 0) {
return str;
}
//if(translate.nomenclature.data.length == 0){
// return str;
//}
//判断当前翻译的两种语种是否有自定义术语库
//console.log(typeof(translate.nomenclature.data[translate.language.getLocal()][translate.to]))
if (
typeof translate.nomenclature.data[translate.language.getLocal()] ==
"undefined" ||
typeof translate.nomenclature.data[translate.language.getLocal()][
translate.to
] == "undefined"
) {
return str;
}
//console.log(str)
for (var originalText in translate.nomenclature.data[
translate.language.getLocal()
][translate.to]) {
if (
!Object.hasOwn(
translate.nomenclature.data[translate.language.getLocal()][
translate.to
],
originalText,
)
) {
continue;
}
var translateText =
translate.nomenclature.data[translate.language.getLocal()][
translate.to
][originalText];
if (typeof translateText == "function") {
//进行异常的预处理调出
continue;
}
var index = str.indexOf(originalText);
if (index > -1) {
//console.log('find -- '+originalText+', \t'+translateText);
if (translate.language.getLocal() == "english") {
//如果本地语种是英文,那么还要判断它的前后,避免比如要替换 is 将 display 中的is给替换,将单词给强行拆分了
//判断这个词前面是否符合
var beforeChar = ""; //前面的字符
if (index == 0) {
//前面没别的字符了,那前面合适
} else {
//前面有别的字符,判断是什么字符,如果是英文,那么这个是不能被拆分的,要忽略
beforeChar = str.substr(index - 1, 1);
//console.log('beforeChar:'+beforeChar+', str:'+str)
var lang = translate.language.getCharLanguage(beforeChar);
//console.log(lang);
if (lang == "english" || lang == "romance") {
//调出,不能强拆
continue;
}
}
//判断这个词的后面是否符合
var afterChar = ""; //后面的字符
if (index + originalText.length == str.length) {
//后面没别的字符了,那前面合适
//console.log(originalText+', meile '+str)
} else {
//后面有别的字符,判断是什么字符,如果是英文,那么这个是不能被拆分的,要忽略
afterChar = str.substr(index + originalText.length, 1);
var lang = translate.language.getCharLanguage(afterChar);
if (lang == "english" || lang == "romance") {
//跳出,不能强拆
continue;
}
}
str = str.replace(
new RegExp(beforeChar + originalText + afterChar, "g"),
beforeChar + translateText + afterChar,
);
} else {
//其他情况,如汉语、汉语等语种
str = str.replace(new RegExp(originalText, "g"), translateText);
}
}
}
return str;
/*
//遍历一维
for(var originalText in translate.nomenclature.data){
var languageResult = translate.nomenclature.data[originalText];
if(typeof(languageResult) == 'function'){
//进行异常的预处理调出
continue;
}
if(typeof(languageResult[translate.to]) == 'undefined'){
//console.log('und');
continue;
}
//var hash = translate.util.hash(originalText);
//console.log(originalText+',\t'+str);
if(str.indexOf(originalText) > -1){
//console.log('find -- '+originalText+', \t'+languageResult[translate.to]);
str = str.replace(new RegExp(originalText,'g'),languageResult[translate.to]);
}
}
return str;
*/
},
},
office: {
/*
网页上翻译之后,自动导出当前页面的术语库
需要先指定本地语种,会自动将本地语种进行配置术语库
*/
export: () => {
if (translate.language.getLocal() == translate.language.getCurrent()) {
alert("本地语种跟要翻译的语种一致,无需导出");
return;
}
var text = "";
for (var uuid in translate.nodeQueue) {
if (!Object.hasOwn(translate.nodeQueue, uuid)) {
continue;
}
var queueValue = translate.nodeQueue[uuid];
for (var lang in translate.nodeQueue[uuid].list) {
if (!Object.hasOwn(translate.nodeQueue[uuid].list, lang)) {
continue;
}
//console.log('------'+lang)
if (typeof lang != "string" || lang.length < 1) {
continue;
}
//if(translate.language.getLocal() == lang){
//console.log(translate.nodeQueue[uuid].list[lang]);
for (var hash in translate.nodeQueue[uuid].list[lang]) {
if (!Object.hasOwn(translate.nodeQueue[uuid].list[lang], hash)) {
continue;
}
//console.log(translate.nodeQueue[uuid].list[lang][hash].original);
//console.log(translate.nodeQueue[uuid].list[lang][hash].original);
text =
text +
"\n" +
translate.nodeQueue[uuid].list[lang][hash].original +
"=" +
translate.storage.get(
"hash_" + translate.language.getCurrent() + "_" + hash,
);
}
//}
}
}
if (text.length > 0) {
//有内容
text =
"translate.office.append('" +
translate.language.getCurrent() +
"',`" +
text +
"\n`);";
//console.log(text);
translate.util.loadMsgJs();
msg.popups({
text: '',
width: "750px",
height: "600px",
padding: "1px",
});
document.getElementById("msgPopupsTextarea").value = text;
} else {
msg.alert("无有效内容!");
}
},
//显示导出面板
showPanel: () => {
const panel = document.createElement("div");
panel.setAttribute("id", "translate_export");
panel.setAttribute("class", "ignore");
//导出按钮
const button = document.createElement("button");
button.onclick = () => {
translate.office.export();
};
button.innerHTML = "导出配置信息";
button.setAttribute(
"style",
"margin-left: 72px; margin-top: 30px; margin-bottom: 20px; font-size: 25px; background-color: blue; padding: 15px; padding-top: 3px; padding-bottom: 3px; border-radius: 3px;",
);
panel.appendChild(button);
//说明文字
const textdiv = document.createElement("div");
textdiv.innerHTML =
'1. 首先将当前语种切换为你要翻译的语种
2. 点击导出按钮,将翻译的配置信息导出
3. 将导出的配置信息粘贴到代码中,即可完成
点此进行查阅详细使用说明';
textdiv.setAttribute("style", "font-size: 14px; padding: 12px;");
panel.appendChild(textdiv);
panel.setAttribute(
"style",
"background-color: black; color: #fff; width: 320px; height: 206px; position: fixed; bottom: 50px; right: 50px;",
);
//把元素节点添加到body元素节点中成为其子节点,放在body的现有子节点的最后
document.body.appendChild(panel);
translate.util.loadMsgJs();
},
/*
追加离线翻译数据。如果追加的数据重复,会自动去重
传入参数:
from 要转换的语种
to 翻译至的目标语种
properties 属于配置表,格式如:
你好=Hello
世界=ShiJie
这个传入参数跟 translate.nomenclature.append 的传入参数格式是一致的
*/
append: (to, properties) => {
//console.log(properties)
//将properties进行分析
//按行拆分
var line = properties.split("\n");
//console.log(line)
for (var line_index = 0; line_index < line.length; line_index++) {
var item = line[line_index].trim();
if (item.length < 1) {
//空行,忽略
continue;
}
var kvs = item.split("=");
//console.log(kvs)
if (kvs.length != 2) {
//不是key、value构成的,忽略
continue;
}
var key = kvs[0];
var value = kvs[1];
//console.log(key)
if (key.length == 0 || value.length == 0) {
//其中某个有空,则忽略
continue;
}
//console.log('set---'+key);
//加入 storate
translate.storage.set(
"hash_" + to + "_" + translate.util.hash(key),
value,
);
}
},
//全部提取能力(整站的离线翻译数据提取)
fullExtract: {
/*js translate.office.fullExtract.set start*/
/*
将翻译的结果加入
hash: 翻译前的文本的hash
originalText: 翻以前的文本,原始文本
toLanguage: 翻译为什么语言
translateText: 翻译结果的文本
*/
set: async (hash, originalText, toLanguage, translateText) => {
if (typeof translate.storage.IndexedDB == "undefined") {
console.log("ERROR: translate.storage.IndexedDB not find");
return;
}
var obj = await translate.storage.IndexedDB.get("hash_" + hash);
if (typeof obj == "undefined" && obj == null) {
obj = {
originalText: originalText,
};
}
obj[toLanguage] = translateText;
await translate.storage.IndexedDB.set("hash_" + hash, obj);
},
/*js translate.office.fullExtract.set end*/
/*js translate.office.fullExtract.export start*/
/*
将存储的数据导出为 txt 文件下载下来
*/
export: async (to) => {
if (typeof translate.storage.IndexedDB == "undefined") {
console.log("ERROR: translate.storage.IndexedDB not find");
return;
}
if (typeof to != "string") {
console.log('error : to param not find, example: "english"');
return;
}
var text = "translate.office.append('";
var data = await translate.storage.IndexedDB.list("hash_*");
for (var i in data) {
if (!Object.hasOwn(data, i)) {
continue;
}
var originalText = data[i].value.originalText
.replace(/\n/g, "\\n")
.replace(/\t/g, "\\t");
text =
text +
"\n" +
originalText +
"=" +
data[i].value.english.replace(/\n/g, "\\n").replace(/\t/g, "\\t");
}
text = text + "\n`);";
const blob = new Blob([text], { type: "text/plain" });
const url = URL.createObjectURL(blob);
const link = document.createElement("a");
link.href = url;
link.download = to + ".txt";
link.click();
URL.revokeObjectURL(url);
},
/*js translate.office.fullExtract.export end*/
/*
是否启用全部提取的能力
true: 启用, 默认是false不启用。
如果设置为true,则每次通过调用翻译接口进行翻译后,都会将翻译的原文、译文、翻译为什么语种,都会单独记录一次,存入浏览器的 IndexedDB 的 translate.js 数据库
然后可以浏览所有页面后,把所有翻译一对一的对应翻译结果直接全部导出,用于做离线翻译配置使用。
*/
isUse: false,
},
},
setAutoDiscriminateLocalLanguage: () => {
translate.autoDiscriminateLocalLanguage = true;
},
/*
待翻译的页面的node队列
一维:key:uuid,也就是execute每次执行都会创建一个翻译队列,这个是翻译队列的唯一标识。
value:
k/v
二维:对象形态,具体有:
key:expireTime 当前一维数组key的过期时间,到达过期时间会自动删除掉这个一维数组。如果<0则代表永不删除,常驻内存
value:list 从DOM中自动识别出的语言文本及节点数据,按照语种进行了划分,每个语种便是其中的一项。
三维:针对二维的value, key:english、chinese_simplified等语种,这里的key便是对value的判断,取value中的要翻译的词是什么语种,对其进行了语种分类 value: k/v
四维:针对三维的value, key:要翻译的词(经过语种分割的)的hash, value: node数组
五维:针对四维的value, 这是个对象, 其中
original: 是三维的key的hash的原始文字, node 元素中的原始文字(可能是node元素整个内容,也可能是被分割出的某一块内容,比如中英文混合时单独提取中文)
cacheHash: 如果翻译时匹配到了自定义术语库中的词,那么翻译完后存入到缓存中时,其缓存的翻译前字符串已经不是original,而是匹配完术语库后的文本的hash了。所以这里额外多增加了这个属性。如果匹配了术语库,那这里就是要进行缓存的翻译前文本的hash,如果未使用术语库,这里就跟其key-hash 相同。
translateText: 针对 original 的经过加工过的文字,比如经过自定义术语、以及其他处理操作后的,待进行文本翻译的文字。
nodes: 有哪些node元素中包含了这个词,都会在这里记录
六维:针对五维的 nodes,将各个具体的 node 以及 其操作的 attribute 以数组形式列出
七维:针对六维列出的nodes数组,其中包含:
node: 具体操作的node元素
attribute: 也就是翻译文本针对的是什么,是node本身(nodeValue),还是 node 的某个属性,比如title属性,这则是设置为 "title"。如果这里不为空,那就是针对的属性操作的。 如果这里为空或者undefined ,那就是针对node本身,也就是 nodeValue 的字符串操作的
beforeText: node元素中进行翻译结果赋予时,额外在翻译结果的前面加上的字符串。其应用场景为,如果中英文混合场景下,避免中文跟英文挨着导致翻译为英语后,连到一块了。默认是空字符串 ''
afterText: node元素中进行翻译结果赋予时,额外在翻译结果的后面加上的字符串。其应用场景为,如果中英文混合场景下,避免中文跟英文挨着导致翻译为英语后,连到一块了。默认是空字符串 ''
生命周期: 当execute()执行时创建, 当execute结束(其中的所有request接收到响应并渲染完毕)时销毁(当前暂时不销毁,以方便调试)
*/
nodeQueue: {},
//指定要翻译的元素的集合,可传入一个元素或多个元素
//如设置一个元素,可传入如: document.getElementById('test')
//如设置多个元素,可传入如: document.getElementsByTagName('DIV')
setDocuments: (documents) => {
if (documents == null || typeof documents == "undefined") {
return;
}
if (typeof documents.length == "undefined") {
//不是数组,是单个元素
translate.documents[0] = documents;
} else {
//是数组,直接赋予
translate.documents = documents;
}
//清空翻译队列,下次翻译时重新检索
translate.nodeQueue = {};
//console.log('set documents , clear translate.nodeQueue');
},
//获取当前指定翻译的元素(数组形式 [document,document,...])
//如果用户未使用setDocuments 指定的,那么返回整个网页
//它返回的永远是个数组形式
getDocuments: () => {
if (
translate.documents != null &&
typeof translate.documents != "undefined" &&
translate.documents.length > 0
) {
// setDocuments 指定的
return translate.documents;
}
//未使用 setDocuments指定,那就是整个网页了
//return document.all; //翻译所有的 这是 v3.5.0之前的
//v3.5.0 之后采用 拿 html的最上层的demo,而不是 document.all 拿到可能几千个dom
var doms = [];
doms[0] = document.documentElement;
return doms;
},
listener: {
//当前页面打开后,是否已经执行完execute() 方法进行翻译了,只要执行完一次,这里便是true。 (多种语言的API请求完毕并已渲染html)
//isExecuteFinish:false,
//是否已经使用了 translate.listener.start() 了,如果使用了,那这里为true,多次调用 translate.listener.start() 只有第一次有效
isStart: false,
//用户的代码里是否启用了 translate.listener.start() ,true:启用
//当用户加载页面后,但是未启用翻译时,为了降低性能,监听是不会启动的,但是用户手动点击翻译后,也要把监听启动起来,所以就加了这个参数,来表示当前是否在代码里启用了监听,以便当触发翻译时,监听也跟着触发
use: false,
//translate.listener.start(); //开启html页面变化的监控,对变化部分会进行自动翻译。注意,这里变化区域,是指使用 translate.setDocuments(...) 设置的区域。如果未设置,那么为监控整个网页的变化
start: () => {
translate.listener.use = true;
translate.temp_linstenerStartInterval = setInterval(() => {
if (document.readyState == "complete") {
//dom加载完成,进行启动
clearInterval(translate.temp_linstenerStartInterval); //停止
//如果不需要翻译的情况,是不需要进行监听的
if (
translate.language.getCurrent() == translate.language.getLocal()
) {
if (translate.language.translateLocal) {
//本地语种也要强制翻译跟本地语种不一致的语种
} else {
//console.log('本地语种跟目标语种一致,不进行翻译操作,无需监听。');
return;
}
}
//console.log('进行监听。。');
translate.listener.addListener();
}
//执行完过一次,那才能使用
//if(translate.listener.isExecuteFinish){
/*if(translate.listener.isStart){
//已开启了
return;
}*/
//console.log('translate.temp_linstenerStartInterval Finish!');
//}
}, 300);
},
/*
key: nodeid node的唯一标识,格式如 HTML1_BODY1_DIV2_#text1 ,它是使用 nodeuuid.uuid(node) 获得的
注意,document.getElementById 获得的并不是,需要这样获得 document.getElementById('xx').childNodes[0] 因为它是要给监听dom改动那里用的,监听到的改动的是里面具体的node
value:13位时间戳
*/
ignoreNode: [],
/*
通过 translate.execute() 触发的翻译,来使node发生的改动,这种改动加入到 ignoreNode 的过期时间是多少。
单位是毫秒
*/
translateExecuteNodeIgnoreExpireTime: 1000,
/*
增加一个被listener忽略的节点
这里通常是用于被 translate.js 本身翻译更改的节点、以及像是 Layui 被翻译后触发了渲染改动了dom , 这几种场景都是翻译本身自己触发的,是不需要再被listener触发,不然就形成死循环了
node 是哪个节点被listener扫描到改动后忽略。
可传入 node、也可以传入node的uuid字符串
expireTime 过期时间,也就是执行当前方法将 node 加入后,过多长时间失效,这里是毫秒,比如传入 500 则这个node在当前时间往后的500毫秒内,如果被listener监听到改动,是直接被忽略的,不会触发任何翻译操作
showResultText 实际显示出来的文本,翻译之后显示出来的文本。如果翻译过程中其他js改动了这个文本内容,导致未能翻译,则 analyse.set 的 resultText 会返回 空字符串设置到这里
*/
addIgnore: (node, expireTime, showResultText) => {
let nodeid = "";
if (typeof node == "string") {
nodeid = node;
} else {
nodeid = nodeuuid.uuid(node);
}
translate.listener.ignoreNode[nodeid] = {
addtime: Date.now() + expireTime,
text: showResultText,
};
//translate.listener.renderTaskFinish();
},
/*
刷新 ignoreNode 中的元素,也就是查找其中 expireTime 过期的,删掉
*/
refreshIgnoreNode: () => {
//console.log('refresh ignore ,current: '+Object.keys(translate.listener.ignoreNode).length);
var currentTime = Date.now();
for (const node in translate.listener.ignoreNode) {
if (translate.listener.ignoreNode[node].addtime < currentTime) {
//console.log('delete : ');
//console.log(node);
delete translate.listener.ignoreNode[node];
}
}
//console.log('refresh ignore finish: '+Object.keys(translate.listener.ignoreNode).length);
},
//增加监听,开始监听。这个不要直接调用,需要使用上面的 start() 开启
addListener: () => {
if (translate.listener.isStart == true) {
console.log(
"translate.listener.start() 已经启动了,无需再重复启动监听,增加浏览器负担",
);
return;
}
translate.listener.isStart = true; //记录已执行过启动方法了
// 观察器的配置(需要观察什么变动)
translate.listener.config = {
attributes: true,
childList: true,
subtree: true,
characterData: true,
attributeOldValue: true,
characterDataOldValue: true,
};
// 当观察到变动时执行的回调函数
translate.listener.callback = (mutationsList, observer) => {
var documents = []; //有变动的元素
//console.log('--------- lisetner 变动');
// Use traditional 'for loops' for IE 11
for (const mutation of mutationsList) {
let addNodes = [];
if (mutation.type === "childList") {
if (mutation.addedNodes.length > 0) {
//多了组件
addNodes = mutation.addedNodes;
//documents.push.apply(documents, mutation.addedNodes);
} else if (mutation.removedNodes.length > 0) {
//console.log('remove:');
//console.log(mutation.removedNodes);
} else {
//console.log('not find:');
//console.log(mutation);
}
} else if (mutation.type === "attributes") {
//console.log('The ' + mutation.attributeName + ' attribute was modified.');
} else if (mutation.type === "characterData") {
//内容改变
addNodes = [mutation.target];
//documents.push.apply(documents, [mutation.target]);
}
//去重并加入 documents
for (const item of addNodes) {
//console.log(item);
//判断是否已经加入过了,如果已经加入过了,就不重复加了
var isFind = false;
for (var di = 0; di < documents.length; di++) {
if (documents[di].isSameNode(item)) {
isFind = true;
break;
}
}
if (isFind) {
break;
}
documents.push.apply(documents, [item]);
}
}
//console.log(documents.length);
if (documents.length > 0) {
//有变动,需要看看是否需要翻译,延迟10毫秒执行
//判断是否属于在正在翻译的节点,重新组合出新的要翻译的node集合
var translateNodes = [];
//console.log(translate.inProgressNodes.length);
for (const node of documents) {
//console.log('---type:'+node.nodeType);
var find = false;
for (var ini = 0; ini < translate.inProgressNodes.length; ini++) {
if (translate.inProgressNodes[ini].node.isSameNode(node)) {
//有记录了,那么忽略这个node,这个node是因为翻译才导致的变动
//console.log('发现相同');
find = true;
break;
}
}
if (find) {
continue;
}
//console.log(node);
const nodeid = nodeuuid.uuid(node);
if (typeof translate.listener.ignoreNode[nodeid] != "undefined") {
if (
translate.listener.ignoreNode[nodeid].addtime > Date.now() &&
typeof node.nodeValue == "string" &&
node.nodeValue == translate.listener.ignoreNode[nodeid].text
) {
//console.log('node 未过忽略期,listener扫描后忽略:'+nodeid);
continue;
}
}
//不相同,才追加到新的 translateNodes
translateNodes.push(node);
//console.log('listener ++ '+node.nodeValue);
//console.log(node);
}
if (translateNodes.length < 1) {
return;
}
//console.log('translateNodeslength: '+translateNodes.length);
translate.execute(translateNodes);
//setTimeout(function() {
// translate.execute(translateNodes); //指定要翻译的元素的集合,可传入一个或多个元素。如果不设置,默认翻译整个网页
//}, 10); //这个要比 task.execute() 中的 settimeout 延迟执行删除 translate.inpr.....nodes 的时间要小,目的是前一个发生变动后,记入 inpr...nodes 然后翻译完成后节点发生变化又触发了listener,此时 inpr....nodes 还有,那么这个变化将不做处理,然后 inp.....nodes 再删除这个标记
}
};
// 创建一个观察器实例并传入回调函数
translate.listener.observer = new MutationObserver(
translate.listener.callback,
);
// 以上述配置开始观察目标节点
var docs = translate.getDocuments();
for (var docs_index = 0; docs_index < docs.length; docs_index++) {
var doc = docs[docs_index];
if (doc != null) {
translate.listener.observer.observe(doc, translate.listener.config);
}
}
},
/*
每当执行完一次渲染任务(翻译)时会触发此。注意页面一次翻译会触发多个渲染任务。普通情况下,一次页面的翻译可能会触发两三次渲染任务。
另外如果页面中有ajax交互方面的信息,时,每次ajax信息刷新后,也会进行翻译,也是一次渲染任务。
这个是为了方便扩展使用。比如在layui中扩展,监控 select 的渲染
*/
renderTaskFinish: (renderTask) => {
//console.log(renderTask);
},
/*
翻译执行过程中,相关的监控
*/
execute: {
/*
每当触发执行 translate.execute() 时,当缓存中未发现,需要请求翻译API进行翻译时,在发送API请求前,触发此
@param uuid:translate.nodeQueue[uuid] 这里的
@param from 来源语种,翻译前的语种
@param to 翻译为的语种
*/
renderStartByApi: [],
renderStartByApiRun: (uuid, from, to) => {
//console.log(translate.nodeQueue[uuid]);
for (
var i = 0;
i < translate.listener.execute.renderStartByApi.length;
i++
) {
try {
translate.listener.execute.renderStartByApi[i](uuid, from, to);
} catch (e) {
console.log(e);
}
}
},
/*
每当 translate.execute() 执行完毕(前提是采用API翻译的,API将翻译结果返回,并且界面上的翻译结果也已经渲染完毕)后,触发此方法。
@param uuid:translate.nodeQueue[uuid] 这里的
@param from 来源语种,翻译前的语种
@param to 翻译为的语种
*/
renderFinishByApi: [],
renderFinishByApiRun: (uuid, from, to) => {
//console.log(translate.nodeQueue[uuid]);
for (
var i = 0;
i < translate.listener.execute.renderFinishByApi.length;
i++
) {
try {
translate.listener.execute.renderFinishByApi[i](uuid, from, to);
} catch (e) {
console.log(e);
}
}
},
},
},
//对翻译结果进行替换渲染的任务,将待翻译内容替换为翻译内容的过程
renderTask: class {
constructor() {
/*
* 任务列表
* 一维数组 [hash] = tasks; tasks 是多个task的数组集合
* 二维数组 [task,task,...],存放多个 task,每个task是一个替换。这里的数组是同一个nodeValue的多个task替换
* 三维数组 task['originalText'] 、 task['resultText'] 存放要替换的字符串
task['attribute'] 存放要替换的属性,比如 a标签的title属性。 如果是直接替换node.nodeValue ,那这个没有
*/
this.taskQueue = [];
/*
* 要进行翻译的node元素,
* 一维数组 key:node.nodeValue 的 hash , value:node的元素数组
* 二维数组,也就是value中包含的node集合 [node,node,...]
*/
this.nodes = [];
}
/**
* 向替换队列中增加替换任务
* node:要替换的字符属于那个node元素
* originalText:待翻译的字符
* resultText:翻译后的结果字符
* attribute: 要替换的是哪个属性,比如 a标签的title属性,这里便是传入title。如果不是替换属性,这里不用传入,或者传入null
*/
add(node, originalText, resultText, attribute) {
var nodeAnaly = translate.element.nodeAnalyse.get(node, attribute); //node解析
//var hash = translate.util.hash(translate.element.getTextByNode(node)); //node中内容的hash
var hash = translate.util.hash(nodeAnaly["text"]);
//console.log('--------------'+hash);
//console.log(nodeAnaly);
//console.log(node);
//console.log('originalText:'+originalText+', resultText:'+resultText+', attribute:'+attribute);
/****** 加入翻译的元素队列 */
if (typeof this.nodes[hash] == "undefined") {
this.nodes[hash] = [];
}
this.nodes[hash].push(node);
//console.log(node)
/****** 加入翻译的任务队列 */
var tasks = this.taskQueue[hash];
if (tasks == null || typeof tasks == "undefined") {
//console.log(node.nodeValue);
tasks = []; //任务列表,存放多个 task,每个task是一个替换。这里的数组是同一个nodeValue的多个task替换
}
var task = [];
//v2.3.3 增加 -- 开始
//这里要进行处理,因为有时候翻译前,它前或者后是有空格的,但是翻译后会把前或者后的空格给自动弄没了,如果是这种情况,要手动补上
if (originalText.substr(0, 1) == " ") {
//console.log('第一个字符是空格');
if (resultText.substr(0, 1) != " ") {
//翻译结果的第一个字符不是空格,那么补上
resultText = " " + resultText;
}
}
if (originalText.substr(originalText.length - 1, 1) === " ") {
//console.log('最后一个字符是空格');
if (resultText.substr(0, 1) != " ") {
//翻译结果的最后一个字符不是空格,那么补上
resultText = resultText + " ";
}
}
//v2.3.3 增加 -- 结束
task["originalText"] = originalText;
task["resultText"] = resultText;
task["attribute"] = attribute;
//console.log(task);
tasks.push(task);
this.taskQueue[hash] = tasks;
/****** 加入翻译的任务队列 end */
}
//进行替换渲染任务,对页面进行渲染替换翻译
execute() {
//先对tasks任务队列的替换词进行排序,将同一个node的替换词有大到小排列,避免先替换了小的,大的替换时找不到
for (var hash in this.taskQueue) {
if (!Object.hasOwn(this.taskQueue, hash)) {
continue;
}
var tasks = this.taskQueue[hash];
if (typeof tasks == "function") {
//进行异常的预处理调出
continue;
}
//进行排序,将原字符串长的放前面,避免造成有部分不翻译的情况(bug是先翻译了短的,导致长的被打断而无法进行适配)
tasks.sort((a, b) => b.originalText.length - a.originalText.length);
this.taskQueue[hash] = tasks;
}
//console.log('===========task=========');
//console.log(this.taskQueue);
//console.log(this.nodes);
//console.log('===========task======end===');
//进行翻译前,先刷新一下 dom监听的忽略node,将过期的node剔除,降低listener的压力
translate.listener.refreshIgnoreNode();
//对nodeQueue进行翻译
for (var hash in this.nodes) {
if (!Object.hasOwn(this.nodes, hash)) {
continue;
}
var tasks = this.taskQueue[hash]; //取出当前node元素对应的替换任务
//var tagName = this.nodes[hash][0].nodeName; //以下节点的tag name
//console.log(tasks);
for (
var node_index = 0;
node_index < this.nodes[hash].length;
node_index++
) {
//对这个node元素进行替换翻译字符
for (var task_index = 0; task_index < tasks.length; task_index++) {
var task = tasks[task_index];
if (typeof tasks == "function") {
//进行异常的预处理调出
continue;
}
//翻译完毕后,再将这个翻译的目标node从 inPro....Nodes 中去掉
var ipnode = this.nodes[hash][task_index];
//console.log('int-----++'+ipnode.nodeValue);
setTimeout(
(ipnode) => {
//console.log('int-----'+ipnode.nodeValue);
for (
var ini = 0;
ini < translate.inProgressNodes.length;
ini++
) {
if (translate.inProgressNodes[ini].node.isSameNode(ipnode)) {
//console.log('in progress --');
//console.log(ipnode);
//有记录了,那么出现次数 +1
translate.inProgressNodes[ini].number =
translate.inProgressNodes[ini].number - 1;
//console.log("inProgressNodes -- number: "+translate.inProgressNodes[ini].number+', text:'+ipnode.nodeValue);
if (translate.inProgressNodes[ini].number < 1) {
translate.inProgressNodes.splice(ini, 1);
//console.log("inProgressNodes -- 减去node length: "+translate.inProgressNodes.length+', text:'+ipnode.nodeValue);
}
break;
}
}
},
50,
ipnode,
);
//渲染页面进行翻译显示
var analyseSet = translate.element.nodeAnalyse.set(
this.nodes[hash][task_index],
task.originalText,
task.resultText,
task["attribute"],
);
//加入 translate.listener.ignoreNode
translate.listener.addIgnore(
this.nodes[hash][task_index],
translate.listener.translateExecuteNodeIgnoreExpireTime,
analyseSet.resultText,
);
/*
//var tagName = translate.element.getTagNameByNode(this.nodes[hash][task_index]);//节点的tag name
//console.log(tagName)
//console.log(this.nodes[hash][task_index])
//var tagName = this.nodes[hash][task_index].nodeName; //节点的tag name
var nodename = translate.element.getNodeName(this.nodes[hash][task_index]);
//console.log(this.nodes[hash][task_index]+', '+task.originalText+', '+task.resultText+', tagName:'+tagName);
if(nodename == 'META'){
if(typeof(this.nodes[hash][task_index].name) != 'undefined' && this.nodes[hash][task_index].name != null){
//var nodeName = this.nodes[hash][task_index].name.toLowerCase(); //取meta 标签的name 属性
this.nodes[hash][task_index].content = this.nodes[hash][task_index].content.replace(new RegExp(translate.util.regExp.pattern(task.originalText),'g'), translate.util.regExp.resultText(task.resultText));
}
}else if(nodename == 'IMG'){
this.nodes[hash][task_index].alt = this.nodes[hash][task_index].alt.replace(new RegExp(translate.util.regExp.pattern(task.originalText),'g'), translate.util.regExp.resultText(task.resultText));
}else{
//普通的
//console.log('task.originalText : '+task.originalText);
//console.log(translate.util.regExp.pattern(task.originalText))
//console.log('task.resultText : '+task.resultText);
this.nodes[hash][task_index].nodeValue = this.nodes[hash][task_index].nodeValue.replace(new RegExp(translate.util.regExp.pattern(task.originalText),'g'), translate.util.regExp.resultText(task.resultText));
}
*/
}
}
}
//console.log('---listen');
//监听 - 增加到翻译历史里面 nodeHistory
if (
typeof this.taskQueue != "undefined" &&
Object.keys(this.taskQueue).length > 0
) {
setTimeout(() => {
/** 执行完成后,保存翻译的历史node **/
//将当前翻译完成的node进行缓存记录,以node唯一标识为key, node、以及node当前翻译之后的内容为值进行缓存。方便下一次执行 translate.execute() 时,若值未变化则不进行翻译
for (var hash in this.nodes) {
if (!Object.hasOwn(this.nodes, hash)) {
continue;
}
//console.log(translate.nodeQueue[uuid].list[lang][hash])
for (var nodeindex in this.nodes[hash]) {
if (!Object.hasOwn(this.nodes[hash], nodeindex)) {
continue;
}
//console.log(translate.nodeQueue[uuid].list[lang][hash].original);
//var nodename = translate.element.getNodeName(translate.nodeQueue[uuid].list[lang][hash].nodes[0].node);
//console.log("nodename:"+nodename);
var analyse = translate.element.nodeAnalyse.get(
this.nodes[hash][nodeindex],
);
//analyse.text analyse.node
var nodeid = nodeuuid.uuid(analyse.node);
if (nodeid.length == 0) {
//像是input的placeholder 暂时没考虑进去,这种就直接忽略了
continue;
}
//加入
/*
if(typeof(translate.nodeHistory[nodeid]) == 'object'){
//已经加入过了,判断它的值是否有发生过变化
if(translate.nodeHistory[nodeid].translateText == analyse.text){
//值相同,就不用再加入了
continue;
}
}
这里就不用判断了,直接同步到最新的,因为同一个node,可能有本地缓存直接更新,这样会非常快,网络的会慢2秒,因时间导致同步不是最新的
*/
//console.log(analyse);
//console.log('add-----'+analyse.text +', uuid:'+nodeid);
//console.log(analyse.node);
translate.nodeHistory[nodeid] = {};
translate.nodeHistory[nodeid].node = analyse.node;
if (translate.whole.isWhole(analyse.node)) {
//这个元素使用的是整体翻译的方式,那就直接将API接口返回的翻译内容作为node最终显示的结果。
//这样即使在翻译过程中其他js对这个元素的内容有改动了,那下次再触发翻译,还能对改动后的文本正常翻译,不至于使这个元素已被标记翻译过了,造成漏翻译。
translate.nodeHistory[nodeid].translateText =
this.taskQueue[hash][nodeindex].resultText;
} else {
//时间差会造成漏翻译情况,见if中的注释
translate.nodeHistory[nodeid].translateText = analyse.text;
}
}
}
//console.log(translate.nodeHistory);
/** 执行完成后,触发用户自定义的翻译完成执行函数 **/
translate.listener.renderTaskFinish(this);
}, 50);
} else {
//console.log(this.taskQueue);
//console.log('---this.taskQueue is null');
}
}
},
/*
当前状态,执行状态
0 空闲(或者执行翻译完毕)
10 扫描要翻译的node,并读取浏览器缓存的翻译内容进行渲染显示
20 浏览器缓存渲染完毕,ajax通过文本翻译接口开始请求,在发起ajax请求前,状态变为20,然后再发起ajax请求
至于翻译完毕后进行渲染,这个就不单独记录了,因为如果页面存在不同的语种,不同的语种是按照不同的请求来的,是多个异步同时进行的过程
*/
state: 0,
/*
等待翻译队列 v3.12.6 增加
当前是否有需要等待翻译的任务,这个目的是为了保证同一时间 translate.execute() 只有一次在执行,免得被新手前端给造成死循环,导致edge翻译给你屏蔽,用户网页还卡死
当执行 translate.execute() 时,会先判断状态 translate.state 是否是0空闲的状态,如果空闲,才会执行,如果不是空闲,则不会执行,而是进入到这里进行等待,等待执行完毕后 translate.state 变成0空闲之后,再来执行这里的
*/
waitingExecute: {
use: true, //默认是使用,自有部署场景不担心并发的场景,可以禁用,以提高用户使用体验。
/*
一维数组形态,存放执行的翻译任务
二维对象形态,存放执行传入的 docs
*/
queue: [],
/*
增加一个翻译任务到翻译队列中
docs 同 translate.execute(docs) 的传入参数
*/
add: (docs) => {
//向数组末尾追加
translate.waitingExecute.queue.push(docs);
//开启一个定时器进行触发
const intervalId = setInterval(() => {
if (translate.state == 0) {
//清除定时器,结束循环
clearInterval(intervalId);
var docs = translate.waitingExecute.get();
translate.execute(docs);
//console.log('stop waitingExecute setInterval');
}
}, 500);
},
/*
从 quque 中取第一个元素,同时将其从queue中删除掉它。
如果取的时候 quque已经没有任何元素了,会返回 null, 但是理论上不会出现null
*/
get: () => {
//使用 shift 方法删除数组的第一个元素,并将第一个元素的值返回
if (translate.waitingExecute.queue.length > 0) {
return translate.waitingExecute.queue.shift();
}
console.log(
"警告, translate.waitingExecute.get 出现异常,quque已空,但还往外取。",
);
return null;
},
/*
当前 translate.translateRequest[uuid] 的是否已经全部执行完毕
这里单纯只是对 translate.translateRequest[uuid] 的进行判断
这里要在 translate.json 接口触发完并渲染完毕后触发,当然接口失败时也要触发。
正常情况下,是根据本地语言不同,进行分别请求翻译的,比如本地中包含中文、英文、俄语三种语种,要翻译为韩语,那么
* 中文->韩语会请求一次api
* 英文->韩语会请求一次APi
* 俄语->韩语会请求一次APi
也就会触发三次
@param uuid translate.translateRequest[uuid]中的uuid,也是 translate.nodeQueue 中的uuid
@param from 来源语种,翻译前的语种
@param to 翻译为的语种
*/
isAllExecuteFinish: (uuid, from, to) => {
translate.listener.execute.renderFinishByApiRun(uuid, from, to);
//console.log('uuid:'+uuid+', from:'+from+', to:'+to);
for (var lang in translate.translateRequest[uuid]) {
if (!Object.hasOwn(translate.translateRequest[uuid], lang)) {
continue;
}
//console.log(translate.translateRequest[uuid])
for (
var i = 0;
i < translate.translateRequest[uuid][lang].length;
i++
) {
if (translate.translateRequest[uuid][lang][i].executeFinish == 0) {
//这个还没执行完,那么直接退出,不在向后执行了
//console.log('uuid:'+uuid+' lang:'+lang+' executeFinish:0 time:'+translate.translateRequest[uuid][lang][i][addtime]);
//这里要考虑进行时间判断
return;
}
}
}
//生命周期触发事件
translate.lifecycle.execute.renderFinish_Trigger(uuid, to);
//都执行完了,那么设置完毕
translate.state = 0;
translate.executeNumber++;
},
},
//execute() 方法已经被执行过多少次了, 只有execute() 完全执行完,也就是界面渲染完毕后,它才会+1
executeNumber: 0,
lifecycle: {
execute: {
/*
每当触发执行 translate.execute() 时,会先进行当前是否可以正常进行翻译的判定,比如 当前语种是否就已经是翻译之后的语种了是否没必要翻译了等。(这些初始判定可以理解成它的耗时小于1毫秒,几乎没有耗时)
经过初始的判断后,发现允许被翻译,那么在向后执行之前,先触发此。
也就是在进行翻译之前,触发此。
@param uuid:translate.nodeQueue[uuid] 这里的
@param to 翻译为的语种
*/
start: [],
start_Trigger: (uuid, to) => {
for (var i = 0; i < translate.lifecycle.execute.start.length; i++) {
try {
translate.lifecycle.execute.start[i](uuid, to);
} catch (e) {
console.log(e);
}
}
},
//待整理
start_old: [],
startRun: (uuid, from, to) => {
//console.log(translate.nodeQueue[uuid]);
for (
var i = 0;
i < translate.listener.execute.renderStartByApi.length;
i++
) {
try {
translate.listener.execute.renderStartByApi[i](uuid, from, to);
} catch (e) {
console.log(e);
}
}
},
/*
当扫描整个节点完成,进行翻译(1. 命中本地缓存、 2.进行网络翻译请求)之前,触发
待整理
*/
scanNodesFinsh: [],
/*
每当触发执行 translate.execute() 时,当缓存中未发现,需要请求翻译API进行翻译时,在发送API请求前,触发此
@param uuid:translate.nodeQueue[uuid] 这里的
@param from 来源语种,翻译前的语种
@param to 翻译为的语种
@param texts 要翻译的文本,它是一个数组形态,是要进行通过API翻译接口进行翻译的文本,格式如 ['你好','世界']
*/
translateNetworkBefore: [],
translateNetworkBefore_Trigger: (uuid, from, to, texts) => {
for (
var i = 0;
i < translate.lifecycle.execute.translateNetworkBefore.length;
i++
) {
try {
translate.lifecycle.execute.translateNetworkBefore[i](
uuid,
from,
to,
texts,
);
} catch (e) {
console.log(e);
}
}
},
/*
当 translate.execute() 触发网络翻译请求完毕(不管成功还是失败),并将翻译结果渲染到页面完毕后,触发此。
@param uuid translate.nodeQueue 的uuid
@param from
@param to 当前是执行的翻译为什么语种
@param text 网络请求翻译的文本/节点/。。。待定
*/
translateNetworkAfter: [], //已废弃
/*
translateNetworkAfter_Trigger:function(uuid, to){
for(var i = 0; i < translate.lifecycle.execute.translateNetworkAfter.length; i++){
try{
translate.lifecycle.execute.translateNetworkAfter[i](uuid, to);
}catch(e){
console.log(e);
}
}
},
*/
/*
translate.execute() 的翻译渲染完毕触发
这个完毕是指它当触发 translate.execute() 进行翻译后,无论是全部命中了本地缓存,还是有部分要通过翻译接口发起多个网络请求,当拿到结果(缓存中的翻译结果或多个不同的有xx语种翻译的网络请求全部完成,这个完成是包含所有成功跟失败的响应),并完成将翻译结果渲染到页面中进行显示后,触发此
它跟 translateNetworkFinish 的区别是, translateNetworkFinish 仅仅针对有网络请求的才会触发,而 renderFinish 是如果全部命中了浏览器本地缓存,无需发起任何网络翻译请求这种情况时,也会触发。
@param uuid translate.nodeQueue 的uuid
@param to 当前是执行的翻译为什么语种
*/
renderFinish: [
(uuid, to) => {
//这里默认带着一个触发翻译为英文后,自动对英文进行元素视觉处理,追加空格的
if (typeof translate.visual != "undefined") {
translate.visual.adjustTranslationSpacesByNodequeueUuid(uuid);
}
},
],
renderFinish_Trigger: (uuid, to) => {
for (
var i = 0;
i < translate.lifecycle.execute.renderFinish.length;
i++
) {
try {
translate.lifecycle.execute.renderFinish[i](uuid, to);
} catch (e) {
console.log(e);
}
}
},
},
},
/*translate.execute() start */
/*
执行翻译操作。翻译的是 nodeQueue 中的
docs 如果传入,那么翻译的只是传入的这个docs的。传入如 [document.getElementById('xxx'),document.getElementById('xxx'),...]
如果不传入或者传入null,则是翻译整个网页所有能翻译的元素
*/
execute: (docs) => {
if (translate.waitingExecute.use) {
if (translate.state != 0) {
console.log(
"当前翻译还未完结,新的翻译任务已加入等待翻译队列中,待翻译结束后便会执行当前翻译任务。",
);
translate.waitingExecute.add(docs);
return;
}
}
translate.state = 1;
//console.log('translate.state = 1');
if (typeof docs != "undefined") {
//execute传入参数,只有v2版本才支持
translate.useVersion = "v2";
}
if (translate.useVersion == "v1") {
//if(this.to == null || this.to == ''){
//采用1.x版本的翻译,使用google翻译
//translate.execute_v1();
//return;
//v2.5.1增加
console.log(
"提示:https://github.com/xnx3/translate 在 v2.5 版本之后,由于谷歌翻译调整,免费翻译通道不再支持,所以v1版本的翻译接口不再被支持,v1全线下架。考虑到v1已不能使用,当前已自动切换到v2版本。如果您使用中发现什么异常,请针对v2版本进行适配。",
);
translate.useVersion = "v2";
}
//版本检测
try {
translate.init();
} catch (e) {}
/****** 采用 2.x 版本的翻译,使用自有翻译算法 */
//每次执行execute,都会生成一个唯一uuid,也可以叫做队列的唯一标识,每一次执行execute都会创建一个独立的翻译执行队列
var uuid = translate.util.uuid();
//console.log('=====')
//console.log(translate.nodeQueue);
/* v2.4.3 将初始化放到了 translate.element.whileNodes 中,如果uuid对应的没有,则自动创建
translate.nodeQueue[uuid] = new Array(); //创建
translate.nodeQueue[uuid]['expireTime'] = Date.now() + 120*1000; //删除时间,10分钟后删除
translate.nodeQueue[uuid]['list'] = new Array();
*/
//console.log(translate.nodeQueue);
//console.log('=====end')
//如果页面打开第一次使用,先判断缓存中有没有上次使用的语种,从缓存中取出
if (translate.to == null || translate.to == "") {
var to_storage = translate.storage.get("to");
if (
to_storage != null &&
typeof to_storage != "undefined" &&
to_storage.length > 0
) {
translate.to = to_storage;
}
}
//渲染select选择语言
try {
translate.selectLanguageTag.render();
} catch (e) {
console.log(e);
}
//判断是否还未指定翻译的目标语言
if (
translate.to == null ||
typeof translate.to == "undefined" ||
translate.to.length == 0
) {
//未指定,判断如果指定了自动获取用户本国语种了,那么进行获取
if (translate.autoDiscriminateLocalLanguage) {
translate.executeByLocalLanguage();
} else {
//没有指定翻译目标语言、又没自动获取用户本国语种,则不翻译
translate.state = 0;
return;
}
}
//判断本地语种跟要翻译的目标语种是否一样,如果是一样,那就不需要进行任何翻译
if (translate.to == translate.language.getLocal()) {
if (translate.language.translateLocal) {
//这是自定义设置的允许翻译本地语种中,跟本地语种不一致的语言进行翻译
} else {
translate.state = 0;
return;
}
}
/********** 翻译进行 */
//生命周期-触发翻译进行之前,用户自定义的钩子
translate.lifecycle.execute.start_Trigger(uuid, translate.to);
//先进行图片的翻译替换,毕竟图片还有加载的过程
translate.images.execute();
/*
进行翻译指定的node操作。优先级为:
1. 这个方法已经指定的翻译 nodes
2. setDocuments 指定的
3. 整个网页
其实2、3都是通过 getDocuments() 取,在getDocuments() 就对2、3进行了判断
*/
var all;
if (typeof docs != "undefined" && docs != null) {
//1. 这个方法已经指定的翻译 nodes
/* v3.12.6 注释,转到判断非null
if(docs == null){
//要翻译的目标区域不存在
console.log('translate.execute(...) 中传入的要翻译的目标区域不存在。');
translate.state = 0;
return;
}
*/
if (typeof docs.length == "undefined") {
//不是数组,是单个元素
all = [];
all[0] = docs;
} else {
//是数组,直接赋予
all = docs;
}
} else {
//2、3
all = translate.getDocuments();
}
//console.log('----要翻译的目标元素-----');
//console.log(all)
if (all.length > 500) {
console.log("------tip------");
console.log(
"translate.execute( docs ) 传入的docs.length 过大,超过500,这很不正常,当前 docs.length : " +
all.length +
" ,如果你感觉真的没问题,请联系作者 http://translate.zvo.cn/43006.html 说明情况,根据你的情况进行分析。 当前只取前500个元素进行翻译",
);
}
//初始化 translate.element.tagAttribute ,主要针对 v3.17.10 版本的适配调整,对 translate.element.tagAttribute 的设置做了改变,做旧版本的适配
try {
for (var te_tag in translate.element.tagAttribute) {
if (!Object.hasOwn(translate.element.tagAttribute, te_tag)) {
continue;
}
if (translate.element.tagAttribute[te_tag] instanceof Array) {
//是 v3.17.10 之前版本的设置方式,要进行对旧版本的适配
var tArray = translate.element.tagAttribute[te_tag];
translate.element.tagAttribute[te_tag] = {
attribute: tArray,
condition: (element) => true,
};
}
}
} catch (e) {
console.log(e);
}
//检索目标内的node元素
for (var i = 0; (i < all.length) & (i < 500); i++) {
var node = all[i];
translate.element.whileNodes(uuid, node);
}
/***** translate.language.translateLanguagesRange 开始 *****/
if (translate.language.translateLanguagesRange.length > 0) {
//如果大于0,则是有设置,那么只翻译有设置的语种,不在设置中的语种不会参与翻译
for (var lang in translate.nodeQueue[uuid].list) {
if (!Object.hasOwn(translate.nodeQueue[uuid].list, lang)) {
continue;
}
if (translate.language.translateLanguagesRange.indexOf(lang) < 0) {
//删除这个语种
delete translate.nodeQueue[uuid].list[lang];
}
}
}
/***** translate.language.translateLanguagesRange 结束 *****/
//修复如果translate放在了页面最顶部,此时执行肯定扫描不到任何东西的,避免这种情况出现报错
if (typeof translate.nodeQueue[uuid] == "undefined") {
translate.nodeQueue[uuid] = [];
translate.nodeQueue[uuid].list = [];
console.log("--- translate.js warn tip 警告!! ---");
console.log(
"您使用translate.js时可能放的位置不对,不要吧 translate.js 放在网页最顶部,这样当 translate.js 进行执行,也就是 translate.execute() 执行时,因为网页是从上往下加载,它放在网页最顶部,那么它执行时网页后面的内容都还没加载出来,这个是不会获取到网页任何内容的,也就是它是不起任何作用的",
);
}
for (var lang in translate.nodeQueue[uuid].list) {
if (!Object.hasOwn(translate.nodeQueue[uuid].list, lang)) {
continue;
}
//console.log('lang:'+lang)
for (var hash in translate.nodeQueue[uuid].list[lang]) {
if (!Object.hasOwn(translate.nodeQueue[uuid].list[lang], hash)) {
continue;
}
//console.log(hash)
if (typeof translate.nodeQueue[uuid].list[lang][hash] == "function") {
//v2.10增加,避免hash冒出个 Contains 出来导致for中的.length 出错
continue;
}
if (
typeof translate.nodeQueue[uuid].list[lang][hash].nodes ==
"undefined" ||
typeof translate.nodeQueue[uuid].list[lang][hash].nodes.length ==
"undefined"
) {
//v3.16.2 增加,针对深圳北理莫斯科学校龙老师提出的这里 .length 遇到了 undefined 的情况
continue;
}
for (
var nodeindex =
translate.nodeQueue[uuid].list[lang][hash].nodes.length - 1;
nodeindex > -1;
nodeindex--
) {
//console.log(translate.nodeQueue[uuid].list[lang][hash].nodes);
var analyse = translate.element.nodeAnalyse.get(
translate.nodeQueue[uuid].list[lang][hash].nodes[nodeindex].node,
);
//analyse.text analyse.node
var nodeid = nodeuuid.uuid(analyse.node);
//translate.nodeQueue[uuid].list[lang][hash].nodes.splice(nodeindex, 1);
//console.log(nodeid+'\t'+analyse.text);
if (typeof translate.nodeHistory[nodeid] != "undefined") {
//存在,判断其内容是否发生了改变
//console.log('比较---------');
//console.log(translate.nodeHistory[nodeid].translateText);
//console.log(analyse.text);
if (translate.nodeHistory[nodeid].translateText == analyse.text) {
//内容未发生改变,那么不需要再翻译了,从translate.nodeQueue中删除这个node
translate.nodeQueue[uuid].list[lang][hash].nodes.splice(
nodeindex,
1,
);
//console.log('发现相等的node,删除 '+analyse.text+'\t'+hash);
} else {
//console.log("发现变化的node =======nodeid:"+nodeid);
//console.log(translate.nodeHistory[nodeid].translateText == analyse.text);
//console.log(translate.nodeHistory[nodeid].node);
//console.log(translate.nodeHistory[nodeid].translateText);
//console.log(analyse.text);
}
} else {
//console.log('未在 nodeHistory 中发现,新的node nodeid:'+nodeid);
//console.log(analyse.node)
}
}
if (translate.nodeQueue[uuid].list[lang][hash].nodes.length == 0) {
//如果node数组中已经没有了,那么直接把这个hash去掉
delete translate.nodeQueue[uuid].list[lang][hash];
}
}
if (Object.keys(translate.nodeQueue[uuid].list[lang]).length == 0) {
//如果这个语言中没有要翻译的node了,那么删除这个语言
delete translate.nodeQueue[uuid].list[lang];
}
}
//console.log('new queuq');
//console.log(translate.nodeQueue[uuid])
//translate.nodeHistory[nodeid]
//console.log('-----待翻译:----');
//console.log(translate.nodeQueue);
//translateTextArray[lang][0]
var translateTextArray = {}; //要翻译的文本的数组,格式如 ["你好","欢迎"]
var translateHashArray = {}; //要翻译的文本的hash,跟上面的index是一致的,只不过上面是存要翻译的文本,这个存hash值
/*
要进行第二次扫描的node - 2023.8.22 解决缓存会打散扫描到的翻译文本,导致翻译结束后找寻不到而导致不翻译的问题
一维 key: lang
二维 key: hash
三维 key:
node: 当前的node元素
四维 array: 当前缓存中进行翻译的文本数组:
cacheOriginal: 已缓存被替换前的文本
cacheTranslateText: 已缓存被替换后的翻译文本
*/
var twoScanNodes = {};
var cacheScanNodes = []; //同上面的 twoScanNodes,只不过 twoScanNodes 是按照lang存的,而这个不再有lang区分
for (var lang in translate.nodeQueue[uuid]["list"]) {
//二维数组中,取语言
if (!Object.hasOwn(translate.nodeQueue[uuid]["list"], lang)) {
continue;
}
//console.log('lang:'+lang); //lang为english这种语言标识
if (
lang == null ||
typeof lang == "undefined" ||
lang.length == 0 ||
lang == "undefined"
) {
//console.log('lang is null : '+lang);
continue;
}
translateTextArray[lang] = [];
translateHashArray[lang] = [];
const task = new translate.renderTask();
//console.log(translate.nodeQueue);
twoScanNodes[lang] = [];
//二维数组,取hash、value
for (var hash in translate.nodeQueue[uuid]["list"][lang]) {
if (!Object.hasOwn(translate.nodeQueue[uuid]["list"][lang], hash)) {
continue;
}
if (
typeof translate.nodeQueue[uuid]["list"][lang][hash] == "function"
) {
//跳出,增加容错。 正常情况下应该不会这样
continue;
}
//取原始的词,还未经过翻译的,需要进行翻译的词
//var originalWord = translate.nodeQueue[uuid]['list'][lang][hash]['original'];
//原始的node中的词
var originalWord =
translate.nodeQueue[uuid]["list"][lang][hash]["original"];
//要翻译的词
var translateText =
translate.nodeQueue[uuid]["list"][lang][hash]["translateText"];
//console.log(originalWord);
/*
//自定义术语后的。如果
var nomenclatureOriginalWord = translate.nomenclature.dispose(cache);
if(nomenclatureOriginalWord != originalWord){
has
}
*/
//console.log(originalWord == translateText ? '1':'xin:'+translateText);
//根据hash,判断本地是否有缓存了
var cacheHash =
originalWord == translateText
? hash
: translate.util.hash(translateText); //如果匹配到了自定义术语库,那翻译前的hash是被改变了
translate.nodeQueue[uuid]["list"][lang][hash]["cacheHash"] = cacheHash; //缓存的hash。 缓存时,其hash跟翻译的语言是完全对应的,缓存的hash就是翻译的语言转换来的
var cache = translate.storage.get(
"hash_" + translate.to + "_" + cacheHash,
);
//console.log(cacheHash+', '+cache);
//var twoScanNodes[] = []; //要进行第二次扫描的node
if (cache != null && cache.length > 0) {
//有缓存了
//console.log('find cache:'+cache);
//直接将缓存赋予
//for(var index = 0; index < this.nodeQueue[lang][hash].length; index++){
//this.nodeQueue[lang][hash][index].nodeValue = cache;
for (
var node_index = 0;
node_index <
translate.nodeQueue[uuid]["list"][lang][hash]["nodes"].length;
node_index++
) {
//console.log(translate.nodeQueue[uuid]['list'][lang][hash]['nodes'][node_index]);
//加入 translate.inProgressNodes
//取得这个翻译的node
var ipnode =
translate.nodeQueue[uuid]["list"][lang][hash]["nodes"][
node_index
]["node"];
//判断这个node是否已经在 inProgressNodes 记录了
var isFind = false;
for (var ini = 0; ini < translate.inProgressNodes.length; ini++) {
if (translate.inProgressNodes[ini].node.isSameNode(ipnode)) {
//有记录了,那么出现次数 +1
translate.inProgressNodes[ini].number++;
isFind = true;
//console.log('cache - find - ++ ');
//console.log(ipnode);
}
}
//未发现,那么还要将这个node加入进去
if (!isFind) {
//console.log('cache - find - add -- lang:'+lang+', hash:'+hash+' node_index:'+node_index);
//console.log(ipnode.nodeValue);
translate.inProgressNodes.push({ node: ipnode, number: 1 });
}
//console.log(translate.inProgressNodes);
//加入 translate.inProgressNodes -- 结束
//翻译结果的文本,包含了before 、 after 了
var translateResultText =
translate.nodeQueue[uuid]["list"][lang][hash]["nodes"][
node_index
]["beforeText"] +
cache +
translate.nodeQueue[uuid]["list"][lang][hash]["nodes"][
node_index
]["afterText"];
task.add(
translate.nodeQueue[uuid]["list"][lang][hash]["nodes"][
node_index
]["node"],
originalWord,
translateResultText,
translate.nodeQueue[uuid]["list"][lang][hash]["nodes"][
node_index
]["attribute"],
);
//this.nodeQueue[lang][hash]['nodes'][node_index].nodeValue = this.nodeQueue[lang][hash]['nodes'][node_index].nodeValue.replace(new RegExp(originalWord,'g'), cache);
//console.log(translateResultText);
//重新扫描这个node,避免这种情况:
//localstorage缓存中有几个词的缓存了,但是从缓存中使用时,把原本识别的要翻译的数据给打散了,导致翻译结果没法赋予,导致用户展示时有些句子没成功翻译的问题 -- 2023.8.22
//console.log('继续扫描 + 1 - '+twoScanNodes.length);
var twoScanIndex = -1; //当前元素是否在 twoScan 中已经加入了,如果已经加入了,那么这里赋予当前所在的下标
for (var i = 0; i < twoScanNodes[lang].length; i++) {
if (
translate.nodeQueue[uuid]["list"][lang][hash]["nodes"][
node_index
]["node"].isSameNode(twoScanNodes[lang][i]["node"])
) {
//if(translate.nodeQueue[uuid]['list'][lang][hash]['nodes'][node_index]['node'].isSameNode(cacheScanNodes[i]['node'])){
//如果已经加入过了,那么跳过
twoScanIndex = i;
break;
}
}
var twoScanIndex_cache = -1; //当前元素是否在 twoScan 中已经加入了,如果已经加入了,那么这里赋予当前所在的下标
for (var i = 0; i < cacheScanNodes.length; i++) {
//if(translate.nodeQueue[uuid]['list'][lang][hash]['nodes'][node_index]['node'].isSameNode(twoScanNodes[lang][i]['node'])){
if (
translate.nodeQueue[uuid]["list"][lang][hash]["nodes"][
node_index
]["node"].isSameNode(cacheScanNodes[i]["node"])
) {
//如果已经加入过了,那么跳过
twoScanIndex_cache = i;
break;
}
}
if (twoScanIndex == -1) {
//console.log(translate.nodeQueue[uuid]['list'][lang][hash]['nodes'][node_index]['node']);
twoScanIndex = twoScanNodes[lang].length;
twoScanNodes[lang][twoScanIndex] = {};
twoScanNodes[lang][twoScanIndex]["node"] =
translate.nodeQueue[uuid]["list"][lang][hash]["nodes"][
node_index
]["node"];
twoScanNodes[lang][twoScanIndex]["array"] = [];
}
if (twoScanIndex_cache == -1) {
twoScanIndex_cache = cacheScanNodes.length;
cacheScanNodes[twoScanIndex_cache] = {};
cacheScanNodes[twoScanIndex_cache]["node"] =
translate.nodeQueue[uuid]["list"][lang][hash]["nodes"][
node_index
]["node"];
cacheScanNodes[twoScanIndex_cache]["array"] = [];
}
//未加入过,那么加入
var arrayIndex = twoScanNodes[lang][twoScanIndex]["array"].length;
twoScanNodes[lang][twoScanIndex]["array"][arrayIndex] =
translateResultText;
var arrayIndex_cache =
cacheScanNodes[twoScanIndex_cache]["array"].length;
cacheScanNodes[twoScanIndex_cache]["array"][arrayIndex_cache] =
translateResultText;
//twoScanNodes[lang][twoScanIndex]['array'][arrayIndex] = translate.nodeQueue[uuid]['list'][lang][hash]['beforeText']+cache+translate.nodeQueue[uuid]['list'][lang][hash]['afterText'];
}
//}
continue; //跳出,不用在传入下面的翻译接口了
}
/*
//取出数组
var queueNodes = this.nodeQueue[lang][hash];
if(queueNodes.length > 0){
//因为在这个数组中的值都是一样的,那么只需要取出第一个就行了
var valueStr = queueNodes[0].nodeValue;
valueStr = this.util.charReplace(valueStr);
translateTextArray[lang].push(valueStr);
translateHashArray[lang].push(hash);
}
*/
//加入待翻译数组
translateTextArray[lang].push(translateText);
translateHashArray[lang].push(hash); //这里存入的依旧还是用原始hash,未使用自定义术语库前的hash,目的是不破坏 nodeQueue 的 key
}
task.execute(); //执行渲染任务
}
//console.log(twoScanNodes);
//console.log('cacheScanNodes:');
//console.log(cacheScanNodes);
if (
typeof translate.request.api.translate != "string" ||
translate.request.api.translate == null ||
translate.request.api.translate.length < 1
) {
//用户已经设置了不掉翻译接口进行翻译
translate.state = 0;
//生命周期触发事件
translate.lifecycle.execute.renderFinish_Trigger(uuid, translate.to);
translate.executeNumber++;
return;
}
/******* 进行第二次扫描、追加入翻译队列。目的是防止缓存打散扫描的待翻译文本 ********/
for (var lang in twoScanNodes) {
if (!Object.hasOwn(twoScanNodes, lang)) {
continue;
}
//记录第一次扫描的数据,以便跟第二次扫描后的进行对比
var firstScan = Object.keys(translate.nodeQueue[uuid]["list"][lang]);
var firstScan_lang_langth = firstScan.length; //第一次扫描后的数组长度
//console.log(twoScanNodes[lang]);
for (var i = 0; i < twoScanNodes[lang].length; i++) {
//找到这个node元素命中缓存后的翻译记录
for (var ci = 0; ci < cacheScanNodes.length; ci++) {
if (
twoScanNodes[lang][i].node.isSameNode(cacheScanNodes[ci]["node"])
) {
//如果发现,那么赋予
twoScanNodes[lang][i].array = cacheScanNodes[ci].array;
break;
}
}
twoScanNodes[lang][i].array.sort((a, b) => b.length - a.length);
//console.log(twoScanNodes[lang][i].array);
var nodeAnaly = translate.element.nodeAnalyse.get(
twoScanNodes[lang][i].node,
);
//console.log(nodeAnaly);
var text = nodeAnaly.text;
//console.log(text.indexOf(twoScanNodes[lang][i].array[0]));
for (var ai = 0; ai < twoScanNodes[lang][i].array.length; ai++) {
if (twoScanNodes[lang][i].array[ai] < 1) {
continue;
}
text = text.replace(
new RegExp(
translate.util.regExp.pattern(twoScanNodes[lang][i].array[ai]),
"g",
),
translate.util.regExp.resultText("\n"),
);
}
//console.log(text);
var textArray = text.split("\n");
//console.log(textArray);
for (var tai = 0; tai < textArray.length; tai++) {
if (textArray[tai] < 1) {
continue;
}
//console.log(textArray[tai]);
//将新增的追加到 translate.nodeQueue 中
translate.addNodeToQueue(uuid, nodeAnaly["node"], textArray[tai]);
}
}
//取第二次扫描追加后的数据
var twoScan = Object.keys(translate.nodeQueue[uuid]["list"][lang]);
var twoScan_lang_langth = twoScan.length; //第二次扫描后的数组长度
//console.log(firstScan_lang_langth+ '=='+twoScan_lang_langth);
if (firstScan_lang_langth - twoScan_lang_langth == 0) {
//一致,没有新增,那么直接跳出,忽略
continue;
}
//console.log(translate.nodeQueue[uuid]['list'][lang]);
//console.log(firstScan);
for (var ti = 0; ti < twoScan.length; ti++) {
var twoHash = twoScan[ti];
//console.log(twoHash + '-- '+firstScan.indexOf(twoHash));
if (firstScan.indexOf(twoHash) == -1) {
//需要追加了
var item = translate.nodeQueue[uuid]["list"][lang][twoHash];
var cacheHash =
item.original == item.translateText
? twoHash
: translate.util.hash(item.translateText); //如果匹配到了自定义术语库,那翻译前的hash是被改变了
translate.nodeQueue[uuid]["list"][lang][twoHash]["cacheHash"] =
cacheHash; //缓存的hash。 缓存时,其hash跟翻译的语言是完全对应的,缓存的hash就是翻译的语言转换来的
translateTextArray[lang].push(item.translateText);
translateHashArray[lang].push(twoHash);
}
}
}
/******* 进行第二次扫描、追加入翻译队列 -- 结束 ********/
//window.translateHashArray = translateHashArray;
//统计出要翻译哪些语种 ,这里面的语种会调用接口进行翻译。其内格式如 english
var fanyiLangs = [];
//console.log(translateTextArray)
for (var lang in translate.nodeQueue[uuid]["list"]) {
//二维数组中取语言
if (!Object.hasOwn(translate.nodeQueue[uuid]["list"], lang)) {
continue;
}
if (typeof translateTextArray[lang] == "undefined") {
continue;
}
if (translateTextArray[lang].length < 1) {
continue;
}
//如果当前语种就是需要显示的语种(也就是如果要切换的语种),那么也不会进行翻译,直接忽略
if (lang == translate.to) {
continue;
}
fanyiLangs.push(lang);
}
/******* 用以记录当前是否进行完第一次翻译了 *******/
/*
if(!translate.listener.isExecuteFinish){
translate.temp_executeFinishNumber = 0; //下面请求接口渲染,翻译执行完成的次数
//判断是否是执行完一次了
translate.temp_executeFinishInterval = setInterval(function(){
if(translate.temp_executeFinishNumber == fanyiLangs.length){
translate.listener.isExecuteFinish = true; //记录当前已执行完第一次了
clearInterval(translate.temp_executeFinishInterval);//停止
console.log('translate.execute() Finish!');
//console.log(uuid);
}
}, 50);
}
*/
//console.log(translate.nodeQueue[uuid]['list'])
if (fanyiLangs.length == 0) {
//没有需要翻译的,直接退出
//生命周期触发事件
translate.lifecycle.execute.renderFinish_Trigger(uuid, translate.to);
translate.state = 0;
translate.executeNumber++;
return;
}
//加入 translate.inProgressNodes -- start
for (var lang in translateHashArray) {
if (!Object.hasOwn(translateHashArray, lang)) {
continue;
}
if (typeof translateHashArray[lang] == "undefined") {
continue;
}
if (translateHashArray[lang].length < 1) {
continue;
}
for (var hai = 0; hai < translateHashArray[lang].length; hai++) {
var thhash = translateHashArray[lang][hai];
//取得这个翻译的node
//var ipnode = translate.nodeQueue[uuid]['list'][lang][thhash].nodes[ipni].node;
//console.log('translate.nodeQueue[\''+uuid+'\'][\'list\'][\'chinese_simplified\'][\''+thhash+'\']');
//console.log(lang);
//console.log(translate.nodeQueue[uuid]['list'][lang][thhash].nodes);
if (
typeof translate.nodeQueue[uuid]["list"][lang][thhash].nodes ==
"undefined" ||
typeof translate.nodeQueue[uuid]["list"][lang][thhash].nodes.length ==
"undefined"
) {
console.log(
"translate.nodeQueue['" +
uuid +
"']['list']['" +
lang +
"']['" +
thhash +
"'].nodes.length is null ,理论上不应该存在,进行异常报出,但不影响使用,已容错。",
);
continue;
}
for (
var ipni = 0;
ipni < translate.nodeQueue[uuid]["list"][lang][thhash].nodes.length;
ipni++
) {
//取得这个翻译的node
var ipnode =
translate.nodeQueue[uuid]["list"][lang][thhash].nodes[ipni].node;
//判断这个node是否已经在 inProgressNodes 记录了
var isFind = false;
for (var ini = 0; ini < translate.inProgressNodes.length; ini++) {
if (translate.inProgressNodes[ini].node.isSameNode(ipnode)) {
//有记录了,那么出现次数 +1
//console.log('net request ++');
//console.log(ipnode);
translate.inProgressNodes[ini].number++;
isFind = true;
}
}
//未发现,那么还要将这个node加入进去
if (!isFind) {
//console.log('net request add');
//console.log(ipnode);
translate.inProgressNodes.push({ node: ipnode, number: 1 });
}
}
}
}
//加入 translate.inProgressNodes -- end
//状态
translate.state = 20;
//进行掉接口翻译
for (var lang_index in fanyiLangs) {
//一维数组,取语言
if (!Object.hasOwn(fanyiLangs, lang_index)) {
continue;
}
var lang = fanyiLangs[lang_index];
if (typeof lang != "string") {
continue;
}
if (
typeof translateTextArray[lang] == "undefined" ||
translateTextArray[lang].length < 1
) {
console.log(
"异常,理论上不应该存在, lang:" + lang + ", translateTextArray:",
);
console.log(translateTextArray);
console.log(
"你无需担心,这个只是个提示,它并不影响你翻译的正常进行,只是个异常提示而已,它会自动容错处理的,不会影响翻译的使用。",
);
translate.state = 0;
translate.executeNumber++;
return;
}
//自定义术语
/*var nomenclatureCache = translate.nomenclature.dispose(cache);
for(var ttr_index = 0; ttr_index {
//console.log(data);
//console.log(translateTextArray[data.from]);
if (data.result == 0) {
if (
typeof translate.translateRequest[uuid] == "object" &&
typeof translate.translateRequest[uuid][data.from] == "object"
) {
translate.translateRequest[uuid][data.from]["result"] = 2;
translate.translateRequest[uuid][data.from].executeFinish = 1; //1是执行完毕
translate.translateRequest[uuid][data.from].stoptime = Math.floor(
Date.now() / 1000,
);
} else {
console.log(
"WARINNG!!! translate.translateRequest[uuid][data.from] is not object",
);
}
//为了兼容 v3.14以前的translate.service 版本,做了判断
var from = "";
if (typeof data.from != "undefined" && data.from != null) {
from = data.from;
}
var to = "";
if (typeof data.to != "undefined" && data.to != null) {
to = data.to;
} else {
to = translate.to;
}
translate.waitingExecute.isAllExecuteFinish(uuid, from, to);
console.log("=======ERROR START=======");
console.log(translateTextArray[data.from]);
//console.log(encodeURIComponent(JSON.stringify(translateTextArray[data.from])));
console.log("response : " + data.info);
console.log("=======ERROR END =======");
//translate.temp_executeFinishNumber++; //记录执行完的次数
return;
}
if (typeof translate.nodeQueue[uuid] == "undefined") {
console.log(
"提示:你很可能多次引入了 translate.js 所以造成了翻译本身的数据错乱,这只是个提示,它还是会给你正常翻译的,但是你最好不要重复引入太多次 translate.js ,正常情况下只需要引入一次 translate.js 就可以了。太多的话很可能会导致你页面卡顿",
);
return;
}
//console.log('-----待翻译3:----');
//console.log(translate.nodeQueue);
//console.log('response:'+uuid);
const task = new translate.renderTask();
//遍历 translateHashArray
for (var i = 0; i < translateHashArray[data.from].length; i++) {
//翻译前的语种,如 english
var lang = data.from;
//翻译后的内容
var text = data.text[i];
//如果text为null,那么这个可能是一次翻译字数太多,为了保持数组长度,拼上的null
if (text == null) {
continue;
}
// v3.0.3 添加,避免像是 JavaScript 被错误翻译为 “JavaScript的” ,然后出现了多个句子中都出现了Javascript时,会出现翻译后文本重复的问题
// 这里就是验证一下,翻译后的文本,是否会完全包含翻以前的文本,如果包含了,那么强制将翻译后的文本赋予翻译前的原始文本(也就是不被翻译)
if (
text
.toLowerCase()
.indexOf(translateTextArray[data.from][i].toLowerCase()) > -1
) {
//发现了,那么强制赋予翻以前内容
text = translateTextArray[data.from][i];
}
//翻译前的hash对应下标
var hash = translateHashArray[data.from][i];
var cacheHash =
translate.nodeQueue[uuid]["list"][lang][hash]["cacheHash"];
//取原始的词,还未经过翻译的,需要进行翻译的词
var originalWord = "";
try {
originalWord =
translate.nodeQueue[uuid]["list"][lang][hash]["original"];
//console.log('bef:'+translate.nodeQueue[uuid]['list'][lang][hash]['beforeText']);
} catch (e) {
console.log(
"uuid:" +
uuid +
", originalWord:" +
originalWord +
", lang:" +
lang +
", hash:" +
hash +
", text:" +
text +
", queue:" +
translate.nodeQueue[uuid],
);
console.log(e);
continue;
}
//for(var index = 0; index < translate.nodeQueue[lang][hash].length; index++){
for (
var node_index = 0;
node_index <
translate.nodeQueue[uuid]["list"][lang][hash]["nodes"].length;
node_index++
) {
//translate.nodeQueue[lang][hash]['nodes'][node_index].nodeValue = translate.nodeQueue[lang][hash]['nodes'][node_index].nodeValue.replace(new RegExp(originalWord,'g'), text);
//加入任务
task.add(
translate.nodeQueue[uuid]["list"][lang][hash]["nodes"][
node_index
]["node"],
originalWord,
translate.nodeQueue[uuid]["list"][lang][hash]["nodes"][
node_index
]["beforeText"] +
text +
translate.nodeQueue[uuid]["list"][lang][hash]["nodes"][
node_index
]["afterText"],
translate.nodeQueue[uuid]["list"][lang][hash]["nodes"][
node_index
]["attribute"],
);
}
//}
/*
for(var index = 0; index < translate.nodeQueue[data.from][hash].length; index++){
translate.nodeQueue[data.from][hash][index].nodeValue = text;
}
*/
//将翻译结果以 key:hash value翻译结果的形式缓存
translate.storage.set("hash_" + data.to + "_" + cacheHash, text);
//如果离线翻译启用了全部提取,那么还要存入离线翻译指定存储
if (translate.office.fullExtract.isUse) {
translate.office.fullExtract.set(
hash,
originalWord,
data.to,
text,
);
}
}
task.execute(); //执行渲染任务
//translate.temp_executeFinishNumber++; //记录执行完的次数
translate.translateRequest[uuid][lang].result = 1;
translate.translateRequest[uuid][lang].executeFinish = 1; //1是执行完毕
translate.translateRequest[uuid][lang].stoptime = Math.floor(
Date.now() / 1000,
);
setTimeout(() => {
translate.waitingExecute.isAllExecuteFinish(
uuid,
data.from,
data.to,
);
}, 10);
},
(xhr) => {
translate.translateRequest[uuid][xhr.data.from].executeFinish = 1; //1是执行完毕
translate.translateRequest[uuid][xhr.data.from].stoptime = Math.floor(
Date.now() / 1000,
);
translate.translateRequest[uuid][xhr.data.from].result = 3;
translate.waitingExecute.isAllExecuteFinish(
uuid,
xhr.data.from,
translate.to,
);
},
);
/*** 翻译end ***/
}
},
/*translate.execute() end */
/**
* 翻译请求记录
* 一维:key:uuid,也就是execute每次执行都会创建一个翻译队列,这个是翻译队列的唯一标识。 这个uuid跟 nodeQueue 的uuid是一样的
* value:对象
* 二维: 对象,包含:
* from 存放的是要翻译的源语种,比如要讲简体中文翻译为英文,这里存放的就是 chinese_simplified
* state 是否执行完毕,0是执行中, 1是执行完毕(不管是失败还是成功) 而且执行完毕是指ajax请求获得响应,并且dom渲染完成之后才算完毕。当然如果ajax接口失败那也是直接算完毕
* addtime 这条数据加入到本数组的时间,也就是进行ajax请求开始那一刻的时间,10位时间戳
* stoptime 执行完毕的时间,也就是state转为2那一刻的时间
* result 执行结果, 0 是还没执行完,等待执行完, > 0 是执行完了有结果了,
* 1 是执行成功
* 2 是接口有响应,也是200响应,但是接口响应的结果返回了错误,也就是返回了 {result:0, info:'...'}
* 3 是接口不是200响应码
*
*/
translateRequest: {
/*
uuid:[
'chinese_simplified':{
executeFinish:0,
addtime:150001111,
stoptime:150001111,
result:0
},
...
]
*/
},
/*
将已成功翻译并渲染的node节点进行缓存记录
key: node节点的唯一标识符,通过 nodeuuid.uuid() 生成
value:
node: node节点
translateText: 翻译完成后,当前node节点的内容文本(是已经翻译渲染过的)
*/
nodeHistory: {},
element: {
/*
注意,里面全部的必须小写。
第一个是tag,第二个是tag的属性。比如要翻译 input 的 value 属性,那么如下:
translate.element.tagAttribute['input']=['value'];
比如要翻译 input 的 value 、 data-value 这两个属性,那么如下:
translate.element.tagAttribute['input']=['value','data-value'];
有几个要翻译的属性,就写上几个。
同样,有几个要额外翻译的tag,就加上几行。
详细文档参考: http://translate.zvo.cn/231504.html
//针对宁德时代提出的需求,需要对 标签本身进行一个判定,是否符合条件符合条件才会翻译,不符合条件则不要进行翻译
//比如标签带有 disabled 的才会被翻译,所以要增加一个自定义入参的 function ,返回 true、false
translate.element.tagAttribute['input']={
//要被翻译的tag的属性,这里是要翻译 input 的 value 、 data-value 这两个属性。
//数组格式,可以一个或多个属性
attribute:['value','data-value'],
//条件,传入一个function,返回一个布尔值。
//只有当返回的布尔值是true时,才会对上面设置的 attribute 进行翻译,否则并不会对当前设定标签的 attribute 进行任何翻译操作。
condition:function(element){
// element 便是当前的元素,
// 比如这里是 translate.element.tagAttribute['input'] 那这个 element 参数便是扫描到的具体的 input 元素
// 可以针对 element 这个当前元素本身来进行判定,来决定是否进行翻译。
// 返回值是布尔值 true、false
// return true; //要对 attribute中设置的 ['value','data-value'] 这两个input 的属性的值进行翻译。
// 如果不设置或传入 condition ,比如单纯这样设置:
// translate.element.tagAttribute['input']={
// attribute:['value','data-value']
// }
// 那么这里默认就是 return true;
// return false; //不对 attribute中设置的 ['value','data-value'] 这两个input 的属性的值进行任何操作
return true;
}
};
*/
tagAttribute: {},
//对翻译前后的node元素的分析(翻以前)及渲染(翻译后)
nodeAnalyse: {
/*
获取node中的要进行翻译的文本内容、以及要操作的实际node对象(这个node对象很可能是传入的node中的某个子node)
node
attribute 要获取的是某个属性的值,还是node本身的值。比如 a标签的title属性的值,则传入 title。 如果是直接获取node.nodeValue ,那这个没有
返回结果是一个数组。其中:
['text']:要进行翻译的text内容文本
['node']:要进行翻译的目标node
*/
get: (node, attribute) =>
translate.element.nodeAnalyse.analyse(node, "", "", attribute),
/*
进行翻译之后的渲染显示
参数:
node 当前翻译的node元素
originalText 翻译之前的内容文本
resultText 翻译之后的内容文本
attribute 存放要替换的属性,比如 a标签的title属性。 如果是直接替换node.nodeValue ,那这个没有
返回结果是一个数组,其中:
resultText: 翻译完成之后的text内容文本,注意,如果返回的是空字符串,那么则是翻译结果进行替换时,并没有成功替换,应该是翻译的过程中,这个node的值被其他js又赋予其他内容了。
node: 进行翻译的目标node
*/
set: (node, originalText, resultText, attribute) =>
translate.element.nodeAnalyse.analyse(
node,
originalText,
resultText,
attribute,
),
/*
注意,这个不使用,只是服务于上面的get、set使用。具体使用用上面的get、set
1. 只传入 node:
获取node中的要进行翻译的文本内容、以及要操作的实际node对象(这个node对象很可能是传入的node中的某个子node)
返回结果是一个数组。其中:
['text']:要进行翻译的text内容文本
['node']:要进行翻译的目标node
2. 传入 node、originalText、 resultText
则是进行翻译之后的渲染显示
attribute : 进行替换渲染时使用,存放要替换的属性,比如 a标签的title属性。 如果是直接替换node.nodeValue ,那这个没有
返回结果是一个数组,其中:
resultText: 翻译完成之后的text内容文本。 当使用 translate.element.nodeAnalyse.set 时才会有这个参数返回。 注意,如果返回的是空字符串,那么则是翻译结果进行替换时,并没有成功替换,应该是翻译的过程中,这个node的值被其他js又赋予其他内容了。
text : 要进行翻译的text内容文本,当使用 translate.element.nodeAnalyse.get 时才会有这个参数的返回
node: 进行翻译的目标node
*/
analyse: (node, originalText, resultText, attribute) => {
var result = []; //返回的结果
result["node"] = node;
result["text"] = "";
var nodename = translate.element.getNodeName(node);
if (
attribute != null &&
typeof attribute == "string" &&
attribute.length > 0
) {
//这个node有属性,替换的是node的属性,而不是nodeValue
var nodeAttributeValue; //这个 attribute 属性的值
if (nodename == "INPUT" && attribute.toLowerCase() == "value") {
//如果是input 的value属性,那么要直接获取,而非通过 attribute ,不然用户自己输入的通过 attribute 是获取不到的 -- catl 赵阳 提出
nodeAttributeValue = node.value;
} else {
nodeAttributeValue = node[attribute];
}
result["text"] = nodeAttributeValue;
//替换渲染
if (typeof originalText != "undefined" && originalText.length > 0) {
if (typeof nodeAttributeValue != "undefined") {
//这种是主流框架,像是vue、element、react 都是用这种 DOM Property 的方式,更快
var resultShowText = translate.util.textReplace(
nodeAttributeValue,
originalText,
resultText,
translate.to,
);
if (nodename == "INPUT" && attribute.toLowerCase() == "value") {
//input 的value 对于用户输入的必须用 .value 操作
node.value = resultShowText;
} else {
node[attribute] = resultShowText; //2025.4.26 变更为此方式
}
if (resultShowText.indexOf(resultText) > -1) {
result["resultText"] = resultShowText;
} else {
result["resultText"] = "";
}
}
//这种 Html Attribute 方式 是 v3.12 版本之前一直使用的方式,速度上要慢于 上面的,为了向前兼容不至于升级出问题,后面可能会优化掉
var htmlAttributeValue = node.getAttribute(attribute);
if (
htmlAttributeValue != null &&
typeof htmlAttributeValue != "undefined"
) {
var resultShowText = translate.util.textReplace(
htmlAttributeValue,
originalText,
resultText,
translate.to,
);
//这个才是在v3.9.2 后要用的,上面的留着只是为了适配以前的
node.setAttribute(attribute, resultShowText);
if (resultShowText.indexOf(resultText) > -1) {
result["resultText"] = resultShowText;
} else {
result["resultText"] = "";
}
}
}
return result;
}
//正常的node ,typeof 都是 object
//console.log(typeof(node)+node);
if (nodename == "#text") {
//如果是普通文本,判断一下上层是否是包含在textarea标签中
if (typeof node.parentNode != "undefined") {
var parentNodename = translate.element.getNodeName(node.parentNode);
//console.log(parentNodename)
if (parentNodename == "TEXTAREA") {
//是textarea标签,那将nodename 纳入 textarea的判断中,同时将判断对象交于上级,也就是textarea标签
nodename = "TEXTAREA";
node = node.parentNode;
}
}
}
//console.log(nodename)
//console.log(translate.element.getNodeName(node.parentNode))
//console.log(node)
if (nodename == "INPUT" || nodename == "TEXTAREA") {
//console.log(node.attributes)
/*
1. input、textarea 输入框,要对 placeholder 做翻译
2. input 要对 type=button 的情况进行翻译
*/
if (
node.attributes == null ||
typeof node.attributes == "undefined"
) {
result["text"] = "";
return result;
}
//input,要对 type=button、submit 的情况进行翻译
if (nodename == "INPUT") {
if (
typeof node.attributes.type != "undefined" &&
typeof node.attributes.type.nodeValue != null &&
(node.attributes.type.nodeValue.toLowerCase() == "button" ||
node.attributes.type.nodeValue.toLowerCase() == "submit")
) {
//console.log('----是 0
) {
//替换渲染
if (
typeof originalText != "undefined" &&
originalText.length > 0
) {
var resultShowText = translate.util.textReplace(
input_value_node.nodeValue,
originalText,
resultText,
translate.to,
);
input_value_node.nodeValue = resultShowText; //2025.4.26 变更为此方式
if (resultShowText.indexOf(resultText) > -1) {
result["resultText"] = resultShowText;
} else {
result["resultText"] = "";
}
}
result["text"] = input_value_node.nodeValue;
result["node"] = input_value_node;
return result;
}
}
}
//console.log(node)
//input textarea 的 placeholder 情况
if (typeof node.attributes["placeholder"] != "undefined") {
//console.log(node);
//替换渲染
if (typeof originalText != "undefined" && originalText.length > 0) {
var resultShowText = translate.util.textReplace(
node.attributes["placeholder"].nodeValue,
originalText,
resultText,
translate.to,
);
node.attributes["placeholder"].nodeValue = resultShowText; //2025.4.26 变更为此方式
if (resultShowText.indexOf(resultText) > -1) {
result["resultText"] = resultShowText;
} else {
result["resultText"] = "";
}
}
result["text"] = node.attributes["placeholder"].nodeValue;
result["node"] = node.attributes["placeholder"];
return result;
//return node.attributes['placeholder'].nodeValue;
}
//console.log(node)
result["text"] = "";
return result;
}
if (nodename == "META") {
//meta标签,如是关键词、描述等
if (typeof node.name != "undefined" && node.name != null) {
var nodeAttributeName = node.name.toLowerCase(); //取meta 标签的name 属性
var nodeAttributePropertyOri = node.getAttribute("property"); //取 property的值
var nodeAttributeProperty = "";
if (
typeof nodeAttributePropertyOri != "undefined" &&
nodeAttributePropertyOri != null &&
nodeAttributePropertyOri.length > 0
) {
nodeAttributeProperty = nodeAttributePropertyOri.toLowerCase();
}
if (
nodeAttributeName == "keywords" ||
nodeAttributeName == "description" ||
nodeAttributeName == "sharetitle" ||
nodeAttributeProperty == "og:title" ||
nodeAttributeProperty == "og:description" ||
nodeAttributeProperty == "og:site_name" ||
nodeAttributeProperty == "og:novel:latest_chapter_name"
) {
//替换渲染
if (
typeof originalText != "undefined" &&
originalText != null &&
originalText.length > 0
) {
var resultShowText = translate.util.textReplace(
node.content,
originalText,
resultText,
translate.to,
);
node.content = resultShowText; //2025.4.26 变更为此方式
if (resultShowText.indexOf(resultText) > -1) {
result["resultText"] = resultShowText;
} else {
result["resultText"] = "";
}
}
result["text"] = node.content;
return result;
}
}
result["text"] = "";
return result;
}
if (nodename == "IMG") {
if (typeof node.alt == "undefined" || node.alt == null) {
result["text"] = "";
return result;
}
//替换渲染
if (typeof originalText != "undefined" && originalText.length > 0) {
var resultShowText = translate.util.textReplace(
node.alt,
originalText,
resultText,
translate.to,
);
node.alt = resultShowText; //2025.4.26 变更为此方式
if (resultShowText.indexOf(resultText) > -1) {
result["resultText"] = resultShowText;
} else {
result["resultText"] = "";
}
}
result["text"] = node.alt;
return result;
}
//其他的
if (node.nodeValue == null || typeof node.nodeValue == "undefined") {
result["text"] = "";
} else if (node.nodeValue.trim().length == 0) {
//避免就是单纯的空格或者换行
result["text"] = "";
} else {
//替换渲染
if (
typeof originalText != "undefined" &&
originalText != null &&
originalText.length > 0
) {
//console.log(originalText+'|');
var resultShowText = translate.util.textReplace(
node.nodeValue,
originalText,
resultText,
translate.to,
);
//console.log(resultShowText+'|');
node.nodeValue = resultShowText; //2025.4.26 变更为此方式
if (resultShowText.indexOf(resultText) > -1) {
result["resultText"] = resultShowText;
} else {
result["resultText"] = "";
}
}
result["text"] = node.nodeValue;
}
return result;
},
},
//获取这个node元素的node name ,如果未发现,则返回''空字符串
getNodeName: (node) => {
if (node == null || typeof node == "undefined") {
return "";
}
if (node.nodeName == null || typeof node.nodeName == "undefined") {
return "";
}
var nodename = node.nodeName;
if (typeof node.nodeName == "string") {
return node.nodeName;
}
if (typeof node.tagName == "string" && node.tagName.length > 0) {
return node.tagName;
}
console.log(
"warn : get nodeName is null, this node ignore translate. node : ",
);
console.log(node);
return "";
},
//向下遍历node
whileNodes: (uuid, node) => {
if (node == null || typeof node == "undefined") {
return;
}
//如果这个uuid没有,则创建
if (
typeof translate.nodeQueue[uuid] == "undefined" ||
translate.nodeQueue[uuid] == null
) {
translate.nodeQueue[uuid] = []; //创建
translate.nodeQueue[uuid]["expireTime"] = Date.now() + 120 * 1000; //删除时间,10分钟后删除
translate.nodeQueue[uuid]["list"] = [];
//console.log('创建 --- ');
//console.log(uuid)
}
//console.log('---'+typeof(node)+', ');
//判断是否是有title属性,title属性也要翻译
if (
typeof node == "object" &&
typeof node["title"] == "string" &&
node["title"].length > 0
) {
//将title加入翻译队列
//console.log('---'+node.title+'\t'+node.tagName);
//console.log(node)
//console.log('------------');
//判断当前元素是否在ignore忽略的tag、id、class name中
if (!translate.ignore.isIgnore(node)) {
//不在忽略的里面,才会加入翻译
translate.addNodeToQueue(uuid, node, node["title"], "title");
}
}
//v3.9.2 增加, 用户可自定义标签内 attribute 的翻译
var nodeNameLowerCase = translate.element.getNodeName(node).toLowerCase();
if (
typeof translate.element.tagAttribute[nodeNameLowerCase] != "undefined"
) {
//console.log('find:'+nodeNameLowerCase);
//console.log(translate.element.tagAttribute[nodeNameLowerCase]);
for (var attributeName_index in translate.element.tagAttribute[
nodeNameLowerCase
].attribute) {
if (
!Object.hasOwn(
translate.element.tagAttribute[nodeNameLowerCase].attribute,
attributeName_index,
)
) {
continue;
}
if (
typeof translate.element.tagAttribute[nodeNameLowerCase]
.condition != "undefined" &&
!translate.element.tagAttribute[nodeNameLowerCase].condition(node)
) {
continue;
}
var attributeName =
translate.element.tagAttribute[nodeNameLowerCase].attribute[
attributeName_index
];
//console.log(attributeName);
//console.log(node.getAttribute(attributeName));
if (
nodeNameLowerCase == "input" &&
attributeName.toLowerCase() == "value"
) {
//如果是input 的value属性,那么要直接获取,而非通过 attribute ,不然用户自己输入的通过 attribute 是获取不到的 - catl 赵阳 提出
attributeValue = node.value;
DOMPropOrHTMLAttr = "DOMProperty";
} else {
/*
* 默认是 HtmlAtrribute 也就是 HTML特性。取值有两个:
* HTMLAtrribute : HTML特性
* DOMProperty : DOM属性
*/
var DOMPropOrHTMLAttr = "HTMLAtrribute";
var attributeValue = node.getAttribute(attributeName);
if (
typeof attributeValue == "undefined" ||
attributeValue == null
) {
//vue、element、react 中的一些动态赋值,比如 element 中的 el-select 选中后赋予显示出来的文本,getAttribute 就取不到,因为是改动的 DOM属性,所以要用这种方式才能取出来
attributeValue = node[attributeName];
DOMPropOrHTMLAttr = "DOMProperty";
}
if (
typeof attributeValue == "undefined" ||
attributeValue == null
) {
//这个tag标签没有这个属性,忽略
continue;
}
}
//if(typeof(node.getAttribute(attributeName)) == 'undefined' && typeof(node[attributeName]) == 'undefined'){
// //这个tag标签没有这个 attribute,忽略
// continue
//}
//判断当前元素是否在ignore忽略的tag、id、class name中 v3.15.7 增加
if (!translate.ignore.isIgnore(node)) {
//加入翻译
translate.addNodeToQueue(uuid, node, attributeValue, attributeName);
}
}
}
var childNodes = node.childNodes;
if (childNodes == null || typeof childNodes == "undefined") {
return;
}
if (childNodes.length > 0) {
for (var i = 0; i < childNodes.length; i++) {
translate.element.whileNodes(uuid, childNodes[i]);
}
} else {
//单个了
translate.element.findNode(uuid, node);
}
},
findNode: (uuid, node) => {
if (node == null || typeof node == "undefined") {
return;
}
if (node.parentNode == null) {
return;
}
//console.log('-----parent')
var parentNodeName = translate.element.getNodeName(node.parentNode);
//node.parentNode.nodeName;
if (parentNodeName == "") {
return;
}
if (translate.ignore.tag.indexOf(parentNodeName.toLowerCase()) > -1) {
//忽略tag
//console.log('忽略tag:'+parentNodeName);
return;
}
/****** 判断忽略的class ******/
/*
这段理论上不需要了,因为在 translate.ignore.isIgnore 判断了
var ignoreClass = false; //是否是被忽略的class,true是
var parentNode = node.parentNode;
while(node != parentNode && parentNode != null){
//console.log('node:'+node+', parentNode:'+parentNode);
if(parentNode.className != null){
if(translate.ignore.class.indexOf(parentNode.className) > -1){
//发现ignore.class 当前是处于被忽略的 class
ignoreClass = true;
}
}
parentNode = parentNode.parentNode;
}
if(ignoreClass){
//console.log('ignore class : node:'+node.nodeValue);
return;
}
*/
/**** 判断忽略的class结束 ******/
/**** 避免中途局部翻译,在判断一下 ****/
//判断当前元素是否在ignore忽略的tag、id、class name中
if (translate.ignore.isIgnore(node)) {
//console.log('node包含在要忽略的元素中:');
//console.log(node);
return;
}
//node分析
var nodeAnaly = translate.element.nodeAnalyse.get(node);
//console.log(nodeAnaly)
if (nodeAnaly["text"].length > 0) {
//有要翻译的目标内容,加入翻译队列
//console.log('addNodeToQueue -- '+nodeAnaly['node']+', text:' + nodeAnaly['text']);
translate.addNodeToQueue(uuid, nodeAnaly["node"], nodeAnaly["text"]);
}
//console.log(nodeAnaly);
/*
//console.log(node.nodeName+', type:'+node.nodeType+', '+node.nodeValue);
var nodename = translate.element.getNodeName(node);
if(nodename == 'INPUT' || nodename == 'TEXTAREA'){
//input 输入框,要对 placeholder 做翻译
console.log('input---'+node.attributes);
if(node.attributes == null || typeof(node.attributes) == 'undefined'){
return;
}
if(typeof(node.attributes['placeholder']) != 'undefined'){
//console.log(node.attributes['placeholder'].nodeValue);
//加入要翻译的node队列
//translate.nodeQueue[translate.hash(node.nodeValue)] = node.attributes['placeholder'];
//加入要翻译的node队列
//translate.addNodeToQueue(translate.hash(node.attributes['placeholder'].nodeValue), node.attributes['placeholder']);
translate.addNodeToQueue(uuid, node.attributes['placeholder'], node.attributes['placeholder'].nodeValue);
}
//console.log(node.getAttribute("placeholder"));
}else if(nodename == 'META'){
//meta标签,如是关键词、描述等
if(typeof(node.name) != 'undefined' && node.name != null){
var nodeAttributeName = node.name.toLowerCase(); //取meta 标签的name 属性
//console.log(nodeName);
if(nodeAttributeName == 'keywords' || nodeAttributeName == 'description'){
//关键词、描述
translate.addNodeToQueue(uuid, node, node.content);
}
}
//console.log(node.name)
}else if(nodename == 'IMG'){
//console.log('-------'+node.alt);
translate.addNodeToQueue(uuid, node, node.alt);
}else if(node.nodeValue != null && node.nodeValue.trim().length > 0){
//过滤掉无效的值
if(node.nodeValue != null && typeof(node.nodeValue) == 'string' && node.nodeValue.length > 0){
}else{
return;
}
//console.log(node.nodeValue+' --- ' + translate.language.get(node.nodeValue));
//console.log(node.nodeName);
//console.log(node.parentNode.nodeName);
//console.log(node.nodeValue);
//加入要翻译的node队列
translate.addNodeToQueue(uuid, node, node.nodeValue);
//translate.addNodeToQueue(translate.hash(node.nodeValue), node);
//translate.nodeQueue[translate.hash(node.nodeValue)] = node;
//translate.nodeQueue[translate.hash(node.nodeValue)] = node.nodeValue;
//node.nodeValue = node.nodeValue+'|';
}
*/
},
},
/*
* 将发现的元素节点加入待翻译队列
* uuid execute方法执行的唯一id
* node 当前text所在的node
* text 当前要翻译的目标文本
* attribute 是否是元素的某个属性。比如 a标签中的title属性, a.title 再以node参数传入时是string类型的,本身并不是node类型,所以就要传入这个 attribute=title 来代表这是a标签的title属性。同样第二个参数node传入的也不能是a.title,而是传入a这个node元素
*/
addNodeToQueue: (uuid, node, text, attribute) => {
if (node == null || text == null || text.length == 0) {
return;
}
//console.log('find tag ignore : '+node.nodeValue+', '+node.nodeName+", "+node.nodeType+", "+node.tagName);
//console.log('addNodeToQueue into -- node:'+node+', text:'+text+', attribute:'+attribute);
var nodename = translate.element.getNodeName(node);
//判断如果是被 注释的区域,不进行翻译
if (nodename.toLowerCase() == "#comment") {
return;
}
//console.log('\t\t'+text);
//取要翻译字符的hash
var key = translate.util.hash(text);
/*
如果是input 的 placeholder ,就会出现这个情况
if(node.parentNode == null){
console.log('node.parentNode == null');
return;
}
*/
//console.log(node.parentNode);
//console.log(node.parentNode.nodeName);
//判断其内容是否是 script、style 等编程的文本,如果是,则不进行翻译,不然翻译后还会影响页面正常使用
if (translate.util.findTag(text)) {
//console.log('find tag ignore : '+node.nodeValue+', '+node.nodeName+", "+node.nodeType+", "+node.tagName);
//console.log(node.parentNode.nodeName);
//获取到当前文本是属于那个tag标签中的,如果是script、style 这样的标签中,那也会忽略掉它,不进行翻译
if (node.parentNode == null) {
//没有上级了,或是没获取到上级,忽略
return;
}
//去上级的tag name
var parentNodeName = translate.element.getNodeName(node.parentNode);
//node.parentNode.nodeName;
if (parentNodeName == "SCRIPT" || parentNodeName == "STYLE") {
//如果是script、style中发现的,那也忽略
return;
}
}
//console.log(node.nodeValue);
//原本传入的text会被切割为多个小块
var textArray = [];
textArray.push(text); //先将主 text 赋予 ,后面如果对主text进行加工分割,分割后会将主text给删除掉
//console.log(textArray);
// 处理 ignore.regex
for (var ri = 0; ri < translate.ignore.textRegex.length; ri++) {
var regex = translate.ignore.textRegex[ri];
for (var tai = 0; tai < textArray.length; tai++) {
var text = textArray[tai];
var ignoreTexts = text.match(regex) || [];
translate.ignore.text = translate.ignore.text.concat(ignoreTexts);
}
}
/**** v3.10.2.20241206 - 增加自定义忽略翻译的文本,忽略翻译的文本不会被翻译 - 当然这样会打乱翻译之后阅读的连贯性 ****/
for (var ti = 0; ti < translate.ignore.text.length; ti++) {
if (translate.ignore.text[ti].trim().length == 0) {
continue;
}
textArray = translate.addNodeToQueueTextAnalysis(
uuid,
node,
textArray,
attribute,
translate.ignore.text[ti],
translate.ignore.text[ti],
);
//console.log(textArray);
}
/**** v3.10.2.20241206 - 自定义术语能力全面优化 - 当然这样会打乱翻译之后阅读的连贯性 ****/
//判断是否进行了翻译,也就是有设置目标语种,并且跟当前语种不一致
if (typeof translate.temp_nomenclature == "undefined") {
translate.temp_nomenclature = [];
}
if (
typeof translate.temp_nomenclature[translate.language.getLocal()] ==
"undefined"
) {
nomenclatureKeyArray = [];
}
if (
typeof translate.nomenclature.data[translate.language.getLocal()] !=
"undefined" &&
typeof translate.nomenclature.data[translate.language.getLocal()][
translate.to
] != "undefined"
) {
var nomenclatureKeyArray;
for (var nomenclatureKey in translate.nomenclature.data[
translate.language.getLocal()
][translate.to]) {
if (
!Object.hasOwn(
translate.nomenclature.data[translate.language.getLocal()][
translate.to
],
nomenclatureKey,
)
) {
continue;
}
//nomenclatureKey 便是自定义术语的原始文本,值是要替换为的文本
//console.log(nomenclatureKey);
//自定义属于的指定的结果字符串
var nomenclatureValue =
translate.nomenclature.data[translate.language.getLocal()][
translate.to
][nomenclatureKey];
textArray = translate.addNodeToQueueTextAnalysis(
uuid,
node,
textArray,
attribute,
nomenclatureKey,
nomenclatureValue,
);
if (typeof nomenclatureKeyArray != "undefined") {
nomenclatureKeyArray.push(nomenclatureKey);
}
}
if (
typeof translate.temp_nomenclature[translate.language.getLocal()] ==
"undefined"
) {
translate.temp_nomenclature[translate.language.getLocal()] =
nomenclatureKeyArray;
}
}
/**** v3.10.2.20241206 - 自定义术语能力全面优化 - end ****/
for (var tai = 0; tai < textArray.length; tai++) {
if (textArray[tai].trim().length == 0) {
continue;
}
//判断是否出现在自定义忽略字符串
if (translate.ignore.text.indexOf(textArray[tai].trim()) > -1) {
//console.log(textArray[tai]+' 是忽略翻译的文本,不翻译');
continue;
}
//判断是否出现在自定义术语的
if (
typeof translate.temp_nomenclature[translate.language.getLocal()] !=
"undefined"
) {
if (
translate.temp_nomenclature[translate.language.getLocal()].indexOf(
textArray[tai].trim(),
) > -1
) {
//console.log(textArray[tai]+' 是自定义术语,不翻译');
continue;
}
}
translate.addNodeToQueueAnalysis(uuid, node, textArray[tai], attribute);
}
//this.nodeQueue[lang][key][this.nodeQueue[lang][key].length]=node; //往数组中追加
},
/**
* 服务于上面的 addNodeToQueue ,用于区分不同type情况,进行调用此加入 translate.nodeQueue
* uuid, node, attribute 这及个参数说明见 addNodeToQueue 的参数说明,相同
* textArray 进行处理的要翻译的文本数组。这个最开始只是一个,但是命中后分割的多了也就变成多个了
* nomenclatureKey 替换的原始文本,也就是自定义术语的key部分
* nomenclatureValue 替换的目标文本,也就是自定义术语的value部分 。 如果 nomenclatureKey = nomenclatureValue 则是自定义忽略翻译的文本。这个文本不被翻译
* @return 处理过后的 textArray 如果没有命中则返回的是传入的 textArray ,命中了则是切割以及删除原本判断的text之后的 textArray
*/
addNodeToQueueTextAnalysis: (
uuid,
node,
textArray,
attribute,
nomenclatureKey,
nomenclatureValue,
) => {
var deleteTextArray = []; //记录要从 textArray 中删除的字符串
for (var tai = 0; tai < textArray.length; tai++) {
var text = textArray[tai];
if (text.trim() == nomenclatureValue.trim()) {
//这里是自定义术语被替换后,重新扫描时扫出来的,那么直接忽略,不做任何处理。因为自定义术语的结果就是最终结果了
continue;
}
//判断一下原始文本是否有出现在了这个word要翻译的字符串中
var wordKeyIndex = text.indexOf(nomenclatureKey);
if (wordKeyIndex > -1) {
//出现了,那么需要将其立即进行更改,将自定义术语定义的结果渲染到页面中,并且将 word 要翻译的字符串中,自定义术语部分删除,只翻译除了自定义术语剩余的部分
//console.log(text+' --> '+nomenclatureKey);
/*
* 判断一下这个text中,出现匹配自定义术语的部分,是否是已经被替换过了,比如要将 好 替换为 你好 ,这里的好会重复替换。这里是判断这种情况
* 其中要判断一下 key 不等于value,因为key等于value,属于是指定这个key不被翻译的情况
*/
if (nomenclatureKey != nomenclatureValue) {
var substringStart = wordKeyIndex - nomenclatureValue.length;
if (substringStart < 0) {
substringStart = 0;
}
var substringEnd = wordKeyIndex + nomenclatureValue.length;
if (substringEnd > text.length) {
substringEnd = text.length;
}
var nomenclatureValueJudgement = text.substring(
substringStart,
substringEnd,
);
//console.log(text+', '+nomenclatureValueJudgement);
if (nomenclatureValueJudgement.indexOf(nomenclatureValue) > -1) {
//已经替换过了,可能会重复替换,所以忽略掉
continue;
}
}
// 2025.4.26 优化,将不再在此处进行处理,交有 translate.util.textReplace 在页面最终渲染前处理
// //判断当前是否是英语及变种,也就是单词之间需要有空格的,如果前后没有空格,要补充上空格
// if(translate.language.wordBlankConnector(translate.to)){
// if(wordKeyIndex > 0){
// //它前面还有文本,判断它前面的文本是否是空格,如果不是,那么要补充上空格
// var before = text.charAt(wordKeyIndex-1);
// //console.log(before);
// if(!(/\s/.test(before))){
// //不是空白字符,补充上一个空格,用于将两个单词隔开
// nomenclatureValue = ' '+nomenclatureValue
// }
// }
// if(wordKeyIndex + nomenclatureKey.length < text.length){
// //它后面还有文本,判断它前面的文本是否是空格,如果不是,那么要补充上空格
// var after = text.charAt(wordKeyIndex + nomenclatureKey.length);
// //console.log(after);
// // 2025.4.23 woodsway提出bug修复 https://gitee.com/mail_osc/translate/issues/IC34VN
// if(!(/\s/.test(after))){
// //不是空白字符,补充上一个空格,用于将两个单词隔开
// nomenclatureValue = nomenclatureValue+' ';
// }
// }
// }
//如果是自定义术语的key等于value,则是属于指定的某些文本不进行翻译的情况,所以这里要单独判断一下
//console.log(nomenclatureKey+':'+nomenclatureValue);
if (nomenclatureKey != nomenclatureValue) {
translate.element.nodeAnalyse.set(
node,
nomenclatureKey,
nomenclatureValue,
attribute,
);
}
//从 text 中将自定义术语的部分删掉,自定义术语的不被翻译
var wordSplits = text.split(nomenclatureKey);
var isPushTextArray = false;
for (var index = 0; index < wordSplits.length; index++) {
//console.log(index);
var subWord = wordSplits[index]; //分割后的子字符串
if (subWord.trim().length == 0) {
continue;
}
//console.log(subWord);
//将其加入 textArray 中
textArray.push(subWord);
deleteTextArray.push(text);
}
//console.log(wordSplits);
//自定义术语适配完后就直接退出了
//return wordSplits;
}
}
//console.log(deleteTextArray)
//从 textArray 中删除
if (deleteTextArray.length > 0) {
for (var di = 0; di < deleteTextArray.length; di++) {
const index = textArray.indexOf(deleteTextArray[di]);
if (index > -1) {
//console.log(textArray);
//console.log(deleteTextArray[di]);
textArray.splice(index, 1);
//console.log(textArray);
}
}
}
//console.log(textArray);
return textArray;
},
/*
服务于上面的 addNodeToQueue ,用于区分不同type情况,进行调用此加入 translate.nodeQueue
uuid, node, attribute 这五个参数说明见 addNodeToQueue 的参数说明,相同
word 要实际进行翻译的文本,也就是要把它拿来进行通过后端翻译接口进行翻译的文本
lang 当前要翻译的文本的语种,如 english
beforeText 参见 translate.nodeQueue 注释中第七维的解释
afterText 参见 translate.nodeQueue 注释中第七维的解释
*/
addNodeToQueueAnalysis: (uuid, node, text, attribute) => {
//获取当前是什么语种
//var langs = translate.language.get(text);
var textRecognition = translate.language.recognition(text);
var langs = textRecognition.languageArray;
//console.log('langs');
//console.log(langs);
//过滤掉要转换为的目标语种,比如要转为英语,那就将本来是英语的部分过滤掉,不用再翻译了
if (typeof langs[translate.to] != "undefined") {
delete langs[translate.to];
}
var isWhole = translate.whole.isWhole(node);
//console.log('isWhole:'+isWhole+', '+text);
if (!isWhole) {
//常规方式,进行语种分类
/* if(this.nodeQueue[lang] == null || typeof(this.nodeQueue[lang]) == 'undefined'){
this.nodeQueue[lang] = new Array();
}
//创建二维数组
if(this.nodeQueue[lang][key] == null || typeof(this.nodeQueue[lang][key]) == 'undefined'){
this.nodeQueue[lang][key] = new Array();
}
*/
//console.log(langs);
for (var lang in langs) {
if (!Object.hasOwn(langs, lang)) {
continue;
}
//创建二维数组, key为语种,如 english
/*
放到了 translate.addNodeQueueItem 进行判断
if(translate.nodeQueue[uuid]['list'][lang] == null || typeof(translate.nodeQueue[uuid]['list'][lang]) == 'undefined'){
translate.nodeQueue[uuid]['list'][lang] = new Array();
}
*/
//console.log('|'+langs[lang].length);
//遍历出该语种下有哪些词需要翻译
for (
var word_index = 0;
word_index < langs[lang].list.length;
word_index++
) {
//console.log('start:'+word_index)
//console.log(langs[lang].list[word_index]);
if (
typeof langs[lang].list[word_index] == "undefined" ||
typeof langs[lang].list[word_index]["text"] == "undefined"
) {
//理论上应该不会,但多加个判断
continue;
}
var word = langs[lang].list[word_index]["text"]; //要翻译的词
var beforeText = langs[lang].list[word_index]["beforeText"];
var afterText = langs[lang].list[word_index]["afterText"];
//console.log(lang+' - '+word);
translate.addNodeQueueItem(
uuid,
node,
word,
attribute,
lang,
beforeText,
afterText,
);
/*
var hash = translate.util.hash(word); //要翻译的词的hash
//创建三维数组, key为要通过接口翻译的文本词或句子的 hash (注意并不是node的文本,而是node拆分后的文本)
if(translate.nodeQueue[uuid]['list'][lang][hash] == null || typeof(translate.nodeQueue[uuid]['list'][lang][hash]) == 'undefined'){
translate.nodeQueue[uuid]['list'][lang][hash] = new Array();
translate.nodeQueue[uuid]['list'][lang][hash]['nodes'] = new Array();
translate.nodeQueue[uuid]['list'][lang][hash]['original'] = word;
translate.nodeQueue[uuid]['list'][lang][hash]['translateText'] = translate.nomenclature.dispose(word); //自定义术语处理
//translate.nodeQueue[uuid]['list'][lang][hash]['beforeText'] = beforeText;
//translate.nodeQueue[uuid]['list'][lang][hash]['afterText'] = afterText;
//translate.nodeQueue[uuid]['list'][lang][hash]['attribute'] = attribute; //放入 nodes[index][attribute] 元素中
//其中key: nodes 是第四维数组,里面存放具体的node元素对象
//console.log(translate.nodeQueue[uuid]['list'][lang][hash]);
}
var isEquals = false; //queue中是否已经加入过这个node了(当然是同一hash同一node情况)
if(typeof(node.isSameNode) != 'undefined'){ //支持 isSameNode 方法判断对象是否相等
for(var node_index = 0; node_index < translate.nodeQueue[uuid]['list'][lang][hash]['nodes'].length; node_index++){
if(node.isSameNode(translate.nodeQueue[uuid]['list'][lang][hash]['nodes'][node_index]['node'])){
//相同,那就不用在存入了
//console.log('相同,那就不用在存入了')
isEquals = true;
//console.log(node)
continue;
}
}
}
if(isEquals){
//相同,那就不用在存入了
continue;
}
//往五维数组nodes中追加node元素
var nodesIndex = translate.nodeQueue[uuid]['list'][lang][hash]['nodes'].length;
translate.nodeQueue[uuid]['list'][lang][hash]['nodes'][nodesIndex] = new Array();
translate.nodeQueue[uuid]['list'][lang][hash]['nodes'][nodesIndex]['node']=node;
translate.nodeQueue[uuid]['list'][lang][hash]['nodes'][nodesIndex]['attribute']=attribute;
translate.nodeQueue[uuid]['list'][lang][hash]['nodes'][nodesIndex]['beforeText'] = beforeText;
translate.nodeQueue[uuid]['list'][lang][hash]['nodes'][nodesIndex]['afterText'] = afterText;
*/
//console.log('end:'+word_index)
}
}
} else {
//直接翻译整个元素内的内容,不再做语种分类,首先删除英文,然后将出现次数最多的语种作为原本语种
var lang = textRecognition.languageName;
//console.log(lang+' - '+text);
translate.addNodeQueueItem(uuid, node, text, attribute, lang, "", "");
}
},
/*
服务于上面的 addNodeToQueue ,用于区分不同type情况,进行调用此加入 translate.nodeQueue
uuid, node, attribute 这五个参数说明见 addNodeToQueue 的参数说明,相同
word 要实际进行翻译的文本,也就是要把它拿来进行通过后端翻译接口进行翻译的文本
lang 当前要翻译的文本的语种,如 english
beforeText 参见 translate.nodeQueue 注释中第七维的解释
afterText 参见 translate.nodeQueue 注释中第七维的解释
*/
addNodeQueueItem: (
uuid,
node,
word,
attribute,
lang,
beforeText,
afterText,
) => {
//创建二维数组, key为语种,如 english
if (
translate.nodeQueue[uuid]["list"][lang] == null ||
typeof translate.nodeQueue[uuid]["list"][lang] == "undefined"
) {
translate.nodeQueue[uuid]["list"][lang] = [];
}
//console.log(word)
//var word = text; //要翻译的文本
var hash = translate.util.hash(word); //要翻译的文本的hash
//创建三维数组, key为要通过接口翻译的文本词或句子的 hash 。这里翻译的文本也就是整个node元素的内容了,不用在做拆分了
if (
translate.nodeQueue[uuid]["list"][lang][hash] == null ||
typeof translate.nodeQueue[uuid]["list"][lang][hash] == "undefined"
) {
translate.nodeQueue[uuid]["list"][lang][hash] = [];
/*
* 创建四维数组,存放具体数据
* key: nodes 包含了这个hash的node元素的数组集合,array 多个。其中
nodes[index]['node'] 存放当前的node元素
nodes[index]['attribute'] 存放当前hash,也就是翻译文本针对的是什么,是node本身(nodeValue),还是 node 的某个属性,比如title属性。如果这里不为空,那就是针对的属性操作的
* key: original 原始的要翻译的词或句子,html加载完成但还没翻译前的文本,用于支持当前页面多次语种翻译切换而无需跳转
* beforeText、afterText:见 translate.nodeQueue 的说明
*/
translate.nodeQueue[uuid]["list"][lang][hash]["nodes"] = [];
translate.nodeQueue[uuid]["list"][lang][hash]["original"] = word;
//自定义术语处理在此前面已经执行过了,所以这个废弃,不需要处理自定义术语部分了
//translate.nodeQueue[uuid]['list'][lang][hash]['translateText'] = translate.nomenclature.dispose(word);
translate.nodeQueue[uuid]["list"][lang][hash]["translateText"] = word;
//console.log(word)
//其中key: nodes 是第四维数组,里面存放具体的node元素对象
}
var isEquals = false; //queue中是否已经加入过这个node了(当然是同一hash同一node情况)
if (typeof node.isSameNode != "undefined") {
//支持 isSameNode 方法判断对象是否相等
for (
var node_index = 0;
node_index <
translate.nodeQueue[uuid]["list"][lang][hash]["nodes"].length;
node_index++
) {
if (
node.isSameNode(
translate.nodeQueue[uuid]["list"][lang][hash]["nodes"][node_index][
"node"
],
)
) {
//相同,那就不用在存入了
//console.log('相同,那就不用在存入了')
isEquals = true;
}
}
}
if (isEquals) {
//相同,那就不用在存入了
return;
}
//往五维数组nodes中追加node元素
var nodesIndex =
translate.nodeQueue[uuid]["list"][lang][hash]["nodes"].length;
translate.nodeQueue[uuid]["list"][lang][hash]["nodes"][nodesIndex] = [];
translate.nodeQueue[uuid]["list"][lang][hash]["nodes"][nodesIndex]["node"] =
node;
translate.nodeQueue[uuid]["list"][lang][hash]["nodes"][nodesIndex][
"attribute"
] = attribute;
translate.nodeQueue[uuid]["list"][lang][hash]["nodes"][nodesIndex][
"beforeText"
] = beforeText;
translate.nodeQueue[uuid]["list"][lang][hash]["nodes"][nodesIndex][
"afterText"
] = afterText;
},
//全部翻译,node内容全部翻译,而不是进行语种提取,直接对node本身的全部内容拿出来进行直接全部翻译
whole: {
isEnableAll: false, //是否开启对整个html页面的整体翻译,也就是整个页面上所有存在的能被翻译的全部会采用整体翻译的方式。默认是 false不开启
enableAll: () => {
translate.whole.isEnableAll = true;
},
/*
一下三个,也就是 class tag id 分别存储加入的值。使用参考:http://translate.zvo.cn/42563.html
*/
class: [],
tag: [],
id: [],
//运行时出现自检并在浏览器控制台提示性文本。
//在执行翻译,也就是 execute() 时,会调用此方法。
executeTip: () => {
if (
translate.whole.class.length == 0 &&
translate.whole.tag.length == 0 &&
translate.whole.id.length == 0
) {
} else {
console.log(
"您开启了 translate.whole 此次行为避开了浏览器端的文本语种自动识别,而是暴力的直接对某个元素的整个文本进行翻译,很可能会产生非常大的翻译量,请谨慎!有关每日翻译字符的说明,可参考: http://translate.zvo.cn/42557.html ",
);
}
if (translate.whole.tag.indexOf("html") > -1) {
console.log(
"自检发现您设置了 translate.whole.tag 其中有 html ,这个是不生效的,最大只允许设置到 body ",
);
}
},
//当前元素是属于全部翻译定义的元素
/*
传入一个元素,判断这个元素是否是被包含的。 这个会找父类,看看父类中是否包含在其之中。
return true是在其中,false不再其中
*/
isWhole: (ele) => {
if (translate.whole.isEnableAll) {
return true;
}
//如果设置了 class|tag|id 其中某个,或者 all=true ,那么就是启用,反之未启用
if (
translate.whole.class.length == 0 &&
translate.whole.tag.length == 0 &&
translate.whole.id.length == 0 &&
translate.whole.isEnableAll == false
) {
//未设置,那么直接返回false
return false;
}
if (ele == null || typeof ele == "undefined") {
return false;
}
var parentNode = ele;
var maxnumber = 100; //最大循环次数,避免死循环
while (maxnumber-- > 0) {
if (parentNode == null || typeof parentNode == "undefined") {
//没有父元素了
return false;
}
//判断Tag
//var tagName = parentNode.nodeName.toLowerCase(); //tag名字,小写
var nodename = translate.element.getNodeName(parentNode).toLowerCase(); //tag名字,小写
if (nodename.length > 0) {
//有nodename
if (nodename == "html" || nodename == "#document") {
//上层元素已经是顶级元素了,那肯定就不是了
return false;
}
if (translate.whole.tag.indexOf(nodename) > -1) {
//发现ignore.tag 当前是处于被忽略的 tag
return true;
}
}
//判断class name
if (parentNode.className != null) {
var classNames = parentNode.className;
if (classNames == null || typeof classNames != "string") {
continue;
}
//console.log('className:'+typeof(classNames));
//console.log(classNames);
classNames = classNames.trim().split(" ");
for (var c_index = 0; c_index < classNames.length; c_index++) {
if (
classNames[c_index] != null &&
classNames[c_index].trim().length > 0
) {
//有效的class name,进行判断
if (translate.whole.class.indexOf(classNames[c_index]) > -1) {
//发现ignore.class 当前是处于被忽略的 class
return true;
}
}
}
}
//判断id
if (parentNode.id != null && typeof parentNode.id != "undefined") {
//有效的class name,进行判断
if (translate.whole.id.indexOf(parentNode.id) > -1) {
//发现ignore.id 当前是处于被忽略的 id
return true;
}
}
//赋予判断的元素向上一级
parentNode = parentNode.parentElement;
}
return false;
},
},
language: {
/*
英语的变种语种,也就是在英语26个字母的基础上加了点别的特殊字母另成的一种语言,而这些语言是没法直接通过识别字符来判断出是哪种语种的
法语、意大利语、德语、葡萄牙语
*/
englishVarietys: ["french", "italian", "deutsch", "portuguese"],
//当前本地语种,本地语言,默认是简体中文。设置请使用 translate.language.setLocal(...)。不可直接使用,使用需用 getLocal()
local: "",
/*
* v3.12增加, 是否会翻译本地语种,默认是false,不会翻译。
* 比如当前设置的本地语种是简体中文, 但是网页中也有一段英文, 如果设置了translate.to 为中文,也就是要以中文显示 默认是false的情况下,整个页面是不会被任何翻译的,也就是有的那段英文也不会进行任何翻译,依旧是显示英文。
* 如果这里设置为 true, 则英文也会被翻译,只要不是中文的,都会被翻译为要显示的语种,也就是都会被翻译为中文。
*/
translateLocal: false,
/*
翻译语种范围
比如传入 ['chinese_simplified','chinese_traditional','english'] 则表示仅对网页中的简体中文、繁体中文、英文 进行翻译,而网页中出现的其他的像是法语、韩语则不会进行翻译
如果为空 [],则是翻译时,翻译网页中的所有语种
设置方式为: translate.language.translateLanguagesRange = ['chinese_simplified','chinese_traditional']
*/
translateLanguagesRange: [],
//传入语种。具体可传入哪些参考: http://api.translate.zvo.cn/doc/language.json.html
setLocal: (languageName) => {
//translate.setUseVersion2(); //Set to use v2.x version
translate.useVersion = "v2";
translate.language.local = languageName;
},
//获取当前本地语种,本地语言,默认是简体中文。设置请使用 translate.language.setLocal(...)
getLocal: () => {
//判断是否设置了本地语种,如果没设置,自动给其设置
if (
translate.language.local == null ||
translate.language.local.length < 1
) {
translate.language.autoRecognitionLocalLanguage();
}
return translate.language.local;
},
/*
获取当前语种。
比如当前设置的本地语种是简体中文,用户并未切换其他语种,那么这个方法将返回本地当前的语种,也就是等同于 translate.language.getLocal()
如果用户切换为英语进行浏览,那么这个方法将返回翻译的目标语种,也就是 english
*/
getCurrent: () => {
var to_storage = translate.storage.get("to");
if (
to_storage != null &&
typeof to_storage != "undefined" &&
to_storage.length > 0
) {
//之前有过使用,并且主动设置过目标语种
return to_storage;
}
return translate.language.getLocal();
},
//如果第一次用,默认以什么语种显示。
//比如本地当前语种是简体中文,这里设置为english,那么用户第一次使用时,会自动翻译为english进行显示。如果用户手动切换为其他语种比如韩语,那么就遵循用户手动切换的为主,显示韩语。
setDefaultTo: (languageName) => {
var to_storage = translate.storage.get("to");
if (
to_storage != null &&
typeof to_storage != "undefined" &&
to_storage.length > 0
) {
//之前有过使用,并且主动设置过目标语种,那么不进行处理
} else {
//没有设置过,进行处理
translate.storage.set("to", languageName);
translate.to = languageName;
}
},
/*
清除历史翻译语种的缓存
*/
clearCacheLanguage: () => {
if (typeof translate.language.setUrlParamControl_use != "undefined") {
if (translate.language.setUrlParamControl_use) {
console.log("使用提示:");
console.log(
"translate.language.setUrlParamControl(...) 的作用是 可以通过URL传一个语种,来指定当前页面以什么语种显示。 参考文档: http://translate.zvo.cn/4075.html",
);
console.log(
"translate.language.clearCacheLanguage() 是清除历史翻译语种缓存,也就是清除之前指定翻译为什么语种。 参考文档:http://translate.zvo.cn/4080.html",
);
console.log(
"如果你执行了 translate.language.setUrlParamControl(...) 那么是要根据url传参来切换语种的,但是后面又出现了 translate.language.clearCacheLanguage() 它会阻止 translate.language.setUrlParamControl(...) 它的设置,即使有url传递翻译为什么语言,也会因为 translate.language.clearCacheLanguage() 给清除掉,使URL传参的语种不起任何作用。",
);
}
}
translate.to = "";
translate.storage.set("to", "");
},
//根据URL传参控制以何种语种显示
//设置可以根据当前访问url的某个get参数来控制使用哪种语言显示。
//比如当前语种是简体中文,网页url是http://translate.zvo.cn/index.html ,那么可以通过在url后面增加 language 参数指定翻译语种,来使网页内容以英文形态显示 http://translate.zvo.cn/index.html?language=english
setUrlParamControl: (paramName) => {
translate.language.setUrlParamControl_use = true; //标记已执行了 translate.language.setUrlParamControl ,仅仅只是标记,无其他作用
if (typeof paramName == "undefined" || paramName.length < 1) {
paramName = "language";
}
var paramValue = translate.util.getUrlParam(paramName);
if (typeof paramValue == "undefined") {
return;
}
if (
paramValue == "" ||
paramValue == "null" ||
paramValue == "undefined"
) {
return;
}
translate.storage.set("to", paramValue);
translate.to = paramValue;
},
/*
获取翻译区域的原始文本,翻译前的文本。 这里会把空白符等过滤掉,只返回纯显示的文本
也就是获取 translate.setDocument(...) 定义的翻译区域中,翻译前,要参与翻译的文本。
其中像是 translate.ignore.tag 这种忽略翻译的标签,这里也不会获取的,这里只是获取实际要参与翻译的文本。
*/
getTranslateAreaText: () => {
//v3.16.1 优化,获取本地语种,针对开源中国只对 readme 部分进行翻译的场景,将针对设置的 translate.setDocument() 区域的元素的显示文本进行判定语种
var translateAreaText = ""; //翻译区域内当前的文本
/** 构建虚拟容器,将要翻译的区域放入虚拟容器,以便后续处理 **/
var virtualContainer = document.createElement("div"); // 创建虚拟容器,处理、判断也都是针对这个虚拟容器
if (
translate.documents != null &&
typeof translate.documents != "undefined" &&
translate.documents.length > 0
) {
// setDocuments 指定的
for (
var docs_index = 0;
docs_index < translate.documents.length;
docs_index++
) {
var doc = translate.documents[docs_index];
if (
typeof doc != "undefined" &&
doc != null &&
typeof doc.innerText != "undefined" &&
doc.innerText != null &&
doc.innerText.length > 0
) {
virtualContainer.appendChild(doc.cloneNode(true));
}
}
} else {
//未使用 setDocuments指定,那就是整个网页了
//return document.all; //翻译所有的 这是 v3.5.0之前的
//v3.5.0 之后采用 拿 html的最上层的demo,而不是 document.all 拿到可能几千个dom
if (typeof document.head != "undefined") {
virtualContainer.appendChild(document.head.cloneNode(true));
}
if (typeof document.body != "undefined") {
virtualContainer.appendChild(document.body.cloneNode(true));
}
}
//console.log(virtualContainer);
/** 对虚拟容器中的元素进行处理,移除忽略的 tag (这里暂时就只是移除忽略的tag, 其他忽略的后续再加) **/
// 遍历标签列表
//console.log('---- remove element');
for (var i = 0; i < translate.ignore.tag.length; i++) {
var tagName = translate.ignore.tag[i];
var elements = virtualContainer.querySelectorAll(tagName);
// 将 NodeList 转换为数组
var elementArray = Array.prototype.slice.call(elements);
// 遍历并移除每个匹配的元素
for (var j = 0; j < elementArray.length; j++) {
var element = elementArray[j];
if (element.parentNode) {
//console.log(element);
element.parentNode.removeChild(element);
}
}
}
//console.log('---- remove element end');
/*** 取过滤完后的文本字符 ***/
translateAreaText = virtualContainer.innerText;
if (
translateAreaText == null ||
typeof translateAreaText == "undefined" ||
translateAreaText.length < 1
) {
//未取到,默认赋予简体中文
translate.language.local = "chinese_simplified";
return;
}
// 移除所有空白字符(包括空格、制表符、换行符等)
translateAreaText = translateAreaText.replace(/\s/g, "");
//console.log('translateAreaText:\n'+translateAreaText);
return translateAreaText;
},
//自动识别当前页面是什么语种
autoRecognitionLocalLanguage: () => {
if (
translate.language.local != null &&
translate.language.local.length > 2
) {
//已设置过了,不需要再设置
return translate.language.local;
}
var translateAreaText = translate.language.getTranslateAreaText();
//默认赋予简体中文
translate.language.local = "chinese_simplified";
var recognition = translate.language.recognition(translateAreaText);
//console.log(recognition);
translate.language.local = recognition.languageName;
return translate.language.local;
/* v3.1优化
var langs = new Array(); //上一个字符的语种是什么,当前字符向上数第一个字符。格式如 ['language']='english', ['chatstr']='a', ['storage_language']='english' 这里面有3个参数,分别代表这个字符属于那个语种,其字符是什么、存入了哪种语种的队列。因为像是逗号,句号,一般是存入本身语种中,而不是存入特殊符号中。
for(var i=0; i -1){
newLangs.splice(index,1); //移除数组中的特殊字符
}
if(newLangs.length > 0){
//找到排序出现频率最多的
translate.language.local = newLangs[0];
}else{
//没有,默认赋予简体中文
translate.language.local = 'chinese_simplified';
}
*/
},
/*
* 获取当前字符是什么语种。返回值是一个语言标识,有 chinese_simplified简体中文、japanese日语、korean韩语、
* str : node.nodeValue 或 图片的 node.alt 等
* 如果语句长,会全句翻译,以保证翻译的准确性,提高可读性。
* 如果语句短,会自动将特殊字符、要翻译的目标语种给过滤掉,只取出具体的要翻译的目标语种文本
*
* 返回 存放不同语言的数组,格式如
* [
"english":[
{beforeText: '', afterText: '', text: 'emoambue hag'},
......
],
"japanese":[
{beforeText: ' ', afterText: ' ', text: 'ẽ '},
......
]
]
*
*/
get: (str) => {
//将str拆分为单个char进行判断
var langs = []; //当前字符串包含哪些语言的数组,其内如 english
var langStrs = []; //存放不同语言的文本,格式如 ['english'][0] = 'hello'
var upLangs = []; //上一个字符的语种是什么,当前字符向上数第一个字符。格式如 ['language']='english', ['chatstr']='a', ['storage_language']='english' 这里面有3个参数,分别代表这个字符属于那个语种,其字符是什么、存入了哪种语种的队列。因为像是逗号,句号,一般是存入本身语种中,而不是存入特殊符号中。
var upLangsTwo = []; //上二个字符的语种是什么 ,当前字符向上数第二个字符。 格式如 ['language']='english', ['chatstr']='a', ['storage_language']='english' 这里面有3个参数,分别代表这个字符属于那个语种,其字符是什么、存入了哪种语种的队列。因为像是逗号,句号,一般是存入本身语种中,而不是存入特殊符号中。
//var upLangs = ''; //上一个字符的语种是什么,格式如 english
for (var i = 0; i < str.length; i++) {
var charstr = str.charAt(i);
//console.log('charstr:'+charstr)
var lang = translate.language.getCharLanguage(charstr);
if (lang == "") {
//未获取到,未发现是什么语言
//continue;
lang = "unidentification";
}
var result = translate.language.analyse(
lang,
langStrs,
upLangs,
upLangsTwo,
charstr,
);
//console.log(result)
langStrs = result["langStrs"];
//记录上几个字符
if (typeof upLangs["language"] != "undefined") {
upLangsTwo["language"] = upLangs["language"];
upLangsTwo["charstr"] = upLangs["charstr"];
upLangsTwo["storage_language"] = upLangs["storage_language"];
}
//upLangs['language'] = lang;
upLangs["language"] = result["storage_language"];
upLangs["charstr"] = charstr;
upLangs["storage_language"] = result["storage_language"];
//console.log(result['storage_language'])
//console.log(upLangs['language']);
langs.push(lang);
}
//console.log(langStrs);
//console.log(langs);
//console.log(langStrs);
/*
//从数组中取出现频率最高的
var newLangs = translate.util.arrayFindMaxNumber(langs);
//移除当前翻译目标的语言。因为已经是目标预言了,不需要翻译了
var index = newLangs.indexOf(translate.to);
if(index > -1){
newLangs.splice(index,1); //移除
}
//移除特殊字符
var index = newLangs.indexOf('specialCharacter');
if(index > -1){
newLangs.splice(index,1); //移除数组中的特殊字符
}
if(newLangs.length > 0){
//还剩一个或多个,(如果是多个,那应该是这几个出现的频率一样,所以取频率最高的时返回了多个)
return newLangs[0];
}else{
//没找到,直接返回空字符串
return '';
}
*/
//去除特殊符号
//for(var i = 0; i {
/*
如果英语跟罗曼语族(法语意大利语等多个语言)一起出现,且当前 data.languageName 认定是英语(也就是英文字符占比最大),那么要判定一下:
如果 罗曼语族的字符数/英文的字符数 > 0.008 , 那么认为当前是罗曼语族的中的某个语种, 在对其判定出具体是罗曼语族中的哪个语种赋予最终结果。
*/
if (
typeof languagesSize["english"] != "undefined" &&
typeof languagesSize["romance"] != "undefined" &&
data.languageName == "english"
) {
if (languagesSize["romance"] / languagesSize["english"] > 0.008) {
//排定是罗曼语族了,那么判断一下到底是 法语、西班牙语、葡萄牙语、意大利语 中的哪一种呢
//先判定是否有设置本地语种是罗曼语族中其中的某一个
if (
typeof translate.language.local != "undefined" &&
translate.language.local.length > 1
) {
if (
translate.language.englishVarietys.indexOf(
translate.language.local,
) > -1
) {
//发现当前设置的是小语种,那么将当前识别的语种识别为 本地设置的这个小语种。
data.languageName = translate.language.local;
}
}
if (data.languageName == "english") {
//还是英语,那就是没有经过上面本地语种的判定,那进行罗曼语的具体语种识别
var romanceSentenceLanguage =
translate.language.romanceSentenceAnaly(str);
if (romanceSentenceLanguage.length == 0) {
console.log(
"语种识别异常,应该是 法语、西班牙语、葡萄牙语、意大利语 中的一种才是,除非是除了这四种语种之外的别的 罗曼语族 中的语种,当前已将 " +
str +
"识别为英语。 你可以联系我们求助 https://translate.zvo.cn/4030.html",
);
} else {
data.languageName = romanceSentenceLanguage;
}
}
}
}
/*
如果发现日语、简体中文或繁体中文 一起存在,且当前 data.languageName 认定是简体或繁体中文,那么要判定一下:
如果 日语的字符数/(简体中文+繁体中文)的字符数 > 0.1 , 那么认为当前是日语的
*/
if (
(typeof languagesSize["chinese_simplified"] != "undefined" ||
typeof languagesSize["chinese_traditional"] != "undefined") &&
typeof languagesSize["japanese"] != "undefined" &&
(data.languageName == "chinese_simplified" ||
data.languageName == "chinese_traditional")
) {
var size = 0;
if (typeof languagesSize["chinese_simplified"] != "undefined") {
size = size + languagesSize["chinese_simplified"];
}
if (typeof languagesSize["chinese_traditional"] != "undefined") {
size = size + languagesSize["chinese_traditional"];
}
if (languagesSize["japanese"] / size > 0.1) {
data.languageName = "japanese";
}
}
/* if(langkeys.length > 1 && langkeys.indexOf('japanese') > -1){
langsNumber['chinese_simplified'] = 0;
langsNumber['chinese_traditional'] = 0;
} */
/*
如果发现英语、简体中文或繁体中文 一起存在,且当前 data.languageName 认定是英语时,那么要判定一下:
如果 (简体中文+繁体中文)的字符数/英语 > 0.08 , 那么认为当前是简体中文(不认为是繁体中文,因为下面还有 简体中文跟繁体中文的判定)
*/
if (
(typeof languagesSize["chinese_simplified"] != "undefined" ||
typeof languagesSize["chinese_traditional"] != "undefined") &&
typeof languagesSize["english"] != "undefined" &&
data.languageName == "english"
) {
var size = 0;
if (typeof languagesSize["chinese_simplified"] != "undefined") {
size = size + languagesSize["chinese_simplified"];
}
if (typeof languagesSize["chinese_traditional"] != "undefined") {
size = size + languagesSize["chinese_traditional"];
}
if (size / languagesSize["english"] > 0.08) {
data.languageName = "chinese_simplified";
}
}
/*
如果简体中文跟繁体中文一起出现,且当前 data.languageName 认定是简体中文(也就是简体中文字符占比最大),那么要判定一下繁体中文:
如果 繁体中文的字符数/简体中文的字符数 > 0.08 , 那么认为当前是繁体中文的
*/
if (
typeof languagesSize["chinese_simplified"] != "undefined" &&
typeof languagesSize["chinese_traditional"] != "undefined" &&
data.languageName == "chinese_simplified"
) {
if (
languagesSize["chinese_traditional"] /
languagesSize["chinese_simplified"] >
0.03
) {
data.languageName = "chinese_traditional";
}
}
/* if(langkeys.indexOf('chinese_simplified') > -1 && langkeys.indexOf('chinese_traditional') > -1){
langsNumber['chinese_simplified'] = 0;
} */
return data;
},
/*
* 识别字符串是什么语种。它是 get() 的扩展,以代替get返回更多
* str : 要识别的字符串
*
* 返回 存放不同语言的数组,格式如
*
{
languageName: 'english',
languageArray:[
english:[
list[
{beforeText: ' ', afterText: ' ', text: 'hello word'},
{beforeText: ' ', afterText: ' ', text: 'who?'},
],
number:12
],
japanese:[
......
]
]
}
languageName 是当前字符串最终判定结果是什么语种。它的识别有以下特点:
1. 如果出现英语跟中文、罗曼语族、德语等混合的情况,也就是不纯粹英语的情况,那么会以其他语种为准,而不是识别为英语。不论英语字符出现的比例占多少。
2. 如果出现简体中文跟繁体中文混合的情况,那么识别为繁体中文。不论简体中文字符出现的比例占多少。
3. 如果出现简体中文、繁体中文、日语混合的情况,那么识别为日语。不论简体中文、繁体中文出现的比例占多少。 2025.4.19 增加
4. 除了以上两种规则外,如果出现了多个语种,那么会识别为出现字符数量最多的语种当做当前句子的语种。(注意是字符数,而不是语种的数组数)
languageArray 对传入字符串进行分析,识别出都有哪些语种,每个语种的字符是什么
*
*/
recognition: (str) => {
var langs = translate.language.get(str);
//var langkeys = Object.keys(langs);
//console.log(langkeys);
var langsNumber = []; //key 语言名, value 语言字符数
var langsNumberOriginal = []; //同上,只不过这个不会进行清空字符数
var allNumber = 0; //总字数
/** 进行字数统计相关 - start **/
for (var key in langs) {
if (!Object.hasOwn(langs, key)) {
continue;
}
if (typeof langs[key] != "object") {
continue;
}
var langStrLength = 0;
for (var ls = 0; ls < langs[key].length; ls++) {
langStrLength = langStrLength + langs[key][ls].text.length;
}
allNumber = allNumber + langStrLength;
langsNumber[key] = langStrLength;
langsNumberOriginal[key] = langStrLength;
}
/** 进行字数统计相关 - end **/
//从 langsNumber 中找出字数最多的来
var maxLang = ""; //字数最多的语种
var maxNumber = 0;
for (var lang in langsNumber) {
if (!Object.hasOwn(langsNumber, lang)) {
continue;
}
if (langsNumber[lang] > maxNumber) {
maxLang = lang;
maxNumber = langsNumber[lang];
}
}
//重新组合返回值的 languageArray
var languageArray = {};
for (var lang in langs) {
if (!Object.hasOwn(langs, lang)) {
continue;
}
languageArray[lang] = {};
languageArray[lang].number = langsNumberOriginal[lang];
languageArray[lang].list = langs[lang];
}
var result = {
languageName: maxLang,
languageArray: languageArray,
};
//最后进行一层简单的算法处理
return translate.language.recognitionAlgorithm(
str,
result,
langsNumber,
allNumber,
);
},
/*
传入一个char,返回这个char属于什么语种,返回如 如果返回空字符串,那么表示未获取到是什么语种
chinese_simplified 简体中文
chinese_traditional 繁体中文
russian 俄罗斯语
english 英语
romance 罗曼语族,它是 法语、西班牙语、意大利语、葡萄牙語 的集合,并不是单个语言
specialCharacter 特殊字符,符号
number 阿拉伯数字
japanese 日语
korean 韩语
greek 希腊语
thai 泰语
arabic 阿拉伯语
romanian 罗马尼亚语
hebrew 希伯来语
*/
getCharLanguage: function (charstr) {
if (charstr == null || typeof charstr == "undefined") {
return "";
}
if (this.russian(charstr)) {
return "russian";
}
if (this.english(charstr)) {
return "english";
}
if (this.romance(charstr)) {
return "romance";
}
if (this.specialCharacter(charstr)) {
return "specialCharacter";
}
if (this.number(charstr)) {
return "number";
}
//中文的判断包含两种,简体跟繁体
var chinesetype = this.chinese(charstr);
if (chinesetype == "simplified") {
return "chinese_simplified";
}
if (chinesetype == "traditional") {
return "chinese_traditional";
}
if (this.japanese(charstr)) {
return "japanese";
}
if (this.korean(charstr)) {
return "korean";
}
if (this.greek(charstr)) {
return "greek";
}
if (this.thai(charstr)) {
return "thai";
}
if (this.arabic(charstr)) {
return "arabic";
}
if (this.romanian(charstr)) {
return "romanian";
}
if (this.hebrew(charstr)) {
return "hebrew";
}
//未识别是什么语种
//console.log('not find is language , char : '+charstr+', unicode: '+charstr.charCodeAt(0).toString(16));
return "";
},
/*
* 对字符串进行分析,分析字符串是有哪几种语言组成。
* language : 当前字符的语种,传入如 english
* langStrs : 操作的,如 langStrs['english'][0] = '你好'
* upLangs : 当前字符之前的上一个字符的语种是什么,当前字符向上数第一个字符。格式如 ['language']='english', ['chatstr']='a', ['storage_language']='english' 这里面有3个参数,分别代表这个字符属于那个语种,其字符是什么、存入了哪种语种的队列。因为像是逗号,句号,一般是存入本身语种中,而不是存入特殊符号中。
* upLangsTwo : 当前字符之前的上二个字符的语种是什么 ,当前字符向上数第二个字符。 格式如 ['language']='english', ['chatstr']='a', ['storage_language']='english' 这里面有3个参数,分别代表这个字符属于那个语种,其字符是什么、存入了哪种语种的队列。因为像是逗号,句号,一般是存入本身语种中,而不是存入特殊符号中。
* chatstr : 当前字符,如 h
*/
analyse: (language, langStrs, upLangs, upLangsTwo, charstr) => {
if (typeof langStrs[language] == "undefined") {
langStrs[language] = [];
}
var index = 0; //当前要存入的数组下标
if (typeof upLangs["storage_language"] == "undefined") {
//第一次,那么还没存入值,index肯定为0
//console.log('第一次,那么还没存入值,index肯定为0')
//console.log(upLangs['language'])
} else {
//console.log('analyse, charstr : '+charstr+', upLangs :');
//console.log(upLangs);
//var isEqual = upLangs['storage_language'] == language; //上次跟当前字符是否都是同一个语种(这个字符跟这个字符前一个字符)
/*
英语每个单词之间都会有空格分割. 如果是英文的话,英文跟特殊字符还要单独判断一下,避免拆开,造成翻译不准,单个单词翻译的情况
所以如果上次的字符是英文或特殊符号,当前字符是特殊符号(逗号、句号、空格,然后直接笼统就吧特殊符号都算上吧),那么也将当次的特殊符号变为英文来进行适配
示例
hello word 的 "o w"
hello word 的 " w"
hello word 的 "w "
this is a dog 的 " a "
*/
//console.log(language == 'specialCharacter');
//如果两个字符类型不一致,但当前字符是英文或连接符时,进行判断
/*
if(!isEqual){
if(language == 'english' || translate.language.connector(charstr)){
console.log('1.'+(language == 'english' || translate.language.connector(charstr))+', upLangs str:'+upLangs['charstr']);
//上一个字符是英文或连接符
//console.log('teshu:'+translate.language.connector(upLangs['charstr'])+', str:'+upLangs['charstr']);
if(upLangs['language'] == 'english' || translate.language.connector(upLangs['charstr'])) {
console.log('2');
//如果上二个字符不存在,那么刚开始,不再上面几种情况之中,直接不用考虑
if(typeof(upLangsTwo['language']) != 'undefined'){
console.log('3')
//上二个字符是空(字符串刚开始),或者是英文
if(upLangsTwo['language'] == 'english' || translate.language.connector(upLangsTwo['charstr'])){
//满足这三个条件,那就将这三个拼接到一起
console.log('4/5: '+', two lang:'+upLangsTwo['language']+', str:'+upLangsTwo['charstr'])
isEqual = true;
if(language == 'specialCharacter' && upLangs['language'] == 'specialCharacter' && upLangsTwo['language'] == 'specialCharacter'){
//如果三个都是特殊字符,或后两个是特殊字符,第一个是空(刚开始),那就归入特殊字符
language = 'specialCharacter';
//console.log('4')
}else{
//不然就都归于英文中。
//这里更改是为了让下面能将特殊字符(像是空格逗号等)也一起存入数组
language = 'english';
console.log(5)
}
}
}
}
}
}
*/
/*
不判断当前字符,而判断上个字符,是因为当前字符没法获取未知的下个字符。
*/
//if(!isEqual){
//如果当前字符是连接符
if (translate.language.connector(charstr)) {
language = upLangs["storage_language"];
/*
//判断上个字符是否存入了待翻译字符,如要将中文翻译为英文,而上个字符是中文,待翻译,那将连接符一并加入待翻译字符中去,保持句子完整性
//判断依据是上个字符存储至的翻译字符语种序列,不是特殊字符,而且也不是要翻译的目标语种,那肯定就是待翻译的,将连接符加入待翻译中一起进行翻译
if(upLangs['storage_language'] != 'specialCharacter' && upLangs['storage_language'] != translate.to){
language = upLangs['storage_language'];
console.log('teshu:'+charstr+', 当前字符并入上个字符存储翻译语种:'+upLangs['storage_language']);
}
*/
}
//}
//console.log('isEqual:'+isEqual);
/*
if(isEqual){
//跟上次语言一样,那么直接拼接
index = langStrs[language].length-1;
//但是还有别的特殊情况,v2.1针对英文翻译准确度的适配,会有特殊字符的问题
if(typeof(upLangs['storage_language']) != 'undefined' && upLangs['storage_language'] != language){
//如果上个字符存入的翻译队列跟当前这个要存入的队列不一个的话,那应该是特殊字符像是逗号句号等导致的,那样还要额外一个数组,不能在存入之前的数组了
index = langStrs[language].length;
}
}else{
//console.log('新开');
//当前字符跟上次语言不样,那么新开一个数组
index = langStrs[language].length;
//console.log('++, inde:'+index+',lang:'+language+', length:'+langStrs[language].length)
}
*/
//当前要翻译的语种跟上个字符要翻译的语种一样,那么直接拼接
if (upLangs["storage_language"] == language) {
index = langStrs[language].length - 1;
} else {
//console.log('新开');
//当前字符跟上次语言不样,那么新开一个数组
index = langStrs[language].length;
}
}
if (typeof langStrs[language][index] == "undefined") {
langStrs[language][index] = [];
langStrs[language][index]["beforeText"] = "";
langStrs[language][index]["afterText"] = "";
langStrs[language][index]["text"] = "";
}
langStrs[language][index]["text"] =
langStrs[language][index]["text"] + charstr;
/*
中文英文混合时,当中文+英文并没有空格间隔,翻译为英文时,会使中文翻译英文的结果跟原本的英文单词连到一块。这里就是解决这种情况
针对当前非英文(不需要空格分隔符,像是中文、韩语),但要翻译为英文(需要空格作为分割符号,像是法语等)时的情况进行判断
*/
//if(translate.language.getLocal() != 'english' && translate.to == 'english'){
//当前本地语种的语言是连续的,但翻译的目标语言不是连续的(空格间隔)
if (
translate.language.wordBlankConnector(translate.language.getLocal()) ==
false &&
translate.language.wordBlankConnector(translate.to)
) {
if (
upLangs["storage_language"] != null &&
typeof upLangs["storage_language"] != "undefined" &&
upLangs["storage_language"].length > 0
) {
//上个字符存在
//console.log(upLangs['storage_language']);
if (upLangs["storage_language"] != "specialCharacter") {
//上个字符不是特殊字符 (是正常语种。且不会是连接符,连接符都并入了正常语种)
//if( upLangs['storage_language'] != 'english' && language == 'english'){
//上个字符的语言是连续的,但当前字符的语言不是连续的(空格间隔)
if (
translate.language.wordBlankConnector(
upLangs["storage_language"],
) == false &&
translate.language.wordBlankConnector(language)
) {
//上个字符不是英语,当前字符是英语,这种情况要在上个字符后面追加空格,因为当前字符是英文,就不会在执行翻译操作了
//console.log(upLangs['language']);
langStrs[upLangs["storage_language"]][
langStrs[upLangs["storage_language"]].length - 1
]["afterText"] = " ";
} else if (
upLangs["storage_language"] == "english" &&
language != "english"
) {
//上个字符是英语,当前字符不是英语,直接在当前字符前面追加空格
langStrs[language][index]["beforeText"] = " ";
}
}
}
}
var result = [];
result["langStrs"] = langStrs;
result["storage_language"] = language; //实际存入了哪种语种队列
//console.log(result);
//console.log(langStrs)
//console.log(charstr);
return result;
},
/*
* 不同于语言,这个只是单纯的连接符。比如英文单词之间有逗号、句号、空格, 汉字之间有逗号句号书名号的。避免一行完整的句子被分割,导致翻译不准确
* 单独拿他出来,目的是为了更好的判断计算,提高翻译的准确率
*/
connector: (str) => {
/*
通用的有 空格、阿拉伯数字
1.不间断空格\u00A0,主要用在office中,让一个单词在结尾处不会换行显示,快捷键ctrl+shift+space ;
2.半角空格(英文符号)\u0020,代码中常用的;
3.全角空格(中文符号)\u3000,中文文章中使用;
*/
if (/.*[\u0020\u00A0\u202F\u205F\u3000]+.*$/.test(str)) {
return true;
}
/*
U+0030 0 数字 0
U+0031 1 数字 1
U+0032 2 数字 2
U+0033 3 数字 3
U+0034 4 数字 4
U+0035 5 数字 5
U+0036 6 数字 6
U+0037 7 数字 7
U+0038 8 数字 8
U+0039 9 数字 9
*/
if (/.*[\u0030-\u0039]+.*$/.test(str)) {
return true;
}
/*
英文场景
英文逗号、句号
这里不包括() 因为这里面的基本属于补充,对语句前后并无强依赖关系
U+0021 ! 叹号
U+0022 " 双引号
U+0023 # 井号
U+0024 $ 价钱/货币符号
U+0025 % 百分比符号
U+0026 & 英文“and”的简写符号
U+0027 ' 引号
U+002C , 逗号
U+002D - 连字号/减号
U+002E . 句号
U+003A : 冒号
U+003B ; 分号
U+003F ? 问号
U+0040 @ 英文“at”的简写符号
*/
if (
/.*[\u0021\u0022\u0023\u0024\u0025\u0026\u0027\u002C\u002D\u002E\u003A\u003B\u003F\u0040]+.*$/.test(
str,
)
) {
return true;
}
/*
中文标点符号
名称 Unicode 符号
句号 3002 。
问号 FF1F ?
叹号 FF01 !
逗号 FF0C ,
顿号 3001 、
分号 FF1B ;
冒号 FF1A :
引号 300C 「
300D 」
引号 300E 『
300F 』
引号 2018 ‘
2019 ’
引号 201C “
201D ”
括号 FF08 (
FF09 )
括号 3014 〔
3015 〕
括号 3010 【
3011 】
破折号 2014 —
省略号 2026 …
连接号 2013 –
间隔号 FF0E .
书名号 300A 《
300B 》
书名号 3008 〈
3009 〉
键盘123前面的那个符号 · 00b7
*/
if (
/.*[\u3002\uFF1F\uFF01\uFF0C\u3001\uFF1B\uFF1A\u300C\u300D\u300E\u300F\u2018\u2019\u201C\u201D\uFF08\uFF09\u3014\u3015\u3010\u3011\u2014\u2026\u2013\uFF0E\u300A\u300B\u3008\u3009\u00b7]+.*$/.test(
str,
)
) {
return true;
}
//不是,返回false
return false;
},
//语种的单词连接符是否需要空格,比如中文简体、繁体、韩文、日语都不需要空格,则返回false, 但是像是英文的单词间需要空格进行隔开,则返回true
//另外这也是区分是否使用标点符号 ,。还是 ,. 的
//如果未匹配到,默认返回true
//language:语种,传入如 english
wordBlankConnector: (language) => {
if (language == null || typeof language == "undefined") {
return true;
}
switch (language.trim().toLowerCase()) {
case "chinese_simplified":
return false;
case "chinese_traditional":
return false;
case "korean":
return false;
case "japanese":
return false;
}
//其他情况则返回true
return true;
},
//繁体中文的字典,判断繁体中文就是通过此判断
chinese_traditional_dict:
"皚藹礙愛翺襖奧壩罷擺敗頒辦絆幫綁鎊謗剝飽寶報鮑輩貝鋇狽備憊繃筆畢斃閉邊編貶變辯辮鼈癟瀕濱賓擯餅撥缽鉑駁蔔補參蠶殘慚慘燦蒼艙倉滄廁側冊測層詫攙摻蟬饞讒纏鏟産闡顫場嘗長償腸廠暢鈔車徹塵陳襯撐稱懲誠騁癡遲馳恥齒熾沖蟲寵疇躊籌綢醜櫥廚鋤雛礎儲觸處傳瘡闖創錘純綽辭詞賜聰蔥囪從叢湊竄錯達帶貸擔單鄲撣膽憚誕彈當擋黨蕩檔搗島禱導盜燈鄧敵滌遞締點墊電澱釣調諜疊釘頂錠訂東動棟凍鬥犢獨讀賭鍍鍛斷緞兌隊對噸頓鈍奪鵝額訛惡餓兒爾餌貳發罰閥琺礬釩煩範販飯訪紡飛廢費紛墳奮憤糞豐楓鋒風瘋馮縫諷鳳膚輻撫輔賦複負訃婦縛該鈣蓋幹趕稈贛岡剛鋼綱崗臯鎬擱鴿閣鉻個給龔宮鞏貢鈎溝構購夠蠱顧剮關觀館慣貫廣規矽歸龜閨軌詭櫃貴劊輥滾鍋國過駭韓漢閡鶴賀橫轟鴻紅後壺護滬戶嘩華畫劃話懷壞歡環還緩換喚瘓煥渙黃謊揮輝毀賄穢會燴彙諱誨繪葷渾夥獲貨禍擊機積饑譏雞績緝極輯級擠幾薊劑濟計記際繼紀夾莢頰賈鉀價駕殲監堅箋間艱緘繭檢堿鹼揀撿簡儉減薦檻鑒踐賤見鍵艦劍餞漸濺澗漿蔣槳獎講醬膠澆驕嬌攪鉸矯僥腳餃繳絞轎較稭階節莖驚經頸靜鏡徑痙競淨糾廄舊駒舉據鋸懼劇鵑絹傑潔結誡屆緊錦僅謹進晉燼盡勁荊覺決訣絕鈞軍駿開凱顆殼課墾懇摳庫褲誇塊儈寬礦曠況虧巋窺饋潰擴闊蠟臘萊來賴藍欄攔籃闌蘭瀾讕攬覽懶纜爛濫撈勞澇樂鐳壘類淚籬離裏鯉禮麗厲勵礫曆瀝隸倆聯蓮連鐮憐漣簾斂臉鏈戀煉練糧涼兩輛諒療遼鐐獵臨鄰鱗凜賃齡鈴淩靈嶺領餾劉龍聾嚨籠壟攏隴樓婁摟簍蘆盧顱廬爐擄鹵虜魯賂祿錄陸驢呂鋁侶屢縷慮濾綠巒攣孿灤亂掄輪倫侖淪綸論蘿羅邏鑼籮騾駱絡媽瑪碼螞馬罵嗎買麥賣邁脈瞞饅蠻滿謾貓錨鉚貿麽黴沒鎂門悶們錳夢謎彌覓綿緬廟滅憫閩鳴銘謬謀畝鈉納難撓腦惱鬧餒膩攆撚釀鳥聶齧鑷鎳檸獰甯擰濘鈕紐膿濃農瘧諾歐鷗毆嘔漚盤龐國愛賠噴鵬騙飄頻貧蘋憑評潑頗撲鋪樸譜臍齊騎豈啓氣棄訖牽扡釺鉛遷簽謙錢鉗潛淺譴塹槍嗆牆薔強搶鍬橋喬僑翹竅竊欽親輕氫傾頃請慶瓊窮趨區軀驅齲顴權勸卻鵲讓饒擾繞熱韌認紉榮絨軟銳閏潤灑薩鰓賽傘喪騷掃澀殺紗篩曬閃陝贍繕傷賞燒紹賒攝懾設紳審嬸腎滲聲繩勝聖師獅濕詩屍時蝕實識駛勢釋飾視試壽獸樞輸書贖屬術樹豎數帥雙誰稅順說碩爍絲飼聳慫頌訟誦擻蘇訴肅雖綏歲孫損筍縮瑣鎖獺撻擡攤貪癱灘壇譚談歎湯燙濤縧騰謄銻題體屜條貼鐵廳聽烴銅統頭圖塗團頹蛻脫鴕馱駝橢窪襪彎灣頑萬網韋違圍爲濰維葦偉僞緯謂衛溫聞紋穩問甕撾蝸渦窩嗚鎢烏誣無蕪吳塢霧務誤錫犧襲習銑戲細蝦轄峽俠狹廈鍁鮮纖鹹賢銜閑顯險現獻縣餡羨憲線廂鑲鄉詳響項蕭銷曉嘯蠍協挾攜脅諧寫瀉謝鋅釁興洶鏽繡虛噓須許緒續軒懸選癬絢學勳詢尋馴訓訊遜壓鴉鴨啞亞訝閹煙鹽嚴顔閻豔厭硯彥諺驗鴦楊揚瘍陽癢養樣瑤搖堯遙窯謠藥爺頁業葉醫銥頤遺儀彜蟻藝億憶義詣議誼譯異繹蔭陰銀飲櫻嬰鷹應纓瑩螢營熒蠅穎喲擁傭癰踴詠湧優憂郵鈾猶遊誘輿魚漁娛與嶼語籲禦獄譽預馭鴛淵轅園員圓緣遠願約躍鑰嶽粵悅閱雲鄖勻隕運蘊醞暈韻雜災載攢暫贊贓髒鑿棗竈責擇則澤賊贈紮劄軋鍘閘詐齋債氈盞斬輾嶄棧戰綻張漲帳賬脹趙蟄轍鍺這貞針偵診鎮陣掙睜猙幀鄭證織職執紙摯擲幟質鍾終種腫衆謅軸皺晝驟豬諸誅燭矚囑貯鑄築駐專磚轉賺樁莊裝妝壯狀錐贅墜綴諄濁茲資漬蹤綜總縱鄒詛組鑽緻鐘麼為隻兇準啟闆裡靂餘鍊",
/*
中文判断
返回:
simplified:简体中文
traditional:繁体中文
空字符串:不是中文
*/
chinese: function (str) {
if (/.*[\u4e00-\u9fa5]+.*$/.test(str)) {
if (this.chinese_traditional_dict.indexOf(str) > -1) {
return "traditional";
}
return "simplified";
}
return "";
},
//是否包含日语,true:包含
japanese: (str) => {
if (/.*[\u3040-\u309F\u30A0-\u30FF]+.*$/.test(str)) {
return true;
}
return false;
},
//是否包含韩语,true:包含
korean: (str) => {
if (/.*[\uAC00-\uD7AF]+.*$/.test(str)) {
return true;
}
return false;
},
//是否包含俄语
russian: (str) => {
// 正则表达式匹配俄语大小写字母(包含 Ё/ё,排除其他语言特有的西里尔字符)
//АаБбВвГгДдЕеЁёЖжЗзИиЙйКкЛлМмНнОоПпРрСсТтУуФфХхЦцЧчШшЩщЪъЫыЬьЮюЯя
if (/^[А-Яа-яЁё]$/.test(str)) {
return true;
}
return false;
},
//是否包含泰语
thai: (str) => {
if (/^[\u0E01-\u0E59]$/.test(str)) {
return true;
}
return false;
},
//是否包含阿拉伯语
arabic: (str) => {
/*
阿拉伯语基本区块(U+0600–U+06FF)
阿拉伯语补充区块(U+0750–U+077F)
*/
return /^[\u0600-\u06FF\u0750-\u077F]$/.test(str);
},
//是否包含 罗马尼亚语
romanian: (str) => {
/*
U+00C0–U+00FF:Latin-1 Supplement (包含带变音符号的字母,如 Ă/ă 的部分形式)
U+0100–U+017F:Latin Extended-A (包含罗马尼亚语特有字母 Ă/ă、Â/â、Î/î 等);
U+0218–U+021B:Latin Extended-B (包含 Ș/ș 和 Ț/ț,这是罗马尼亚语标志性字母)
*/
return /^[\u00C0-\u00FF\u0100-\u017F\u0218-\u021B]$/.test(str);
},
//是否包含希腊语
greek: (str) => {
const greekRegex = /^[\u0391-\u03A9\u03B1-\u03C9]$/;
//判断字符有 БВДЖЗИЙЛМНОПСТУФХЦЧШЩЪЫЬЮЯЇІ
if (/^[\u0391-\u03A9\u03B1-\u03C9]$/.test(str)) {
return true;
}
return false;
},
//希伯来语
hebrew: (str) => /^[\u0590-\u05FF]$/.test(str),
//0-9 阿拉伯数字
number: (str) => {
if (/.*[\u0030-\u0039]+.*$/.test(str)) {
return true;
}
return false;
},
//是否包含英文,true:包含
english: (str) => {
if (/.*[\u0041-\u005a]+.*$/.test(str)) {
return true;
}
if (/.*[\u0061-\u007a]+.*$/.test(str)) {
return true;
}
return false;
},
//是否包含 罗曼语族 的特殊字符,因为 法语、西班牙语、意大利语、葡萄牙語 都属于这个语族,单纯判断特殊字符已经不能判断出到底属于哪个语种了
romance_dict: [
"é",
"è",
"ê",
"à",
"ç",
"œ",
"ñ",
"á",
"ó",
"ò",
"ì",
"ã",
"õ",
],
romance: function (str) {
if (this.romance_dict.indexOf(str) > -1) {
return true;
}
return false;
},
//对 罗曼语族 的句子进行分析,看它是属于 法语、西班牙语、意大利语、葡萄牙語 的哪个。注意这个是传入的整体的句子,不是传入的单个字符
//返回识别的语种: french、spanish、italian、portuguese 如果都没有识别出来,则返回空字符串
romanceSentenceAnaly: (text) => {
// 定义各语言的典型字母/符号权重 (可调整)
const langFeatures = {
french: { score: 0, chars: ["é", "è", "ê", "à", "ç", "œ"] },
spanish: { score: 0, chars: ["ñ", "á", "ó"], pairs: ["ll"] },
italian: { score: 0, chars: ["ò", "ì"], pairs: ["cc", "ss"] },
portuguese: { score: 0, chars: ["ã", "õ"] },
};
// 逐字扫描 + 相邻配对检测
for (let i = 0; i < text.length; i++) {
const char = text[i].toLowerCase();
// 单字匹配
Object.keys(langFeatures).forEach((lang) => {
if (langFeatures[lang].chars.includes(char)) {
langFeatures[lang].score += 1;
}
});
// 双字配对检测 (如 ll)
if (i < text.length - 1) {
const pair = text.slice(i, i + 2).toLowerCase();
Object.keys(langFeatures).forEach((lang) => {
const pairs = langFeatures[lang].pairs;
if (pairs && pairs.includes(pair)) {
langFeatures[lang].score += 2; // pair权重大于单字
}
});
}
}
// 结果判定 (取最高分)
let maxLang = "";
let maxScore = -1;
Object.keys(langFeatures).forEach((lang) => {
if (langFeatures[lang].score > maxScore) {
maxScore = langFeatures[lang].score;
maxLang = lang;
}
});
return maxLang || "";
},
/**romanceSentenceAnaly end**/
//是否包含特殊字符,包含,则是true
specialCharacter: (str) => {
//如:① ⑴ ⒈
if (/.*[\u2460-\u24E9]+.*$/.test(str)) {
return true;
}
//如:┊┌┍ ▃ ▄ ▅
if (/.*[\u2500-\u25FF]+.*$/.test(str)) {
return true;
}
//如:㈠ ㎎ ㎏ ㎡
if (/.*[\u3200-\u33FF]+.*$/.test(str)) {
return true;
}
//如:与ANSI对应的全角字符
if (/.*[\uFF00-\uFF5E]+.*$/.test(str)) {
return true;
}
//其它特殊符号
if (/.*[\u2000-\u22FF]+.*$/.test(str)) {
return true;
}
// 、><等符号
if (/.*[\u3001-\u3036]+.*$/.test(str)) {
return true;
}
/*
U+0020 空格
U+0021 ! 叹号
U+0022 " 双引号
U+0023 # 井号
U+0024 $ 价钱/货币符号
U+0025 % 百分比符号
U+0026 & 英文“and”的简写符号
U+0027 ' 引号
U+0028 ( 开 左圆括号
U+0029 ) 关 右圆括号
U+002A * 星号
U+002B + 加号
U+002C , 逗号
U+002D - 连字号/减号
U+002E . 句号
U+002F / 左斜杠
*/
if (/.*[\u0020-\u002F]+.*$/.test(str)) {
return true;
}
/*
U+003A : 冒号
U+003B ; 分号
U+003C < 小于符号
U+003D = 等于号
U+003E > 大于符号
U+003F ? 问号
U+005B [ 开 方括号
U+005C \ 右斜杠
U+005D ] 关 方括号
U+005E ^ 抑扬(重音)符号
U+005F _ 底线
U+0060 ` 重音符
U+007B { 开 左花括号
U+007C | 直线
U+007D } 关 右花括号
U+007E ~ 波浪纹
*/
if (
/.*[\u003B\u003B\u003C\u003D\u003E\u003F\u005B\u005C\u005D\u005E\u005F\u0060\u007B\u007C\u007D\u007E]+.*$/.test(
str,
)
) {
return true;
}
//空白字符,\u0009\u000a + https://cloud.tencent.com/developer/article/2128593
if (
/.*[\u0009\u000a\u0020\u00A0\u1680\u180E\u202F\u205F\u3000\uFEFF]+.*$/.test(
str,
)
) {
return true;
}
if (/.*[\u2000-\u200B]+.*$/.test(str)) {
return true;
}
/*
这些字符主要是 罕见的拉丁字母变体 ,通常用于:
某些非洲语言或方言;
古文字、语音学符号;
特殊排版或装饰性字体。
*/
if (/.*[\u2C60-\u2C77]+.*$/.test(str)) {
return true;
}
return false;
},
/*
文本翻译的替换。
@Deprecated 2025.4.26 最新的在 translate.util.textReplace
text: 原始文本,翻译的某句或者某个词就在这个文本之中
translateOriginal: 翻译的某个词或句,在翻译之前的文本
translateResult: 翻译的某个词或句,在翻译之后的文本,翻译结果
language: 显示的语种,这里是对应的 translateResult 这个文本的语种。 也就是最终替换之后要显示给用户的语种。比如将中文翻译为英文,这里也就是英文。 这里会根据显示的语种不同,来自主决定是否前后加空格进行分割。 另外这里传入的语种也是 translate.js 的语种标识
(注意,如果 translateResult 中发现 translateOriginal 的存在,将不进行任何处理,因为没必要了,还会造成死循环。直接将 text 返回)
使用此方法:
var text = '你世好word世界';
var translateOriginal = '世';
var translateResult = '世杰'; //翻译结果
translate.language.textTranslateReplace(text, translateOriginal, translateResult, 'english');
*/
textTranslateReplace: (
text,
translateOriginal,
translateResult,
language,
) =>
translate.util.textReplace(
text,
translateOriginal,
translateResult,
language,
),
},
//用户第一次打开网页时,自动判断当前用户所在国家使用的是哪种语言,来自动进行切换为用户所在国家的语种。
//如果使用后,第二次在用,那就优先以用户所选择的为主
executeByLocalLanguage: () => {
//先读用户自己浏览器的默认语言
var browserDefaultLanguage = translate.util.browserDefaultLanguage();
if (
typeof browserDefaultLanguage != "undefined" &&
browserDefaultLanguage.length > 0
) {
translate.changeLanguage(browserDefaultLanguage);
return;
}
if (
typeof translate.request.api.ip != "string" ||
translate.request.api.ip == null ||
translate.request.api.ip.length < 1
) {
return;
}
//如果用户浏览器没读到默认语言,或者默认语言没有对应到translate.js支持的语种,那么在采用ip识别的方式
translate.request.post(
translate.request.api.ip,
{},
(data) => {
//console.log(data);
if (data.result == 0) {
console.log("==== ERROR 获取当前用户所在区域异常 ====");
console.log(data.info);
console.log("==== ERROR END ====");
} else {
translate.storage.set("to", data.language); //设置目标翻译语言
translate.to = data.language; //设置目标语言
translate.selectLanguageTag;
translate.execute(); //执行翻译
}
},
null,
);
},
util: {
/*
文本替换,将替换完毕的结果返回
自定义术语等都是通过这个来进行替换
2025.4.26 从 language 中 拿到这里
text: 原始文本,翻译的某句或者某个词就在这个文本之中
translateOriginal: 翻译的某个词或句,在翻译之前的文本
translateResult: 翻译的某个词或句,在翻译之后的文本,翻译结果
language: 显示的语种,这里是对应的 translateResult 这个文本的语种。 也就是最终替换之后要显示给用户的语种。比如将中文翻译为英文,这里也就是英文。 这里会根据显示的语种不同,来自主决定是否前后加空格进行分割。 另外这里传入的语种也是 translate.js 的语种标识
(注意,如果 translateResult 中发现 translateOriginal 的存在,将不进行任何处理,因为没必要了,还会造成死循环。直接将 text 返回)
使用此方法:
var text = '你世好word世界';
var translateOriginal = '世';
var translateResult = '世杰'; //翻译结果
translate.util.textReplace(text, translateOriginal, translateResult, 'english');
*/
textReplace: (text, translateOriginal, translateResult, language) => {
//如果要替换的源文本直接就是整个文本,那也就不用在做什么判断了,直接将 翻译的结果文本返回就好了
if (text == translateOriginal) {
return translateResult;
}
//当前替换后,替换结果结束位置的下标。
//一开始还没进行替换,那么这个下标就是 0
//比如 你好吗 中的 好 替换为 "好的" 那最后结果为 "你好的吗" ,这里是 “的” 的下标 2
let currentReplaceEndIndex = 0;
//while最大循环次数30次,免得出现未知异常导致死循环
let maxWhileNumber = 30;
//因为text中可能有多个位置要被替换,所以使用循环
while (
text.indexOf(translateOriginal, currentReplaceEndIndex) > -1 &&
maxWhileNumber-- > 0
) {
//console.log('text:'+text+'\tcurrentReplaceEndIndex:'+currentReplaceEndIndex);
//要替换的结果文本(这个文本可能前面有加空格或者后面有加空格的)
let replaceResultText = "" + translateResult;
//替换的文本 ,这里有可能会追加上某些标点符号,所以单独也列出来,而不是使用方法中传入的 translateOriginal
let replaceOriginalText = "" + translateOriginal;
//根据不同的语种,如果有的语种需要加空格来进行区分单词,那么也要进行空格的判定
if (translate.language.wordBlankConnector(language)) {
const originalIndex = text.indexOf(
translateOriginal,
currentReplaceEndIndex,
); //翻译之前,翻译的单词在字符串中的起始坐标(0开始)
//console.log("originalIndex: "+originalIndex);
//要先判断后面,不然先判断前面,加了后它的长度就又变了
//判断它后面是否还有文本
if (originalIndex + 1 < text.length) {
const char = text.charAt(originalIndex + translateOriginal.length);
//console.log(char);
if (/。/.test(char)) {
replaceResultText = replaceResultText + ". ";
replaceOriginalText = translateOriginal + "。";
} else if (/,/.test(char)) {
replaceResultText = replaceResultText + ", ";
replaceOriginalText = translateOriginal + ",";
} else if (/:/.test(char)) {
replaceResultText = replaceResultText + ": ";
replaceOriginalText = translateOriginal + ":";
} else if (
[" ", "\n", "\t", "]", "|", "_", "-", "/"].indexOf(char) !== -1
) {
// 如果后面的字符是 这些字符,那么不用添加空格隔开
} else {
//补充上一个空格,用于将两个单词隔开。 不过 ,如果当前 replaceResultText 的最后一个字符也是空格,那就不需要再加空格了。 这里就只判断空格就好了,至于其他的换行等基本不会出现这个情况,所以不考虑
if (
replaceResultText.length > 0 &&
replaceResultText.charAt(replaceResultText.length - 1) == " "
) {
//replaceResultText 本身有值,且最后一个字符就是空格,就不需要再追加空格进行隔开了
} else {
replaceResultText = replaceResultText + " ";
}
}
}
//判断它前面是否还有文本
if (originalIndex > 0) {
const char = text.charAt(originalIndex - 1);
//console.log(char);
if (/。/.test(char)) {
replaceResultText = ". " + replaceResultText;
replaceOriginalText = "。" + replaceOriginalText;
} else if (/,/.test(char)) {
replaceResultText = ", " + replaceResultText;
replaceOriginalText = "," + replaceOriginalText;
} else if (/:/.test(char)) {
replaceResultText = ": " + replaceResultText;
replaceOriginalText = ":" + replaceOriginalText;
} else if (
[" ", "\n", "\t", "[", "|", "_", "-", "/"].indexOf(char) !== -1
) {
// 如果前面的字符是 这些字符,那么不用添加空格隔开
//console.log('不需要空格隔开的');
} else {
//补充上一个空格,用于将两个单词隔开。 不过 ,如果当前 replaceResultText 的第一个字符也是空格,那就不需要再加空格了。 这里就只判断空格就好了,至于其他的换行等基本不会出现这个情况,所以不考虑
if (
replaceResultText.length > 0 &&
replaceResultText.charAt(0) == " "
) {
//replaceResultText 本身有值,且最后一个字符就是空格,就不需要再追加空格进行隔开了
} else {
replaceResultText = " " + replaceResultText;
}
//console.log('before add space : '+replaceResultText);
}
}
} else {
//如果是其他语种比如英语法语翻译为中文、日文,那么标点符号也要判断的,这个因为目前这个场景还没咋遇到,就不判断了,遇到了在加。
}
//console.log(replaceResultText)
//console.log(replaceResultText.length)
const replaceResult = translate.util.replaceFromIndex(
text,
currentReplaceEndIndex,
replaceOriginalText,
replaceResultText,
);
if (replaceResult.replaceEndIndex < 1) {
console.log(
"while中已经 indexOf发现了,但是实际没有替换,出现异常了!理论上这是不应该出现的。 text:" +
text +
" , translateOriginal:" +
translateOriginal,
);
} else {
currentReplaceEndIndex = replaceResult.replaceEndIndex;
text = replaceResult.text;
}
}
//console.log(resultText);
return text;
},
/*
js 的 replace 能力,这个是可以指定从第几个字符开始进行replace
1. 这里可以 replaceText 本身包含着 originalText
2. originalText 可以出现多次
@param
text 要进行替换的原始文本
index 要从 text 的哪个下标开始。 (第一个字符下标是0)
originalText 要替换的文本,被替换的文本
replaceText 替换为的文本,将 originalText 替换为什么
replaceFromIndex('你好吗?你也好?', 0, '你', '你是谁');
@return 对象
text 替换的结果
replaceEndIndex 当前替换后,替换结果结束位置的下标。
如果没进行替换,那么这个下标就是 0
比如 你好吗 中的 好 替换为 "好的" 那最后结果为 "你好的吗" ,这里是 “的” 的下标 2
*/
replaceFromIndex: (text, index, originalText, replaceText) => {
const before = text.slice(0, index);
const after = text.slice(index);
const originalTextIndex = after.indexOf(originalText);
if (originalTextIndex > -1) {
const replacedAfter = after.replace(originalText, replaceText);
return {
text: before + replacedAfter,
replaceEndIndex: index + originalTextIndex + replaceText.length,
};
}
//没有发现可替换的字符,那么就原样返回
return {
text: before + replacedAfter,
replaceEndIndex: 0,
};
},
/* 生成一个随机UUID,复制于 https://gitee.com/mail_osc/kefu.js */
uuid: () => {
var d = new Date().getTime();
if (window.performance && typeof window.performance.now === "function") {
d += performance.now(); //use high-precision timer if available
}
var uuid = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx".replace(/[xy]/g, (c) => {
var r = ((d + Math.random() * 16) % 16) | 0;
d = Math.floor(d / 16);
return (c == "x" ? r : (r & 0x3) | 0x8).toString(16);
});
return uuid;
},
//判断字符串中是否存在tag标签。 true存在
findTag: (str) => {
var reg = /<[^>]+>/g;
return reg.test(str);
},
//传入一个数组,从数组中找出现频率最多的一个返回。 如果多个频率出现的次数一样,那会返回多个
arrayFindMaxNumber: (arr) => {
// 储存每个元素出现的次数
var numbers = {};
// 储存出现最多次的元素
var maxStr = [];
// 储存最多出现的元素次数
var maxNum = 0;
for (var i = 0, len = arr.length; i < len; i++) {
if (!numbers[arr[i]]) {
numbers[arr[i]] = 1;
} else {
numbers[arr[i]]++;
}
if (numbers[arr[i]] > maxNum) {
maxNum = numbers[arr[i]];
}
}
for (var item in numbers) {
if (!Object.hasOwn(numbers, item)) {
continue;
}
if (numbers[item] === maxNum) {
maxStr.push(item);
}
}
return maxStr;
},
//对字符串进行hash化,目的取唯一值进行标识
hash: (str) => {
if (str == null || typeof str == "undefined") {
return str;
}
var hash = 0,
i,
chr;
if (str.length === 0) {
return hash;
}
for (i = 0; i < str.length; i++) {
chr = str.charCodeAt(i);
hash = (hash << 5) - hash + chr;
hash |= 0; // Convert to 32bit integer
}
return hash + "";
},
//去除一些指定字符,如换行符。 如果传入的是null,则返回空字符串
charReplace: (str) => {
if (str == null) {
return "";
}
str = str.trim();
str = str.replace(/\t|\n|\v|\r|\f/g, ""); //去除换行符等
//str = str.replace(/&/g, "%26"); //因为在提交时已经进行了url编码了
return str;
},
//RegExp相关
regExp: {
// new RegExp(pattern, resultText); 中的 pattern 字符串的预处理
pattern: (str) => {
str = str.replace(/\\/g, "\\\\"); //这个一定要放在第一个,不然会被下面的影响
//str = str.replace(/'/g,'\\\'');
str = str.replace(/"/g, '\\\"');
//str = str.replace(/./g,'\\\.');
str = str.replace(/\?/g, "\\\?");
str = str.replace(/\$/g, "\\\$");
str = str.replace(/\(/g, "\\\(");
str = str.replace(/\)/g, "\\\)");
str = str.replace(/\|/g, "\\\|");
str = str.replace(/\+/g, "\\\+");
str = str.replace(/\*/g, "\\\*");
str = str.replace(/\[/g, "\\\[");
str = str.replace(/\]/g, "\\\]");
str = str.replace(/\^/g, "\\\^");
str = str.replace(/\{/g, "\\\{");
str = str.replace(/\}/g, "\\\}");
return str;
},
// new RegExp(pattern, resultText); 中的 resultText 字符串的预处理
resultText: (str) => {
//str = str.replace(/"/g,"\"");
//str = str.replace(/'/g,"\\\'");
//str = str.replace(/"/g,"\\\"");
return str;
},
},
//获取URL的GET参数。若没有,返回""
getUrlParam: (name) => {
var reg = new RegExp("(^|&)" + name + "=([^&]*)(&|$)");
var r = window.location.search.substr(1).match(reg);
if (r != null) return unescape(r[2]);
return "";
},
/**
* 同步加载JS,加载过程中会阻塞,加载完毕后继续执行后面的。
* url: 要加载的js的url
*/
synchronizesLoadJs: (url) => {
var xmlHttp = null;
if (window.ActiveXObject) {
//IE
try {
//IE6以及以后版本中可以使用
xmlHttp = new ActiveXObject("Msxml2.XMLHTTP");
} catch (e) {
//IE5.5以及以后版本可以使用
xmlHttp = new ActiveXObject("Microsoft.XMLHTTP");
}
} else if (window.XMLHttpRequest) {
//Firefox,Opera 8.0+,Safari,Chrome
xmlHttp = new XMLHttpRequest();
}
//采用同步加载
xmlHttp.open("GET", url, false);
//发送同步请求,如果浏览器为Chrome或Opera,必须发布后才能运行,不然会报错
xmlHttp.send(null);
//4代表数据发送完毕
if (xmlHttp.readyState == 4) {
//0为访问的本地,200到300代表访问服务器成功,304代表没做修改访问的是缓存
if (
(xmlHttp.status >= 200 && xmlHttp.status < 300) ||
xmlHttp.status == 0 ||
xmlHttp.status == 304
) {
var myBody = document.getElementsByTagName("HTML")[0];
var myScript = document.createElement("script");
myScript.language = "javascript";
myScript.type = "text/javascript";
try {
//IE8以及以下不支持这种方式,需要通过text属性来设置
myScript.appendChild(document.createTextNode(xmlHttp.responseText));
} catch (ex) {
myScript.text = xmlHttp.responseText;
}
myBody.appendChild(myScript);
return true;
}
return false;
}
return false;
},
/*js translate.util.loadMsgJs start*/
//加载 msg.js
loadMsgJs: () => {
if (typeof msg != "undefined") {
return;
}
translate.util.synchronizesLoadJs("https://res.zvo.cn/msg/msg.js");
},
/*js translate.util.loadMsgJs end*/
/*
对一个对象,按照对象的key的长度进行排序,越长越在前面
*/
objSort: (obj) => {
// 获取对象数组的所有 key,并转换为普通数组
var keys = Array.from(Object.keys(obj));
//var keys = [].slice.call(Object.keys(obj)); //适配es5
// 对 key 数组进行排序
keys.sort((a, b) => b.length - a.length);
// 定义一个新的对象数组,用来存储排序后的结果
var sortedObj = [];
// 遍历排序后的 key 数组,将对应的值复制到新的对象数组中,并删除原来的对象数组中的键值对
for (var key of keys) {
sortedObj[key] = obj[key];
}
return sortedObj;
},
/*
将 2.11.3.20231232 转化为 2011003
转化时会去掉最后一个日期的字符
*/
versionStringToInt: (versionString) => {
var vs = versionString.split("\.");
var result = 0;
result = Number.parseInt(vs[0]) * 1000 * 1000 + result;
result = Number.parseInt(vs[1]) * 1000 + result;
result = Number.parseInt(vs[2]) + result;
return result;
},
/**
* 将一个 JSONArray 数组,按照文字长度进行拆分。
* 比如传入的 array 数组的文字长度是6200,传入的 stringLength 是2000,那么就是将 array 数组拆分为多个长度不超出2000的数组返回。
* 如果传入了 maxSize = 5 那么会对拆分后的数组的长度进行判断,如果数组内元素超过5,那么还要进行缩短,拆分后的数组不允许超过这个数
* 也就是拆分后的数组有两重限制,一是限制转化为文本形式的长度、再就是拆分后本身数组的大小。
*
* 注意,这个长度是指 array.toString() 后的长度,也就是包含了 [""] 这种符号的长度
* @param array 要被拆分的数组,其内都是String类型,传入格式如 ["你好","世界"]
* @param stringLength 要被拆分的数组转化为字符串之后的长度
* @param maxSize 被拆分的数组最大包含多少个,数组大小最大允许多大,要小于等于这个数。 如果设置为0则是不启用这个,不对拆分后的数组进行判断。
* @return 被拆分后的数组列表
* @author 刘晓腾
*/
split: (array, size, maxSize) => {
const orgsize = size;
let list = [];
// 数组长度小于size,直接进行返回
if (JSON.stringify(array).length <= size) {
list.push(array);
} else {
// 转换成String
const arrayStr = JSON.stringify(array)
.trim()
.substring(1, JSON.stringify(array).length - 1);
// 判断size和字符串长度的差值,如果为1或者2,就直接拆成两段
if (JSON.stringify(array).length - size <= 2) {
size = size - 4;
// 拆两段
const str1 = arrayStr.substring(0, arrayStr.lastIndexOf('","') + 1);
const str2 = arrayStr.substring(arrayStr.lastIndexOf('","') + 2);
list.push(JSON.parse("[" + str1 + "]"));
list.push(JSON.parse("[" + str2 + "]"));
} else {
size = size - 2;
// 拆多段
let index = 0;
while (index - arrayStr.length < 0) {
// 按照指定大小拆一段
let s = "";
if (index + size - arrayStr.length >= 0) {
s = arrayStr.substring(index);
} else {
s = arrayStr.substring(index, index + size);
}
// 结尾长度默认为字符串长度
let endIndex = s.length;
// 因为下次开始的第一个字符可能会是逗号,所以下次开始需要+1
let startNeedAdd = 1;
// 判断最后一个字符是否为双引号
if (s.endsWith('"')) {
// 判断倒数第二个是否为逗号
if (s.endsWith('","')) {
// 删除两个字符
endIndex -= 2;
} else if (!s.startsWith('"')) {
// 如果开头不是引号,需要补一个引号,这就导致会超长,所以结尾就要找指定字符的
// 找出最后一个指定字符的位置
const la = s.lastIndexOf('","');
endIndex = la + 1;
}
} else if (s.endsWith('",')) {
// 判断是否为逗号,是的话删除一个字符
endIndex -= 1;
} else {
// 都不是,那就是内容结尾
// 找出最后一个指定字符的位置
const la = s.lastIndexOf('","');
endIndex = la + 1;
// 内容超长,endIndex就会变成0,这时需要手动赋值
if (endIndex <= 0) {
// 看看是否以引号开头,如果不是,需要拼两个引号
if (s.startsWith('"')) {
// 拼一个引号,-1
endIndex = s.length - 1;
} else {
// 拼两个引号,-2
endIndex = s.length - 2;
}
if (!s.endsWith('"')) {
// 开始不是逗号了,不能-1
startNeedAdd = 0;
}
}
}
// 根据处理的结尾长度进行第二次拆分
let s2 = "";
if (endIndex - s.length > 0 || endIndex - 0 == 0) {
s2 = s;
endIndex = endIndex + s2.length;
} else {
s2 = s.substring(0, endIndex);
}
if (!s2.startsWith('"') && !s2.startsWith(',"')) {
// 拼一个引号
s2 = '"' + s2;
}
if (!s2.endsWith('"')) {
// 拼一个引号
s2 = s2 + '"';
}
// 计算下次循环开始的长度
index += endIndex + startNeedAdd;
// 加到list
s2 = "[" + s2 + "]";
try {
list.push(JSON.parse(s2));
} catch (e) {
// 遇到错误,略过一个字符
index = index - (endIndex + startNeedAdd) + 1;
}
}
}
}
// 设置了maxSize,进行处理
if (maxSize && maxSize > 0) {
list = translate.util._splitMaxSize(list, orgsize, maxSize);
}
return list;
},
/**
* 针对split函数中maxSize的处理
* private
* @param array 已拆分的二维数组
* @param size 拆分的长度
* @param maxSize 元素数量
* @author 刘晓腾
*/
_splitMaxSize: (array, size, maxSize) => {
// console.log("------ splitMaxSize run ------")
// 返回的数据
let list = [];
// 暂存的数组,用来存储每次遍历时超出的数据
let tmp = [];
// 遍历二维数组
array.forEach((arr, index) => {
// 累加数组
arr = tmp.concat(arr);
// 计算元素数量
const length = arr.length;
// 数组中元素数量大于maxSize,对多余的元素进行移除
if (length > maxSize) {
// 第一个数组,包含前N个元素
let firstArray = arr.slice(0, maxSize);
// 第二个数组,包含剩下的元素
let secondArray = arr.slice(maxSize);
// 处理长度
let len = 1;
while (JSON.stringify(firstArray).length > size) {
// 长度超过限制,进行处理
firstArray = arr.slice(0, maxSize - len);
secondArray = arr.slice(maxSize - len);
len++;
if (len >= arr.length + 1) {
break;
}
}
// 第一个数组记录
list.push(firstArray);
// 第二个数组暂存
tmp.length = 0;
tmp = secondArray;
} else {
// 没超,只处理长度
// 处理长度
let firstArray = arr;
let secondArray = [];
let len = 1;
while (JSON.stringify(firstArray).length > size) {
// 长度超过限制,进行处理
firstArray = arr.slice(0, maxSize - len);
secondArray = arr.slice(maxSize - len);
len++;
if (len >= arr.length + 1) {
break;
}
}
// 第一个数组记录
list.push(firstArray);
// 第二个数组暂存
tmp.length = 0;
tmp = secondArray;
}
});
// 临时数组中还有元素,也要进行处理
if (tmp.length > 0) {
const tmpl = [];
tmpl.push(tmp);
// 递归处理
const l = translate.util._splitMaxSize(tmpl, size, maxSize);
list = list.concat(l);
}
return list;
},
/*
浏览器的语种标识跟translate.js的语种标识的对应
key: 浏览器的语种标识
value: translate.js 的语种标识
*/
browserLanguage: {
zh: "chinese_simplified",
"zh-CN": "chinese_simplified",
"zh-TW": "chinese_traditional",
"zh-HK": "chinese_traditional",
co: "corsican",
gn: "guarani",
rw: "kinyarwanda",
ha: "hausa",
no: "norwegian",
nl: "dutch",
yo: "yoruba",
en: "english",
"en-US": "english",
kok: "gongen",
la: "latin",
ne: "nepali",
fr: "french",
cs: "czech",
haw: "hawaiian",
ka: "georgian",
ru: "russian",
fa: "persian",
bho: "bhojpuri",
hi: "hindi",
be: "belarusian",
sw: "swahili",
is: "icelandic",
yi: "yiddish",
tw: "twi",
ga: "irish",
gu: "gujarati",
km: "khmer",
sk: "slovak",
he: "hebrew",
kn: "kannada",
hu: "hungarian",
ta: "tamil",
ar: "arabic",
bn: "bengali",
az: "azerbaijani",
sm: "samoan",
af: "afrikaans",
id: "indonesian",
da: "danish",
sn: "shona",
bm: "bambara",
lt: "lithuanian",
vi: "vietnamese",
mt: "maltese",
tk: "turkmen",
as: "assamese",
ca: "catalan",
si: "singapore",
ceb: "cebuano",
gd: "scottish-gaelic",
sa: "sanskrit",
pl: "polish",
gl: "galician",
lv: "latvian",
uk: "ukrainian",
tt: "tatar",
cy: "welsh",
ja: "japanese",
fil: "filipino",
ay: "aymara",
lo: "lao",
te: "telugu",
ro: "romanian",
ht: "haitian_creole",
doi: "dogrid",
sv: "swedish",
mai: "maithili",
th: "thai",
hy: "armenian",
my: "burmese",
ps: "pashto",
hmn: "hmong",
dv: "dhivehi",
lb: "luxembourgish",
sd: "sindhi",
ku: "kurdish",
tr: "turkish",
mk: "macedonian",
bg: "bulgarian",
ms: "malay",
lg: "luganda",
mr: "marathi",
et: "estonian",
ml: "malayalam",
de: "deutsch",
sl: "slovene",
ur: "urdu",
pt: "portuguese",
ig: "igbo",
ckb: "kurdish_sorani",
om: "oromo",
el: "greek",
es: "spanish",
fy: "frisian",
so: "somali",
am: "amharic",
ny: "nyanja",
pa: "punjabi",
eu: "basque",
it: "italian",
sq: "albanian",
ko: "korean",
tg: "tajik",
fi: "finnish",
ky: "kyrgyz",
ee: "ewe",
hr: "croatian",
kri: "creole",
qu: "quechua",
bs: "bosnian",
mi: "maori",
},
/*
获取浏览器中设置的默认使用语言
返回的是 translate.js 的语言唯一标识
如果返回的是空字符串,则是没有匹配到(可能是没有获取到本地语言,也可能是本地语言跟translate.js 翻译通道没有对应上)
*/
browserDefaultLanguage: () => {
var language = navigator.language || navigator.userLanguage;
if (typeof language == "string" && language.length > 0) {
var tLang = translate.util.browserLanguage[language];
if (typeof tLang == "undefined") {
//没有在里面
console.log(
"browser default language : " +
language +
", translate.js current translate channel not support this language ",
);
} else {
return tLang;
}
}
//将其转化为 translate.js 的语言id,比如简体中文是 chinese_simplified 、 英语是 english
return "";
},
/*
对输入的文本 text 进行判断,判断它里面是否有url存在。如果有url存在,对其进行截取,将url跟非url进行截取处理。
比如传入 “这个示例:https://www.ungm.org/Public/Notice/261001,其他得示例是 http://api.translate.zvo.cn 我呢”
那么返回的截取结果为:
{
"https://www.ungm.org/Public/Notice/261001":"1",
"http://api.translate.zvo.cn":"1",
",其他得示例是 ":"0",
"这个示例:":"0"
" 我呢":"0"
}
其中的key 为截取的文本,value 的值是1或0, 1代表当前key的文本是网址,0则不是网址
*/
urlSplitByText: (text) => {
// 匹配 http/https 的 URL 正则表达式(包含常见 URL 符号,排除中文等非 ASCII 字符)
const urlRegex =
/(https?:\/\/[\w\-._~:/?#[\]@!$&'()*+;=%]+(?=[\s\u4e00-\u9fa5,。;,!?]|$))/gi;
// 使用正则表达式分割文本,保留URL
const parts = text.split(urlRegex);
// 结果对象
const result = {};
// 添加非URL部分,并标记为 0
for (let i = 0; i < parts.length; i++) {
if (i % 2 === 0) {
// 非URL部分
if (parts[i] !== "") {
result[parts[i]] = "0";
}
} else {
// URL部分
result[parts[i]] = "1";
}
}
return result;
},
/*js translate.util.getElementPosition start*/
/*
计算一个元素在浏览器中的坐标系,其绝对定位、以及实际显示出来所占用的区域,宽、高
*/
getElementPosition: (node) => {
// 获取元素的边界矩形信息(相对于视口)
const rect = node.getBoundingClientRect();
// 获取当前页面的滚动位置(兼容不同浏览器)
const scrollX = window.scrollX || document.documentElement.scrollLeft;
const scrollY = window.scrollY || document.documentElement.scrollTop;
// 计算元素在文档中的起始坐标
const startX = rect.left + scrollX;
const startY = rect.top + scrollY;
// 计算元素的宽度和高度
const width = rect.right - rect.left;
const height = rect.bottom - rect.top;
// 计算元素在文档中的结束坐标
const endX = startX + width;
const endY = startY + height;
// 返回包含所有信息的对象(使用ES5兼容语法)
return {
startX: startX,
startY: startY,
endX: endX,
endY: endY,
width: width,
height: height,
};
},
/*js translate.util.getElementPosition end*/
},
//机器翻译采用哪种翻译服务
service: {
/*
name填写的值,参考 translate.service.use 的注释
*/
name: "translate.service",
/*js translate.service.use start*/
/*
其实就是设置 translate.service.name
可以设置为:
translate.service 自行部署的translate.service 翻译API服务,部署参考: https://translate.zvo.cn/391129.html
client.edge 使用无服务器的翻译,有edge浏览器接口提供翻译服务
siliconflow 使用指点云提供的服务器、硅基流动提供的AI算力进行大模型翻译
giteeAI 使用 giteeAI , 亚洲、美洲、欧洲 网络节点覆盖
*/
use: (serviceName) => {
if (
typeof translate.enterprise != "undefined" &&
translate.enterprise.isUse == true
) {
console.log(
"您已启用了企业级翻译通道 translate.enterprise.use(); (文档:https://translate.zvo.cn/4087.html) , 所以您设置的 translate.service.use('" +
serviceName +
"'); (文档:https://translate.zvo.cn/4081.html) 将失效不起作用,有企业级翻译通道全部接管。",
);
return;
}
//console.log('--'+serviceName);
if (typeof serviceName == "string") {
translate.service.name = serviceName;
if (serviceName != "translate.service") {
//增加元素整体翻译能力
translate.whole.enableAll();
if (serviceName.toLowerCase() == "giteeai") {
//设定翻译接口为GiteeAI的
translate.request.api.host = [
"https://giteeai.zvo.cn/",
"https://deutsch.enterprise.api.translate.zvo.cn:1000/",
"https://api.translate.zvo.cn:1000/",
];
return;
}
if (serviceName.toLowerCase() == "siliconflow") {
//设定翻译接口为硅基流动的
translate.request.api.host = [
"https://siliconflow.zvo.cn/",
"https://america.api.translate.zvo.cn:1414/",
"https://deutsch.enterprise.api.translate.zvo.cn:1414/",
];
return;
}
}
}
},
/*js translate.service.use end*/
/*js translate.service.edge start*/
//客户端方式的edge提供机器翻译服务
edge: {
api: {
//edge浏览器的翻译功能
auth: "https://edge.microsoft.com/translate/auth", //auth授权拉取
translate:
"https://api.cognitive.microsofttranslator.com/translate?from={from}&to={to}&api-version=3.0&includeSentenceLength=true", //翻译接口
},
language: {
json: [
{ id: "ukrainian", name: "Україна", serviceId: "uk" },
{ id: "norwegian", name: "Norge", serviceId: "no" },
{ id: "welsh", name: "Iaith Weleg", serviceId: "cy" },
{ id: "dutch", name: "nederlands", serviceId: "nl" },
{ id: "japanese", name: "日本語", serviceId: "ja" },
{ id: "filipino", name: "Pilipino", serviceId: "fil" },
{ id: "english", name: "English", serviceId: "en" },
{ id: "lao", name: "ກະຣຸນາ", serviceId: "lo" },
{ id: "telugu", name: "తెలుగుName", serviceId: "te" },
{ id: "romanian", name: "Română", serviceId: "ro" },
{ id: "nepali", name: "नेपालीName", serviceId: "ne" },
{ id: "french", name: "Français", serviceId: "fr" },
{ id: "haitian_creole", name: "Kreyòl ayisyen", serviceId: "ht" },
{ id: "czech", name: "český", serviceId: "cs" },
{ id: "swedish", name: "Svenska", serviceId: "sv" },
{ id: "russian", name: "Русский язык", serviceId: "ru" },
{ id: "malagasy", name: "Malagasy", serviceId: "mg" },
{ id: "burmese", name: "ဗာရမ်", serviceId: "my" },
{ id: "pashto", name: "پښتوName", serviceId: "ps" },
{ id: "thai", name: "คนไทย", serviceId: "th" },
{ id: "armenian", name: "Արմենյան", serviceId: "hy" },
{ id: "chinese_simplified", name: "简体中文", serviceId: "zh-CHS" },
{ id: "persian", name: "Persian", serviceId: "fa" },
{ id: "chinese_traditional", name: "繁體中文", serviceId: "zh-CHT" },
{ id: "kurdish", name: "Kurdî", serviceId: "ku" },
{ id: "turkish", name: "Türkçe", serviceId: "tr" },
{ id: "hindi", name: "हिन्दी", serviceId: "hi" },
{ id: "bulgarian", name: "български", serviceId: "bg" },
{ id: "malay", name: "Malay", serviceId: "ms" },
{ id: "swahili", name: "Kiswahili", serviceId: "sw" },
{ id: "oriya", name: "ଓଡିଆ", serviceId: "or" },
{ id: "icelandic", name: "ÍslandName", serviceId: "is" },
{ id: "irish", name: "Íris", serviceId: "ga" },
{ id: "khmer", name: "ភាសាខ្មែរName", serviceId: "km" },
{ id: "gujarati", name: "ગુજરાતી", serviceId: "gu" },
{ id: "slovak", name: "Slovenská", serviceId: "sk" },
{ id: "kannada", name: "ಕನ್ನಡ್Name", serviceId: "kn" },
{ id: "hebrew", name: "היברית", serviceId: "he" },
{ id: "hungarian", name: "magyar", serviceId: "hu" },
{ id: "marathi", name: "मराठीName", serviceId: "mr" },
{ id: "tamil", name: "தாமில்", serviceId: "ta" },
{ id: "estonian", name: "eesti keel", serviceId: "et" },
{ id: "malayalam", name: "മലമാലം", serviceId: "ml" },
{ id: "inuktitut", name: "ᐃᓄᒃᑎᑐᑦ", serviceId: "iu" },
{ id: "arabic", name: "بالعربية", serviceId: "ar" },
{ id: "deutsch", name: "Deutsch", serviceId: "de" },
{ id: "slovene", name: "slovenščina", serviceId: "sl" },
{ id: "bengali", name: "বেঙ্গালী", serviceId: "bn" },
{ id: "urdu", name: "اوردو", serviceId: "ur" },
{ id: "azerbaijani", name: "azerbaijani", serviceId: "az" },
{ id: "portuguese", name: "português", serviceId: "pt" },
{ id: "samoan", name: "lifiava", serviceId: "sm" },
{ id: "afrikaans", name: "afrikaans", serviceId: "af" },
{ id: "tongan", name: "汤加语", serviceId: "to" },
{ id: "greek", name: "ελληνικά", serviceId: "el" },
{ id: "indonesian", name: "IndonesiaName", serviceId: "id" },
{ id: "spanish", name: "Español", serviceId: "es" },
{ id: "danish", name: "dansk", serviceId: "da" },
{ id: "amharic", name: "amharic", serviceId: "am" },
{ id: "punjabi", name: "ਪੰਜਾਬੀName", serviceId: "pa" },
{ id: "albanian", name: "albanian", serviceId: "sq" },
{ id: "lithuanian", name: "Lietuva", serviceId: "lt" },
{ id: "italian", name: "italiano", serviceId: "it" },
{ id: "vietnamese", name: "Tiếng Việt", serviceId: "vi" },
{ id: "korean", name: "한국어", serviceId: "ko" },
{ id: "maltese", name: "Malti", serviceId: "mt" },
{ id: "finnish", name: "suomi", serviceId: "fi" },
{ id: "catalan", name: "català", serviceId: "ca" },
{ id: "croatian", name: "hrvatski", serviceId: "hr" },
{ id: "bosnian", name: "bosnian", serviceId: "bs-Latn" },
{ id: "polish", name: "Polski", serviceId: "pl" },
{ id: "latvian", name: "latviešu", serviceId: "lv" },
{ id: "maori", name: "Maori", serviceId: "mi" },
],
/*
获取map形式的语言列表
key为 translate.service 的 name
value为serviceId
*/
getMap: () => {
if (typeof translate.service.edge.language.map == "undefined") {
translate.service.edge.language.map = [];
for (
var i = 0;
i < translate.service.edge.language.json.length;
i++
) {
var item = translate.service.edge.language.json[i];
translate.service.edge.language.map[item.id] = item.serviceId;
}
}
return translate.service.edge.language.map;
},
},
/**
* edge 进行翻译。 这个传入参数跟 translate.request.post 是一样的
* @param path 请求的path(path,传入的是translate.request.api.translate 这种的,需要使用 getUrl 来组合真正请求的url )
* @param data 请求的参数数据
* @param func 请求完成的回调,传入如 function(data){ console.log(data); }
*/
translate: (path, data, func, abnormalFunc) => {
var textArray = JSON.parse(decodeURIComponent(data.text));
const translateTextArray = translate.util.split(textArray, 40000, 900);
translate.request.send(
translate.service.edge.api.auth,
{},
{},
(auth) => {
var appendXhrData = {
from: data.from + "",
to: data.to,
text: data.text,
};
var from = data.from;
if (from != "auto") {
if (from == "romance") {
//这里额外加了一个罗曼语族(romance)会自动认为是法语(fr)
from = "fr";
} else {
from = translate.service.edge.language.getMap()[data.from];
}
}
var to = translate.service.edge.language.getMap()[data.to];
var transUrl = translate.service.edge.api.translate
.replace("{from}", from)
.replace("{to}", to);
//如果翻译量大,要拆分成多次翻译请求
for (var tai = 0; tai < translateTextArray.length; tai++) {
var json = [];
for (var i = 0; i < translateTextArray[tai].length; i++) {
json.push({ Text: translateTextArray[tai][i] });
}
translate.request.send(
transUrl,
JSON.stringify(json),
appendXhrData,
(result) => {
var d = {};
d.info = "SUCCESS";
d.result = 1;
d.from = data.from;
d.to = data.to;
d.text = [];
for (var t = 0; t < result.length; t++) {
d.text.push(result[t].translations[0].text);
}
//判断当前翻译是否又被拆分过,比如一次超过5万字符的话就要拆分成多次请求了
if (translateTextArray.length > 1) {
//这一次翻译呗拆分了多次请求,那么要进行补全数组,使数组个数能一致
/*
注意这里根据数组的长度来判断当前属于第几个数组,
有几率会是拆分的数组,其中有两组的长度是一样的,
这样的话是有问题的,只不过几率很小,就先这样了
但终归还是留了个坑 -- 记录
*/
var currentIndex = -1; //当前翻译请求属于被拆分的第几个的数组下标,从0开始的
for (var cri = 0; cri < translateTextArray.length; cri++) {
if (translateTextArray[cri].length - d.text.length == 0) {
currentIndex = cri;
break;
}
}
//进行对前后进行补齐数组
if (currentIndex < 0) {
console.log("------ERROR--------");
console.log(
"翻译内容过多,进行拆分,但拆分判断出现异常,currentIndex:-1 请联系 http://translate.zvo.cn/43006.html 说明",
);
}
//前插入空数组填充
for (
var addbeforei = 0;
addbeforei < currentIndex;
addbeforei++
) {
var beforeItemArrayLength =
translateTextArray[addbeforei].length;
//console.log('beforeItemArrayLength:'+beforeItemArrayLength);
for (var bi = 0; bi < beforeItemArrayLength; bi++) {
d.text.unshift(null);
}
}
//后插入空数组填充
for (
var addafteri = translateTextArray.length - 1;
addafteri > currentIndex;
addafteri--
) {
var afterItemArrayLength =
translateTextArray[addafteri].length;
for (var bi = 0; bi < afterItemArrayLength; bi++) {
d.text.push(null);
}
}
}
func(d);
},
"post",
true,
{
Authorization: "Bearer " + auth,
"Content-Type": "application/json",
},
abnormalFunc,
true,
);
}
//console.log('translateResultArray')
//console.log(translateResultArray);
},
"get",
true,
{ "content-type": "application/x-www-form-urlencoded" },
(xhr) => {
console.log("---------error--------");
console.log(
"edge translate service error, http code : " +
xhr.status +
", response text : " +
xhr.responseText,
);
},
true,
);
},
},
/*js translate.service.edge end*/
},
//request请求来源于 https://github.com/xnx3/request
request: {
//相关API接口方面
api: {
/**
* 翻译接口请求的域名主机 host
* 格式注意前面要带上协议如 https:// 域名后要加 /
* v2.8.2 增加数组形态,如 ['https://api.translate.zvo.cn/','xxxxx']
*/
//host:'https://api.translate.zvo.cn/',
host: [
"https://api.translate.zvo.cn/",
"https://america.api.translate.zvo.cn/",
],
//host的备用接口,格式同host,可以填写多个,只不过这里是数组格式。只有当主 host 无法连通时,才会采用备host来提供访问。如果为空也就是 [] 则是不采用备方案。
//backupHost:['',''],
language: "language.json", //获取支持的语种列表接口
translate: "translate.json", //翻译接口
ip: "ip.json", //根据用户当前ip获取其所在地的语种
connectTest: "connectTest.json", //用于 translate.js 多节点翻译自动检测网络连通情况
init: "init.json", //获取最新版本号,跟当前版本进行比对,用于提醒版本升级等使用
},
/*
追加参数, v3.15.9.20250527 增加
所有通过 translate.request.send 进行网络请求的,都会追加上这个参数
默认是空,没有任何追加参数。
设置方式: https://translate.zvo.cn/471711.html
translate.request.appendParams = {
key1:'key1',
key2:'key2'
}
*/
appendParams: {},
/*
追加header头的参数, v3.15.13 增加
所有通过 translate.request.send 进行网络请求的,都会追加上这个参数
默认是空,没有任何追加参数。
设置方式: https://translate.zvo.cn/471711.html
translate.request.appendHeaders = {
key1:'key1',
Aauthorization:'Bearer xxxxxxxxxx'
}
*/
appendHeaders: {},
/*
请求后端接口的响应。无论是否成功,都会触发此处。
另外当 xhr.readyState==4 的状态时才会触发。
此处会在接口请求响应后、且在translate.js处理前就会触发
@param xhr XMLHttpRequest 接口请求
*/
response: (xhr) => {
//console.log('response------');
//console.log(xhr);
},
/*
速度检测控制中心, 检测主备翻译接口的响应速度进行排列,真正请求时,按照排列的顺序进行请求
v2.8.2增加
storage存储方面
storage存储的key 存的什么
speedDetectionControl_hostQueue hostQueue
speedDetectionControl_hostQueueIndex 当前要使用的是 hostQueue 中的数组下标。如果没有,这里默认视为0
speedDetectionControl_lasttime 最后一次执行速度检测的时间戳,13位时间戳
*/
speedDetectionControl: {
/*
进行 connect主节点缩减的时间,单位是毫秒.
这个是进行 translate.request.speedDetectionControl.checkResponseSpeed() 节点测速时,translate.request.api.host 第一个元素是默认的主节点。
主节点在实际测速完后,会减去一定的时间,以便让用户大部分时间可以使用主节点,而不必走分节点。
例如主节点实际响应速度 3500 毫秒,那么会减去这里设置的2000毫秒,记为 1500 毫秒
当然如果是小于这里设置的2000毫秒,那么会记为0毫秒。
这样再跟其他分节点的响应时间进行对比,主节点只要不是响应超时,就会有更大的几率被选中为实际使用的翻译的节点
这里的单位是毫秒。
v2.10.2.20231225 增加
*/
hostMasterNodeCutTime: 2000,
/*
翻译的队列,这是根据网络相应的速度排列的,0下标为请求最快,1次之...
其格式为:
[
{
"host":"xxxxxxxx",
"time":123 //这里的单位是毫秒
},
{
"host":"xxxxxxxx",
"time":123 //这里的单位是毫秒
}
]
*/
hostQueue: [],
hostQueueIndex: -1, //当前使用的 hostQueue的数组下标, -1表示还未初始化赋予值,不可直接使用,通过 getHostQueueIndex() 使用
disableTime: 1000000, //不可用的时间,storage中存储的 speedDetectionControl_hostQueue 其中 time 这里,如果值是 这个,便是代表这个host处于不可用状态
/*
设置当前使用的翻译通道 host
适用于 进行中时,中途切临时换翻译通道。
*/
setCurrentHost: (host) => {
translate.storage.set("speedDetectionControl_hostQueue", "");
translate.request.api.host = host;
translate.request.speedDetectionControl.checkHostQueue = [];
translate.request.speedDetectionControl.checkResponseSpeed_Storage(
host,
0,
);
},
//获取 host queue 队列
getHostQueue: () => {
if (translate.request.speedDetectionControl.hostQueue.length == 0) {
//还没有,先从本地存储中取,看之前是否已经设置过了
// 只有经过真正的网络测速后,才会加入 storage 的 hostQueue
var storage_hostQueue = translate.storage.get(
"speedDetectionControl_hostQueue",
);
if (
storage_hostQueue == null ||
typeof storage_hostQueue == "undefined" ||
storage_hostQueue == ""
) {
//本地存储中没有,也就是之前没设置过,是第一次用,那么直接讲 translate.request.api.host 赋予之
//translate.request.api.host
if (typeof translate.request.api.host == "string") {
//单个,那么赋予数组形式
//translate.request.speedDetectionControl.hostQueue = [{"host":translate.request.api.host, time:0 }];
translate.request.api.host = ["" + translate.request.api.host];
}
//数组形态,多个,v2.8.2 增加多个,根据优先级返回
translate.request.speedDetectionControl.hostQueue = [];
for (var i = 0; i < translate.request.api.host.length; i++) {
var h = translate.request.api.host[i];
//console.log(h);
translate.request.speedDetectionControl.hostQueue[i] = {
host: h,
time: 0,
};
}
//console.log(translate.request.speedDetectionControl.hostQueue);
} else {
//storage中有,那么赋予
translate.request.speedDetectionControl.hostQueue =
JSON.parse(storage_hostQueue);
//console.log(storage_hostQueue);
//console.log(translate.request.speedDetectionControl.hostQueue[0].time);
}
//console.log(translate.request.speedDetectionControl.hostQueue)
/*
当页面第一次打开初始化这个时才会进行测速,另外测速也是要判断时间的,五分钟一次
进行测速
*/
var lasttime = translate.storage.get(
"speedDetectionControl_lasttime",
);
if (lasttime == null || typeof lasttime == "undefined") {
lasttime = 0;
}
var updateTime = 60000; //1分钟检测一次
if (new Date().getTime() - lasttime > updateTime) {
translate.request.speedDetectionControl.checkResponseSpeed();
}
}
return translate.request.speedDetectionControl.hostQueue;
},
/*
服务于 checkResponseSpeed 用于将测试结果存入 storage
time: 当前接口请求的耗时,单位是毫秒。如果是 1000000 那么表示这个接口不可用
*/
checkResponseSpeed_Storage: (host, time) => {
translate.request.speedDetectionControl.checkHostQueue.push({
host: host,
time: time,
});
//按照time进行排序
translate.request.speedDetectionControl.checkHostQueue.sort(
(a, b) => a.time - b.time,
);
//存储到 storage 持久化
translate.storage.set(
"speedDetectionControl_hostQueue",
JSON.stringify(
translate.request.speedDetectionControl.checkHostQueue,
),
);
translate.storage.set(
"speedDetectionControl_lasttime",
new Date().getTime(),
);
translate.request.speedDetectionControl.hostQueue =
translate.request.speedDetectionControl.checkHostQueue;
},
//测试响应速度
checkResponseSpeed: () => {
var headers = {
"content-type": "application/x-www-form-urlencoded",
};
if (
typeof translate.request.api.connectTest != "string" ||
translate.request.api.connectTest == null ||
translate.request.api.connectTest.length < 1
) {
return;
}
translate.request.speedDetectionControl.checkHostQueue = []; //用于实际存储
translate.request.speedDetectionControl.checkHostQueueMap = []; //只是map,通过key取值,无其他作用
if (typeof translate.request.api.host == "string") {
//单个,那么赋予数组形式
translate.request.api.host = ["" + translate.request.api.host];
}
for (var i = 0; i < translate.request.api.host.length; i++) {
var host = translate.request.api.host[i];
// 获取当前时间的时间戳
translate.request.speedDetectionControl.checkHostQueueMap[host] = {
start: new Date().getTime(),
};
try {
translate.request.send(
host + translate.request.api.connectTest,
{ host: host },
{ host: host },
(data) => {
var host = data.info;
var map =
translate.request.speedDetectionControl.checkHostQueueMap[
host
];
var time = new Date().getTime() - map.start;
if (translate.request.api.host[0] == host) {
//console.log('如果是第一个,那么是主的,默认允许缩减2000毫秒,也就是优先使用主的');
time =
time -
translate.request.speedDetectionControl
.hostMasterNodeCutTime;
if (time < 0) {
time = 0;
}
}
translate.request.speedDetectionControl.checkResponseSpeed_Storage(
host,
time,
);
/*
translate.request.speedDetectionControl.checkHostQueue.push({"host":host, "time":time });
//按照time进行排序
translate.request.speedDetectionControl.checkHostQueue.sort((a, b) => a.time - b.time);
//存储到 storage 持久化
translate.storage.set('speedDetectionControl_hostQueue',JSON.stringify(translate.request.speedDetectionControl.checkHostQueue));
translate.storage.set('speedDetectionControl_lasttime', new Date().getTime());
translate.request.speedDetectionControl.hostQueue = translate.request.speedDetectionControl.checkHostQueue;
//console.log(translate.request.speedDetectionControl.hostQueue);
*/
},
"post",
true,
headers,
(data) => {
//translate.request.speedDetectionControl.checkResponseSpeed_Storage(host, time);
var hostUrl = data.requestURL.replace(
translate.request.api.connectTest,
"",
);
translate.request.speedDetectionControl.checkResponseSpeed_Storage(
hostUrl,
translate.request.speedDetectionControl.disableTime,
);
},
false,
);
} catch (e) {
//console.log('e0000');
console.log(e);
//time = 300000; //无法连接的,那么赋予 300 秒吧
}
}
},
//获取当前使用的host的数组下标
getHostQueueIndex: () => {
if (translate.request.speedDetectionControl.hostQueueIndex < 0) {
//页面当前第一次使用,赋予值
//先从 storage 中取
var storage_index = translate.storage.get(
"speedDetectionControl_hostQueueIndex",
);
if (typeof storage_index == "undefined" || storage_index == null) {
//存储中不存在,当前用户(浏览器)第一次使用,默认赋予0
translate.request.speedDetectionControl.hostQueueIndex = 0;
translate.storage.set("speedDetectionControl_hostQueueIndex", 0);
} else {
translate.request.speedDetectionControl.hostQueueIndex =
storage_index;
}
}
return translate.request.speedDetectionControl.hostQueueIndex;
},
//获取当前要使用的host
getHost: () => {
var queue = translate.request.speedDetectionControl.getHostQueue();
//console.log(queue);
var queueIndex =
translate.request.speedDetectionControl.getHostQueueIndex();
if (queue.length > queueIndex) {
//正常,没有超出越界
} else {
//异常,下标越界了!,固定返回最后一个
console.log("异常,下标越界了!index:" + queueIndex);
queueIndex = queue.length - 1;
}
//console.log(queueIndex);
return queue[queueIndex].host;
},
},
//生成post请求的url
getUrl: (path) => {
var currentHost = translate.request.speedDetectionControl.getHost();
var url = currentHost + path + "?v=" + translate.version;
//console.log('url: '+url);
return url;
},
/**
* post请求
* @param path 请求的path(path,传入的是translate.request.api.translate 这种的,需要使用 getUrl 来组合真正请求的url )
* @param data 请求的参数数据,传入如
* {
* from: "chinese_simplified",
* text: "%5B%22%E4%BD%A0%E5%A5%BD%EF%BC%8C%E6%88%91",
* to: "chinese_traditional
* }
*
* @param func 请求完成的回调,传入如 function(data){ console.log(data); }
* @param abnormalFunc 响应异常所执行的方法,响应码不是200就会执行这个方法 ,传入如 function(xhr){} 另外这里的 xhr 会额外有个参数 xhr.requestURL 返回当前请求失败的url
*/
post: function (path, data, func, abnormalFunc) {
var headers = {
"content-type": "application/x-www-form-urlencoded",
};
if (typeof data == "undefined") {
return;
}
//企业级翻译自动检测
if (typeof translate.enterprise != "undefined") {
translate.enterprise.automaticAdaptationService();
}
// ------- edge start --------
var url = translate.request.getUrl(path);
//if(url.indexOf('edge') > -1 && path == translate.request.api.translate){
if (translate.service.name == "client.edge") {
if (path == translate.request.api.translate) {
translate.service.edge.translate(path, data, func, abnormalFunc);
return;
}
if (path == translate.request.api.language) {
var d = {};
d.info = "SUCCESS";
d.result = 1;
d.list = translate.service.edge.language.json;
func(d);
return;
}
//return;
}
// ------- edge end --------
this.send(
path,
data,
data,
func,
"post",
true,
headers,
abnormalFunc,
true,
);
},
/**
* 发送请求
* url 请求的url或者path(path,传入的是translate.request.api.translate 这种的,需要使用 getUrl 来组合真正请求的url )
* data 请求的数据,如 {"author":"管雷鸣",'site':'www.guanleiming.com'}
* appendXhrData 附加到 xhr.data 中的对象数据,传入比如 {"from":"english","to":"japanese"} ,他会直接赋予 xhr.data
* func 请求完成的回调,传入如 function(data){}
* method 请求方式,可传入 post、get
* isAsynchronize 是否是异步请求, 传入 true 是异步请求,传入false 是同步请求。 如果传入false,则本方法返回xhr
* headers 设置请求的header,传入如 {'content-type':'application/x-www-form-urlencoded'};
* abnormalFunc 响应异常所执行的方法,响应码不是200就会执行这个方法 ,传入如 function(xhr){} 另外这里的 xhr 会额外有个参数 xhr.requestURL 返回当前请求失败的url
* showErrorLog 是否控制台打印出来错误日志,true打印, false 不打印
*/
send: (
url,
data,
appendXhrData,
func,
method,
isAsynchronize,
headers,
abnormalFunc,
showErrorLog,
) => {
//post提交的参数
var params = "";
if (data == null || typeof data == "undefined") {
data = {};
}
if (typeof data == "string") {
params = data; //payload 方式 , edge 的方式
} else {
//表单提交方式
//加入浏览器默认语种 v3.6.1 增加,以便更好的进行自动切换语种
data.browserDefaultLanguage = translate.util.browserDefaultLanguage();
//追加附加参数
for (var apindex in translate.request.appendParams) {
if (!Object.hasOwn(translate.request.appendParams, apindex)) {
continue;
}
data[apindex] = translate.request.appendParams[apindex];
}
if (typeof translate.enterprise != "undefined") {
//加入key
if (
typeof translate.enterprise.key != "undefined" &&
typeof translate.enterprise.key == "string" &&
translate.enterprise.key.length > 0
) {
data.key = translate.enterprise.key;
}
}
//组合参数
for (var index in data) {
if (!Object.hasOwn(data, index)) {
continue;
}
if (params.length > 0) {
params = params + "&";
}
params = params + index + "=" + data[index];
}
}
if (url.indexOf("https://") == 0 || url.indexOf("http://") == 0) {
//采用的url绝对路径
} else {
//相对路径,拼接上host
url = translate.request.getUrl(url);
}
var xhr = null;
try {
xhr = new XMLHttpRequest();
} catch (e) {
xhr = new ActiveXObject("Microsoft.XMLHTTP");
}
xhr.data = appendXhrData;
//2.调用open方法(true----异步)
xhr.open(method, url, isAsynchronize);
//设置headers
if (headers != null) {
for (var index in headers) {
if (!Object.hasOwn(headers, index)) {
continue;
}
xhr.setRequestHeader(index, headers[index]);
}
}
//追加附加参数
for (var ahindex in translate.request.appendHeaders) {
if (!Object.hasOwn(translate.request.appendHeaders, ahindex)) {
continue;
}
xhr.setRequestHeader(ahindex, translate.request.appendHeaders[ahindex]);
}
if (translate.service.name == "translate.service") {
xhr.setRequestHeader("currentpage", window.location.href + "");
}
xhr.send(params);
//4.请求状态改变事件
xhr.onreadystatechange = () => {
if (xhr.readyState == 4) {
translate.request.response(xhr); //自定义响应的拦截
if (xhr.status == 200) {
//请求正常,响应码 200
var json = null;
if (
typeof xhr.responseText == "undefined" ||
xhr.responseText == null
) {
//相应内容为空
} else {
//响应内容有值
if (
xhr.responseText.indexOf("{") > -1 &&
xhr.responseText.indexOf("}") > -1
) {
//应该是json格式
try {
json = JSON.parse(xhr.responseText);
} catch (e) {
console.log(e);
}
}
}
if (json == null) {
func(xhr.responseText);
} else {
func(json);
}
} else {
if (showErrorLog) {
if (url.indexOf(translate.request.api.connectTest) > -1) {
//测试链接速度的不在报错里面
} else {
//判断是否是v2版本的翻译,如果是 translate.service 模式并且没有使用企业级翻译,参会提示
//2024.3月底开始,翻译使用量增加的太快,开源的翻译服务器有点扛不住经常出故障,所以直接把这个提示加到这里
if (translate.service.name == "translate.service") {
console.log(
"----- translate.js 提示 -----\n翻译服务响应异常,解决这种情况可以有两种方案:\n【方案一】:使用采用最新版本 3.16.0及更高版本,js引用文件为 https://cdn.staticfile.net/translate.js/3.16.0/translate.js 并且使用 client.edge 模式 (增加一行设置代码就好,可参考 https://translate.zvo.cn/4081.html ),这样就不会再出现这种情况了,而且这个方案也是完全免费的。 \n【方案二】:采用企业级稳定翻译通道 ,但是这个相比于 方案一 来说,是有一定的收费的,大概一年600,这个就是专门为了高速及高稳定准备的,而相比于这个方案二,方案一则是全免费的。 因为方案二我们是部署了两个集群,而每个集群又下分了数个网络节点,包含中国大陆、香港、美国、欧洲、 等多个州,充分保障稳定、高效,同样也产生了不少成本,所以才需要付费。更多信息说明可以参考: http://translate.zvo.cn/4087.html \n【方案三】:私有部署你自己的翻译通道,并且启用内存级翻译缓存,毫秒级响应,但是需要依赖一台1核2G服务器,是最推荐的方式。具体参考:https://translate.zvo.cn/391129.html\n-------------",
);
}
//console.log(xhr);
console.log(
"------- translate.js service api response error --------",
);
console.log(" http code : " + xhr.status);
console.log(" response : " + xhr.response);
console.log(" request url : " + url);
console.log(" request data : " + JSON.stringify(data));
console.log(" request method : " + method);
console.log(
"---------------------- end ----------------------",
);
}
}
xhr.requestURL = url;
if (abnormalFunc != null) {
abnormalFunc(xhr);
}
}
}
};
return xhr;
},
/*
手动进行翻译操作。参数说明:
texts: 可传入要翻译的文本、以及文本数组。 比如要一次翻译多个句子,那就可以传入数组的方式
function: 翻译完毕后的处理函数。传入如 function(data){ console.log(data); }
注意,返回的data.result 为 1,则是翻译成功。 为0则是出错,可通过data.info 得到错误原因。 更详细说明参考: http://api.zvo.cn/translate/service/20230807/translate.json.html
使用案例一:
translate.request.translateText('你好,我是翻译的内容', function(data){
//打印翻译结果
console.log(data);
});
使用案例二:
var texts = ['我是翻译的第一句','我是翻译的第二句','我是翻译的第三句'];
translate.request.translateText(texts, function(data){
//打印翻译结果
console.log(data);
});
使用案例三:
var obj = {
from:'chinese_simplified',
to:'english',
texts: ['我是翻译的第一句','我是翻译的第二句','我是翻译的第三句']
}
translate.request.translateText(obj, function(data){
//打印翻译结果
console.log(data);
});
*/
translateText: (obj, func) => {
var texts = [];
var from = translate.language.getLocal();
var to = translate.language.getCurrent();
if (typeof obj == "string") {
//案例一的场景,传入单个字符串
texts[0] = obj;
} else {
//不是字符串了,而是对象了,判断是案例二还是案例三
var type = Object.prototype.toString.call(obj);
//console.log(type);
if (type == "[object Array]") {
//案例二
texts = obj;
} else if (type == "[object Object]") {
//案例三
if (typeof obj.texts == "undefined") {
console.log(
"translate.request.translateText 传入的值类型异常,因为你没有传入 obj.texts 要翻译的具体文本! 请查阅文档: https://translate.zvo.cn/4077.html",
);
}
if (typeof obj.texts == "string") {
//单个字符串
texts = [obj.texts];
} else {
//多个字符串,数组形态
texts = obj.texts;
}
if (typeof obj.from == "string" && obj.from.length > 0) {
from = obj.from;
}
if (typeof obj.to == "string" && obj.to.length > 0) {
to = obj.to;
}
} else {
console.log(
"translate.request.translateText 传入的值类型错误,请查阅文档: https://translate.zvo.cn/4077.html",
);
return;
}
}
//console.log(obj);
//返回的翻译结果,下标跟 obj.texts 一一对应的
var translateResultArray = [];
// 筛选需要翻译的文本及其原始索引
var apiTranslateText = [];
var apiTranslateArray = {};
for (var i = 0; i < texts.length; i++) {
//判断是否在浏览器缓存中出现了
var hash = translate.util.hash(texts[i]);
var cache = translate.storage.get("hash_" + to + "_" + hash);
//console.log(hash+'\t'+texts[i]+'\t'+cache);
if (cache != null && cache.length > 0) {
//缓存中发现了这个得结果,那这个就不需要再进行翻译了
translateResultArray[i] = cache;
} else {
translateResultArray[i] = "";
apiTranslateText.push(texts[i]);
apiTranslateArray[hash] = i;
}
}
if (apiTranslateText.length == 0) {
//没有需要进行通过网络API翻译的任务了,全部命中缓存,那么直接返回
var data = {
from: from,
to: to,
text: translateResultArray,
result: 1,
};
//console.log(data);
func(data);
return;
}
//还有需要进行通过API接口进行翻译的文本,需要调用翻译接口
if (
typeof translate.request.api.translate != "string" ||
translate.request.api.translate == null ||
translate.request.api.translate.length < 1
) {
//用户已经设置了不掉翻译接口进行翻译
return;
}
var url = translate.request.api.translate;
var data = {
from: from,
to: to,
text: encodeURIComponent(JSON.stringify(apiTranslateText)),
};
//console.log(apiTranslateText);
translate.request.post(
url,
data,
(resultData) => {
//console.log(resultData);
//console.log(data);
if (resultData.result == 0) {
console.log("=======ERROR START=======");
console.log("from : " + resultData.from);
console.log("to : " + resultData.to);
console.log("translate text array : " + texts);
console.log("response : " + resultData.info);
console.log("=======ERROR END =======");
//return;
}
for (var i = 0; i < resultData.text.length; i++) {
//将翻译结果以 key:hash value翻译结果的形式缓存
var hash = translate.util.hash(apiTranslateText[i]);
translate.storage.set(
"hash_" + to + "_" + hash,
resultData.text[i],
);
//如果离线翻译启用了全部提取,那么还要存入离线翻译指定存储
if (translate.office.fullExtract.isUse) {
translate.office.fullExtract.set(
hash,
apiTranslateText[i],
data.to,
resultData.text[i],
);
}
//进行组合数据到 translateResultArray
translateResultArray[apiTranslateArray[hash]] = resultData.text[i];
}
resultData.text = translateResultArray;
func(resultData);
},
null,
);
},
listener: {
minIntervalTime: 800, // 两次触发的最小间隔时间,单位是毫秒,这里默认是800毫秒。最小填写时间为 200毫秒
lasttime: 0, // 最后一次触发执行 translate.execute() 的时间,进行执行的那一刻,而不是执行完。13位时间戳
/*
设置要在未来的某一时刻执行,单位是毫秒,13位时间戳。
执行时如果当前时间大于这个数,则执行,并且将这个数置为0。
会有一个循环执行函数每间隔200毫秒触发一次
*/
executetime: 0,
/*
进行翻译时,延迟翻译执行的时间
当ajax请求结束后,延迟这里设置的时间,然后自动触发 translate.execute() 执行
*/
delayExecuteTime: 200,
/*
满足ajax出发条件,设置要执行翻译。
注意,设置这个后并不是立马就会执行,而是加入了一个执行队列,避免1秒请求了10次会触发10次执行的情况
*/
addExecute: () => {
var currentTime = Date.now();
if (translate.request.listener.lasttime == 0) {
//是第一次,lasttime还没设置过,那么直接设置执行时间为当前时间
translate.request.listener.executetime = currentTime;
translate.request.listener.lasttime = 1;
} else {
//不是第一次了
if (translate.request.listener.executetime > 1) {
//当前有执行队列等待,不用再加入执行等待了
//console.log('已在执行队列,不用再加入了 '+currentTime);
} else {
//执行队列中还没有,可以加入执行命令
if (
currentTime <
translate.request.listener.lasttime +
translate.request.listener.minIntervalTime
) {
//如果当前时间小于最后一次执行时间+间隔时间,那么就是上次才刚刚执行过,这次执行的太快了,那么赋予未来执行翻译的时间为最后一次时间+间隔时间
translate.request.listener.executetime =
translate.request.listener.lasttime +
translate.request.listener.minIntervalTime;
//console.log('addexecute - < 如果当前时间小于最后一次执行时间+间隔时间,那么就是上次才刚刚执行过,这次执行的太快了,那么赋予未来执行翻译的时间为最后一次时间+间隔时间');
} else {
translate.request.listener.executetime = currentTime;
//console.log('addexecute -- OK ');
}
}
}
},
/*
自定义是否会被触发的方法判断
url 当前ajax请求的url,注意是这个url请求完毕获取到200相应的内容时才会触发此方法
返回值 return true; 默认是不管什么url,全部返回true,表示会触发翻译自动执行 translate.execute; ,如果你不想让某个url触发翻译,那么你可以自行在这个方法中用代码进行判断,然后返回false,那么这个url将不会自动触发翻译操作。
*/
trigger: (url) => true,
/*js translate.request.listener.start start*/
/*
启动根据ajax请求来自动触发执行翻译,避免有时候有的框架存在漏翻译的情况。
这个只需要执行一次即可,如果执行多次,只有第一次会生效
*/
start: () => {
//确保这个方法只会触发一次,不会过多触发
if (typeof translate.request.listener.isStart != "undefined") {
return;
}
translate.request.listener.isStart = true;
//增加一个没100毫秒检查一次执行任务的线程
setInterval(() => {
var currentTime = Date.now();
if (
translate.request.listener.executetime > 1 &&
currentTime >
translate.request.listener.executetime +
translate.request.listener.delayExecuteTime
) {
translate.request.listener.executetime = 0;
translate.request.listener.lasttime = currentTime;
try {
//console.log('执行翻译 --'+currentTime);
translate.execute();
} catch (e) {
console.log(e);
}
}
}, 100);
if (typeof PerformanceObserver == "undefined") {
console.log(
"因浏览器版本较低, translate.request.listener.start() 中 PerformanceObserver 对象不存在,浏览器不支持,所以 translate.request.listener.start() 未生效。",
);
return;
}
const observer = new PerformanceObserver((list) => {
var translateExecute = false; //是否需要执行翻译 true 要执行
for (var e = 0; e < list.getEntries().length; e++) {
var entry = list.getEntries()[e];
if (
entry.initiatorType === "fetch" ||
entry.initiatorType === "xmlhttprequest"
) {
var url = entry.name;
//console.log(url);
//判断url是否是当前translate.js本身使用的
if (typeof translate.request.api.host == "string") {
translate.request.api.host = [translate.request.api.host];
}
var ignoreUrl = false; // 是否是忽略的url true是
//translate.service 模式判断
for (var i = 0; i < translate.request.api.host.length; i++) {
if (url.indexOf(translate.request.api.host[i]) > -1) {
//是,那么直接忽略
ignoreUrl = true;
break;
}
}
//client.edge 判断 translate.service.edge可能会被精简translate.js定制时给直接干掉,所以提前加个判断
if (
typeof translate.service.edge != "undefined" &&
url.indexOf(translate.service.edge.api.auth) > -1
) {
ignoreUrl = true;
}
if (url.indexOf(".microsofttranslator.com/translate") > -1) {
ignoreUrl = true;
}
if (ignoreUrl) {
//console.log('忽略:'+url);
continue;
}
if (translate.request.listener.trigger()) {
//正常,会触发翻译,也是默认的
} else {
//不触发翻译,跳过
continue;
}
translateExecute = true;
break;
}
}
if (translateExecute) {
//console.log('translate.request.listener.addExecute() -- '+Date.now());
translate.request.listener.addExecute();
}
});
//v3.15.14.20250617 增加
// 优先使用 entryTypes 兼容 ES5 的写法
var supportedTypes = PerformanceObserver.supportedEntryTypes;
if (supportedTypes) {
var hasResource = false;
for (var i = 0; i < supportedTypes.length; i++) {
if (supportedTypes[i] === "resource") {
hasResource = true;
break;
}
}
if (hasResource) {
try {
observer.observe({ entryTypes: ["resource"] });
return;
} catch (e) {
console.log(
"PerformanceObserver entryTypes 失败,尝试 type 参数",
);
}
}
}
// 回退到 type 参数
try {
observer.observe({ type: "resource", buffered: true });
console.log("使用 PerformanceObserver type");
} catch (e) {
console.log(
"当前浏览器不支持 PerformanceObserver 的任何参数, translate.request.listener.start() 未启动",
);
}
},
/*js translate.request.listener.start end*/
},
},
//存储,本地缓存
storage: {
/*js translate.storage.IndexedDB start*/
//对浏览器的 IndexedDB 操作
IndexedDB: {
db: null,
// 初始化数据库
initDB: function () {
return new Promise((resolve, reject) => {
const DB_NAME = "translate.js";
const STORE_NAME = "kvStore";
const DB_VERSION = 1;
const request = indexedDB.open(DB_NAME, DB_VERSION);
request.onupgradeneeded = (event) => {
const upgradedDb = event.target.result;
if (!upgradedDb.objectStoreNames.contains(STORE_NAME)) {
upgradedDb.createObjectStore(STORE_NAME, { keyPath: "key" });
}
};
request.onsuccess = (event) => {
this.db = event.target.result;
resolve();
};
request.onerror = (event) => {
reject("IndexedDB 打开失败");
};
});
},
/*
存储键值对
使用方式:
await translate.storage.indexedDB.set("user_001", { name: "Alice" });
*/
set: async function (key, value) {
if (!this.db) await this.initDB();
return new Promise((resolve, reject) => {
const tx = this.db.transaction("kvStore", "readwrite");
const store = tx.objectStore("kvStore");
const item = { key, value };
const request = store.put(item);
request.onsuccess = () => resolve();
request.onerror = () => reject("写入失败");
});
},
/*
获取键对应的值
使用方式:
var user = await translate.storage.indexedDB.get("user_001");
*/
get: async function (key) {
if (!this.db) await this.initDB();
return new Promise((resolve, reject) => {
const tx = this.db.transaction("kvStore", "readonly");
const store = tx.objectStore("kvStore");
const request = store.get(key);
request.onsuccess = () => {
const result = request.result;
resolve(result ? result.value : undefined);
};
request.onerror = () => reject("读取失败");
});
},
/*
列出针对key进行模糊匹配的所有键值对
使用方式:
const users = await translate.storage.indexedDB.list("*us*r*");
其中传入的key可以模糊搜索,其中的 * 标识另个或多个
*/
list: async function (key = "") {
if (!this.db) await this.initDB();
return new Promise((resolve, reject) => {
const tx = this.db.transaction("kvStore", "readonly");
const store = tx.objectStore("kvStore");
const request = store.openCursor();
const results = [];
// 将通配符 pattern 转换为正则表达式
const regexStr = "^" + key.replace(/\*/g, ".*") + "$";
const regex = new RegExp(regexStr);
request.onsuccess = (event) => {
const cursor = event.target.result;
if (cursor) {
if (regex.test(cursor.key)) {
results.push({ key: cursor.key, value: cursor.value.value });
}
cursor.continue();
} else {
resolve(results);
}
};
request.onerror = () => reject("游标读取失败");
});
},
},
/*js translate.storage.IndexedDB end*/
set: (key, value) => {
localStorage.setItem(key, value);
},
get: (key) => localStorage.getItem(key),
},
//针对图片进行相关的语种图片替换
images: {
/* 要替换的图片队列,数组形态,其中某个数组的:
key:"/uploads/allimg/160721/2-160H11URA25-lp.jpg"; //旧图片,也就是原网站本身的图片。也可以绝对路径,会自动匹配 img src 的值,匹配时会进行完全匹配
value:"https://xxx.com/abc_{language}.jpg" //新图片,要被替换为的新图片。新图片路径需要为绝对路径,能直接访问到的。其中 {language} 会自动替换为当前要显示的语种。比如你要将你中文网站翻译为繁体中文,那这里会自动替换为:https://xxx.com/abc_chinese_traditional.jpg 有关{language}的取值,可查阅 http://api.translate.zvo.cn/doc/language.json.html 其中的语言标识id便是
*/
queues: [],
/*
向图片替换队列中追加要替换的图片
传入格式如:
translate.images.add({
"/uploads/a.jpg":"https://www.zvo.cn/a_{language}.jpg",
"/uploads/b.jpg":"https://www.zvo.cn/b_{language}.jpg",
});
参数说明:
key //旧图片,也就是原网站本身的图片。也可以绝对路径,会自动匹配 img src 的值,匹配时会进行完全匹配
value //新图片,要被替换为的新图片。新图片路径需要为绝对路径,能直接访问到的。其中 {language} 会自动替换为当前要显示的语种。比如你要将你中文网站翻译为繁体中文,那这里会自动替换为:https://xxx.com/abc_chinese_traditional.jpg 有关{language}的取值,可查阅 http://api.translate.zvo.cn/doc/language.json.html 其中的语言标识id便是
*/
add: (queueArray) => {
/*
translate.images.queues[translate.images.queues.length] = {
old:oldImage,
new:newImage
}
*/
for (var key in queueArray) {
if (!Object.hasOwn(queueArray, key)) {
continue;
}
translate.images.queues[key] = queueArray[key];
}
},
//执行图片替换操作,将原本的图片替换为跟翻译语种一样的图片
execute: () => {
//console.log(translate.images.queues);
if (Object.keys(translate.images.queues).length < 1) {
//如果没有,那么直接取消图片的替换扫描
return;
}
/*** 寻找img标签中的图片 ***/
var imgs = document.getElementsByTagName("img");
for (var i = 0; i < imgs.length; i++) {
var img = imgs[i];
if (
typeof img.src == "undefined" ||
img.src == null ||
img.src.length == 0
) {
continue;
}
var imgSrc = img.getAttribute("src"); //这样获取到的才是src原始的值,不然 img.src 是拿到一个绝对路径
for (var key in translate.images.queues) {
var oldImage = key; //原本的图片src
var newImage = translate.images.queues[key]; //新的图片src,要替换为的
//console.log('queue : '+oldImage + ' , img.src: '+imgSrc);
if (oldImage == imgSrc) {
//console.log('发现匹配图片:'+imgSrc);
/*
//判断当前元素是否在ignore忽略的tag、id、class name中
if(translate.ignore.isIgnore(node)){
console.log('node包含在要忽略的元素中:');
console.log(node);
continue;
}
*/
//没在忽略元素里,可以替换
newImage = newImage.replace(/{language}/g, translate.to);
img.src = newImage;
}
}
}
/********** 还要替换style中的背景图 */
// 获取当前网页中所有的元素
var elems = document.getElementsByTagName("*");
// 遍历每个元素,检查它们是否有背景图
for (var i = 0; i < elems.length; i++) {
var elem = elems[i];
// 获取元素的计算后样式
var style = window.getComputedStyle(elem, null);
// 获取元素的背景图URL
var bg = style.backgroundImage;
// 如果背景图不为空,打印出来
if (bg != "none") {
//console.log(bg);
var old_img = translate.images.gainCssBackgroundUrl(bg);
//console.log("old_img:"+old_img);
if (typeof translate.images.queues[old_img] != "undefined") {
//存在
var newImage = translate.images.queues[old_img];
newImage = newImage.replace(/{language}/g, translate.to);
//更换翻译指定图像
elem.style.backgroundImage = 'url("' + newImage + '")';
} else {
//console.log('发现图像'+old_img+', 但未做语种适配');
}
}
}
},
//取css中的背景图,传入 url("https://xxx.com/a.jpg") 返回里面单纯的url
gainCssBackgroundUrl: (str) => {
// 使用indexOf方法,找到第一个双引号的位置
var start = str.indexOf('"');
// 使用lastIndexOf方法,找到最后一个双引号的位置
var end = str.lastIndexOf('"');
// 如果找到了双引号,使用substring方法,截取中间的内容
if (start != -1 && end != -1) {
var url = str.substring(start + 1, end); // +1是为了去掉双引号本身
//console.log(url); // https://e-assets.gitee.com/gitee-community-web/_next/static/media/mini_app.2e6b6d93.jpg!/quality/100
return url;
}
return str;
},
},
/*js translate.reset start*/
//对翻译结果进行复原。比如当前网页是简体中文的,被翻译为了英文,执行此方法即可复原为网页本身简体中文的状态,而无需在通过刷新页面来实现
reset: () => {
var currentLanguage = translate.language.getCurrent(); //获取当前翻译至的语种
var lastUuid = ""; //最后一次的uuid
for (var queue in translate.nodeQueue) {
if (!Object.hasOwn(translate.nodeQueue, queue)) {
continue;
}
lastUuid = queue;
}
//console.log(queue);
if (lastUuid == "") {
console.log(
"提示,你当前还未执行过翻译,所以你无需执行 translate.reset(); 进行还原。",
);
return;
}
for (var lang in translate.nodeQueue[lastUuid].list) {
if (!Object.hasOwn(translate.nodeQueue[lastUuid].list, lang)) {
continue;
}
//console.log(lang);
for (var hash in translate.nodeQueue[lastUuid].list[lang]) {
if (!Object.hasOwn(translate.nodeQueue[lastUuid].list[lang], hash)) {
continue;
}
var item = translate.nodeQueue[lastUuid].list[lang][hash];
//console.log(item);
for (var index in item.nodes) {
if (!Object.hasOwn(item.nodes, index)) {
continue;
}
//console.log(item.nodes[index]);
//item.nodes[index].node.nodeValue = item.original;
var currentShow = translate.storage.get(
"hash_" + currentLanguage + "_" + hash,
); //当前显示出来的文字,也就是已经翻译后的文字
//console.log('hash_'+lang+'_'+hash+' -- '+currentShow);
if (typeof currentShow == "undefined") {
continue;
}
if (currentShow == null) {
continue;
}
if (currentShow.length == 0) {
continue;
}
/*
if(item.beforeText.length > 0 || item.afterText.length > 0){
console.log('----'+currentShow);
console.log(item);
}
if(item.beforeText.length > 0){
currentShow = currentShow.substring(currentShow.lastIndexOf(item.beforeText)+1, currentShow.length);
}
if(item.afterText.length > 0){
currentShow = currentShow.substring(0, currentShow.lastIndexOf(item.afterText));
}
if(item.beforeText.length > 0 || item.afterText.length > 0){
console.log(currentShow);
}
*/
// v3.16.5 针对gitee 的 readme 接入优化
if (typeof item.nodes[index].node == "undefined") {
continue;
}
var attribute =
typeof item.nodes[index].node.attribute == "undefined"
? null
: item.nodes[index].node.attribute;
var analyse = translate.element.nodeAnalyse.analyse(
item.nodes[index].node,
"",
"",
attribute,
);
translate.element.nodeAnalyse.analyse(
item.nodes[index].node,
analyse.text,
item.original,
attribute,
);
}
}
}
//清除设置storage中的翻译至的语种
translate.storage.set("to", "");
translate.to = null;
//重新渲染select
translate.selectLanguageTag.render();
},
/*js translate.reset end*/
/*js translate.selectionTranslate start*/
/*
划词翻译,鼠标在网页中选中一段文字,会自动出现对应翻译后的文本
有网友 https://gitee.com/huangguishen 提供。
详细使用说明参见:http://translate.zvo.cn/41557.html
*/
selectionTranslate: {
selectionX: 0,
selectionY: 0,
callTranslate: (event) => {
const curSelection = window.getSelection();
//相等认为没有划词
if (curSelection.anchorOffset == curSelection.focusOffset) return;
const translateText = window.getSelection().toString();
//还有需要进行通过API接口进行翻译的文本,需要调用翻译接口
if (
typeof translate.request.api.translate != "string" ||
translate.request.api.translate == null ||
translate.request.api.translate.length < 1
) {
//用户已经设置了不掉翻译接口进行翻译
console.log("已设置了不使用 translate 翻译接口,翻译请求被阻止");
return;
}
//简单Copy原有代码了
var url = translate.request.api.translate;
var data = {
from: translate.language.getLocal(),
to: translate.to,
text: encodeURIComponent(JSON.stringify([translateText])),
};
translate.request.post(
url,
data,
(data) => {
if (data.result == 0) return;
const curTooltipEle = document.querySelector("#translateTooltip");
curTooltipEle.innerText = data.text[0];
curTooltipEle.style.top = selectionY + 20 + "px";
curTooltipEle.style.left = selectionX + 50 + "px";
curTooltipEle.style.display = "";
},
null,
);
},
start: () => {
//新建一个tooltip元素节点用于显示翻译
const tooltipEle = document.createElement("span");
tooltipEle.innerText = "";
tooltipEle.setAttribute("id", "translateTooltip");
tooltipEle.setAttribute(
"style",
"background-color:black;color:#fff;text-align:center;border-radius:6px;padding:5px;position:absolute;z-index:999;top:150%;left:50%; ",
);
//把元素节点添加到body元素节点中成为其子节点,放在body的现有子节点的最后
document.body.appendChild(tooltipEle);
//监听鼠标按下事件,点击起始点位置作为显示翻译的位置点
document.addEventListener(
"mousedown",
(event) => {
selectionX = event.pageX;
selectionY = event.pageY;
},
false,
);
//监听鼠标弹起事件,便于判断是否处于划词
document.addEventListener(
"mouseup",
translate.selectionTranslate.callTranslate,
false,
);
//监听鼠标点击事件,隐藏tooltip,此处可优化
document.addEventListener(
"click",
(event) => {
document.querySelector("#translateTooltip").style.display = "none";
},
false,
);
},
},
/*js translate.selectionTranslate end*/
/*js translate.enterprise start*/
/*
企业级翻译服务
注意,这个企业级翻译中的不在开源免费之中,企业级翻译服务追求的是高稳定,这个是收费的!详情可参考:http://translate.zvo.cn/43262.html
*/
enterprise: {
//默认不启用企业级,除非设置了 translate.enterprise.use() 这里才会变成true
isUse: false,
use: () => {
translate.enterprise.isUse = true; //设置为使用企业级翻译服务
//主节点额外权重降低,更追求响应速度
translate.request.speedDetectionControl.hostMasterNodeCutTime = 300;
translate.request.api.host = [
"https://america-enterprise-api-translate.zvo.cn/",
"https://beijing.enterprise.api.translate.zvo.cn/",
"https://deutsch.enterprise.api.translate.zvo.cn/",
"https://america.api.translate.zvo.cn:666/",
"https://api.translate.zvo.cn:666/",
"https://api.translate.zvo.cn:888/",
];
if (translate.service.name == "client.edge") {
translate.service.name = "translate.service";
console.log(
"您已启用了企业级翻译通道 translate.enterprise.use(); (文档:https://translate.zvo.cn/4087.html) , 所以您设置的 translate.service.use('client.edge'); (文档:https://translate.zvo.cn/4081.html) 将失效不起作用,有企业级翻译通道全部接管。",
);
return;
}
},
/*
自动适配翻译服务通道,如果当前所有网络节点均不可用,会自动切换到 edge.client 进行使用
这个会在 post请求 执行前开始时进行触发
*/
automaticAdaptationService: () => {
if (!translate.enterprise.isUse) {
return;
}
var hosts = translate.request.speedDetectionControl.getHostQueue();
//console.log(hosts);
if (hosts.length > 0) {
if (
hosts[0].time + 1 >
translate.request.speedDetectionControl.disableTime
) {
//所有节点都处于不可用状态,自动切换到 client.edge 模式
translate.service.name = "client.edge";
}
}
},
/* 企业级翻译通道的key, v3.12.3.20250107 增加,针对打包成APP的场景 */
key: "",
},
/*js translate.enterprise end*/
/*
如果使用的是 translate.service 翻译通道,那么翻译后的语种会自动以小写的方式进行显示。
如果你不想将翻译后的文本全部以小写显示,而是首字母大写,那么可以通过此方法设置一下
v3.8.0.20240828 增加
目前感觉应该用不到,所以先忽略
*/
/*
notConvertLowerCase:function(){
},
*/
/*js translate.init start*/
/*
初始化,如版本检测、初始数据加载等。 v2.11.11.20240124 增加
会自动在 translate.js 加载后的 200毫秒后 执行,进行初始化。同时也是节点测速
*/
init: () => {
if (typeof translate.init_execute != "undefined") {
return;
}
translate.init_execute = "已进行";
if (
typeof translate.request.api.init != "string" ||
translate.request.api.init == null ||
translate.request.api.init.length < 1
) {
return;
}
try {
translate.request.send(
translate.request.api.init,
{},
{},
(data) => {
if (data.result == 0) {
console.log("translate.js init 初始化异常:" + data.info);
return;
}
if (data.result == 1) {
//服务端返回的最新版本
var newVersion = translate.util.versionStringToInt(data.version);
//当前translate.js的版本
var currentVersion = translate.util.versionStringToInt(
translate.version.replace("v", ""),
);
if (newVersion > currentVersion) {
console.log(
"Tip : translate.js find new version : " + data.version,
);
}
}
},
"post",
true,
null,
(data) => {
//console.log('eeerrr');
},
false,
);
} catch (e) {}
},
/*js translate.init end*/
/*js translate.progress start*/
/*
翻译执行的进展相关
比如,浏览器本地缓存没有,需要走API接口的文本所在的元素区域,出现 记载中的动画蒙版,给用户以友好的使用提示
*/
progress: {
style: `
/* CSS部分 */
/* 灰色水平加载动画 */
.translate_api_in_progress {
position: relative;
overflow: hidden; /* 隐藏超出部分的动画 */
}
/* 蒙版层 */
.translate_api_in_progress::after {
content: '';
position: absolute;
top: 0;
left: 0;
width: 100%;
height: 100%;
background: rgba(255, 255, 255, 1); /* 半透明白色遮罩 */
z-index: 2;
}
/* 水平加载条动画 */
.translate_api_in_progress::before {
content: '';
position: absolute;
top: 50%;
left: 0;
width: 100%;
height:100%; /* 细线高度 */
background: linear-gradient(
90deg,
transparent 0%,
#e8e8e8 25%, /* 浅灰色 */
#d0d0d0 50%, /* 中灰色 */
#e8e8e8 75%, /* 浅灰色 */
transparent 100%
);
background-size: 200% 100%;
animation: translate_api_in_progress_horizontal-loader 3.5s linear infinite;
z-index: 3;
transform: translateY(-50%);
}
@keyframes translate_api_in_progress_horizontal-loader {
0% {
background-position: 200% 0;
}
100% {
background-position: -200% 0;
}
}
`,
/*
通过文本翻译API进行的
*/
api: {
isTip: true, //是否显示ui的提示,true显示,false不显示
setUITip: (tip) => {
translate.progress.api.isTip = tip;
},
//移除子元素(无限级别)中的所有 class name 的loading 遮罩
//level 层级,数字,比如第一次调用,传入1, 第一次里面产生的第二次调用,这里就是2
removeChildClass: (node, level) => {
//判断是否有子元素,判断其两级子元素,是否有加了loading遮罩了
var childNodes = node.childNodes;
if (childNodes == null || typeof childNodes == "undefined") {
} else if (childNodes.length > 0) {
for (var i = 0; i < childNodes.length; i++) {
translate.progress.api.removeChildClass(childNodes[i], level + 1);
}
}
if (level == 1) {
//第一次调用,是不删除本身的class name
return;
}
if (typeof node == "undefined") {
return;
}
if (typeof node.className != "string") {
return;
}
if (node.className.indexOf("translate_api_in_progress") < -1) {
return;
}
node.className = node.className.replace(
/translate_api_in_progress/g,
"",
);
},
startUITip: () => {
// 创建一个 style 元素
const style = document.createElement("style");
// 设置 style 元素的文本内容为要添加的 CSS 规则
style.textContent = translate.progress.style;
// 将 style 元素插入到 head 元素中
document.head.appendChild(style);
if (translate.progress.api.isTip) {
translate.listener.execute.renderStartByApi.push((uuid, from, to) => {
for (var hash in translate.nodeQueue[uuid].list[from]) {
if (!Object.hasOwn(translate.nodeQueue[uuid].list[from], hash)) {
continue;
}
for (var nodeindex in translate.nodeQueue[uuid].list[from][hash]
.nodes) {
if (
!Object.hasOwn(
translate.nodeQueue[uuid].list[from][hash].nodes,
nodeindex,
)
) {
continue;
}
var node =
translate.nodeQueue[uuid].list[from][hash].nodes[nodeindex]
.node;
if (
typeof node == "undefined" ||
typeof node.parentNode == "undefined"
) {
continue;
}
var nodeParent = node.parentNode;
if (nodeParent == null) {
continue;
}
/* 这里先不考虑多隐藏的问题,只要符合的都隐藏,宁愿吧一些不需要隐藏的也会跟着一起隐藏
if(nodeParent.childNodes.length != 1){
//这个文本节点所在的元素里,不止有这一个文本元素,还有别的文本元素
continue;
}
*/
//判断其在上一层的父级是否已经加了,如果父级加了,那作为子集就不需要在加了,免得出现两个重合的 loading 遮罩
var nodeParentParent = node.parentNode;
if (
nodeParentParent != null &&
typeof nodeParentParent.className != "undefined" &&
nodeParentParent.className != null &&
nodeParent.className.indexOf("translate_api_in_progress") > -1
) {
//父有了,那么子就不需要再加了
continue;
}
//判断是否有子元素,判断其两级子元素,是否有加了loading遮罩了
translate.progress.api.removeChildClass(nodeParent, 1);
if (
typeof nodeParent.className == "undefined" ||
nodeParent.className == null ||
nodeParent.className == ""
) {
nodeParent.className = " translate_api_in_progress";
} else {
//这个元素本身有class了,那就追加
if (
nodeParent.className.indexOf("translate_api_in_progress") >
-1
) {
continue;
}
nodeParent.className =
nodeParent.className + " translate_api_in_progress";
}
}
}
});
translate.listener.execute.renderFinishByApi.push(
(uuid, from, to) => {
for (var hash in translate.nodeQueue[uuid].list[from]) {
if (
!Object.hasOwn(translate.nodeQueue[uuid].list[from], hash)
) {
continue;
}
for (var nodeindex in translate.nodeQueue[uuid].list[from][hash]
.nodes) {
if (
!Object.hasOwn(
translate.nodeQueue[uuid].list[from][hash].nodes,
nodeindex,
)
) {
continue;
}
var node =
translate.nodeQueue[uuid].list[from][hash].nodes[nodeindex]
.node;
var nodeParent = node.parentNode;
if (nodeParent == null) {
continue;
}
/*
注释这个,因为可能是给这个元素动态追加删除导致其子元素不是11
if(nodeParent.childNodes.length != 1){
continue;
}
*/
var parentClassName = nodeParent.className;
if (
typeof parentClassName == "undefined" ||
parentClassName == null ||
parentClassName == ""
) {
continue;
}
if (
parentClassName.indexOf("translate_api_in_progress") < -1
) {
continue;
}
nodeParent.className = parentClassName.replace(
/translate_api_in_progress/g,
"",
);
//nodeParent.className = parentClassName.replace(/loading/g, '');
}
}
},
);
}
},
},
},
/*js translate.progress end*/
/*js dispose start*/
/*
对js对象内的值进行翻译,可以是JS定义的 对象、数组、甚至是单个具体的值
*/
js: {
/*
jsString 传入的js对象的字符串格式
targetLanguage 翻译为的目标语言
successFunction 执行成功后触发,传入格式 function(obj){ console.log(obj); } 其中 obj 是翻译之后的结果
failureFunction 执行失败后触发,传入格式 function(failureInfo){ console.log(failureInfo); } 其中 failureInfo 是失败原因
示例:
var str = `
{
"hello":"你好",
"word":"单词",
"你是谁": [
"世界",
"大海"
]
}
`
translate.js.transString(str,'english',function(obj){ console.log(obj); }, function(failureInfo){ console.log(failureInfo); });
*/
transString: (
jsString,
targetLanguage,
successFunction,
failureFunction,
) => {
let jsObject;
try {
jsObject = JSON.parse(jsString);
} catch (e) {
failureFunction(e);
return;
}
translate.js.transObject(
jsObject,
targetLanguage,
successFunction,
failureFunction,
);
},
/*
jsObject 传入的js对象,支持对象、数组等
targetLanguage 翻译为的目标语言
successFunction 执行成功后触发,传入格式 function(obj){ console.log(obj); } 其中 obj 是翻译之后的结果
failureFunction 执行失败后触发,传入格式 function(failureInfo){ console.log(failureInfo); } 其中 failureInfo 是失败原因
示例:
var obj = {
"hello":"你好",
"word":"单词",
"世界":["世界","大海"]
};
translate.js.transObject(obj,'english',function(obj){ console.log(obj); }, function(failureInfo){ console.log(failureInfo); });
*/
transObject: (
jsObject,
targetLanguage,
successFunction,
failureFunction,
) => {
const kvs = translate.js.find(jsObject);
//console.log(JSON.stringify(kvs, null, 2));
/**** 第二步,将文本值进行翻译 ***/
//先将其 kvs 的key 取出来
var texts = [];
for (const key in kvs) {
texts.push(key);
}
var obj = {
from: "auto",
to: targetLanguage,
texts: texts,
};
translate.request.translateText(obj, (data) => {
//打印翻译结果
//console.log(data);
if (typeof data.result == "undefined" || data.result == 0) {
failureFunction("network connect failure");
return;
}
if (data.result == 0) {
failureFunction(data.info);
return;
}
/**** 第三步,将翻译结果赋予 jsObject ***/
const translatedTexts = data.text; // 获取翻译结果数组
if (translatedTexts && translatedTexts.length === texts.length) {
texts.forEach((originalText, index) => {
const translatedText = translatedTexts[index]; // 根据索引获取翻译结果
const paths = kvs[originalText]; // 获取该文本的路径数组
if (paths && paths.length > 0) {
paths.forEach((path) => {
translate.js.setValueByPath(jsObject, path, translatedText); // 更新 jsObject
});
}
});
} else {
console.error("翻译结果长度不匹配或为空");
}
successFunction(jsObject);
//console.log("翻译后的 jsObject:", jsObject);
});
},
setValueByPath: (obj, path, value) => {
const parts = path.replace(/\[(\d+)\]/g, ".$1").split(".");
let current = obj;
for (let i = 0; i < parts.length - 1; i++) {
current = current[parts[i]];
}
current[parts[parts.length - 1]] = value;
},
/*
对js对象进行翻译
obj: 可以是JS定义的 对象、数组、甚至是单个具体的值
var obj = {
"hello":"你好",
"word":"单词",
"世界":["世界","大海"]
};
translate.js.find(obj);
*/
find: (obj, parentKey = "") => {
const kvs = {};
if (typeof obj === "object" && obj !== null) {
if (Array.isArray(obj)) {
obj.forEach((item, index) => {
const currentKey = parentKey
? `${parentKey}[${index}]`
: `[${index}]`;
const subKvs = translate.js.find(item, currentKey);
for (const [text, paths] of Object.entries(subKvs)) {
if (!kvs[text]) {
kvs[text] = [];
}
kvs[text] = kvs[text].concat(paths);
}
});
} else {
for (const key in obj) {
const currentKey = parentKey ? `${parentKey}.${key}` : key;
if (typeof obj[key] === "object" && obj[key] !== null) {
const subKvs = translate.js.find(obj[key], currentKey);
for (const [text, paths] of Object.entries(subKvs)) {
if (!kvs[text]) {
kvs[text] = [];
}
kvs[text] = kvs[text].concat(paths);
}
} else if (typeof obj[key] === "string") {
if (typeof kvs[obj[key]] === "undefined") {
kvs[obj[key]] = [];
}
kvs[obj[key]].push(currentKey);
}
}
}
} else if (typeof obj === "string") {
if (typeof kvs[obj] === "undefined") {
kvs[obj] = [];
}
kvs[obj].push(parentKey);
}
return kvs;
},
},
/*js dispose end*/
/*js translate.network start*/
/*
网络请求数据拦截并翻译
当用户触发ajax请求时,它可以针对ajax请求中的某个参数,进行获取,并进行翻译,将翻译后的文本赋予这个参数,然后再放开请求。
使用场景如:
搜索场景,原本是中文的页面,翻译为英文后,给美国人使用,美国人使用时,进行搜索,输入的是英文,然后点击搜索按钮,发起搜索。
然后此会拦截网络请求,将请求中用户输入的搜索文本的内容提取出来,识别它输入的是中文还是英文,如果不是本地的语种中文,那就将其翻译为中文,然后再赋予此请求的这个参数中,然后再放开这次请求。
这样请求真正到达服务端接口时,服务端接受到的搜索的文本内容实际就是翻译后的中文文本,而不是用户输入的英文文本。
何时自动进行翻译:
1. 当前用户没有进行切换语言
2. 切换语言了,但是输入的文本的语言是不需要进行翻译的, 输入的文本本身就是本地的语言
这两种情况那就不需要拦截翻译
*/
network: {
// 原始方法保存
originalOpen: XMLHttpRequest.prototype.open,
originalSend: XMLHttpRequest.prototype.send,
setRequestHeaderOriginal: XMLHttpRequest.prototype.setRequestHeader,
// 规则配置
rules: [
{
url: /https:\/\/www\.guanleiming\.com\/a\/b\/.html/,
methods: ["GET", "POST"],
params: ["a", "b1"],
},
],
//根据 当前请求的url 跟 method 来判断当前请求是否符合规则,
//如果符合,则返回符合的 rule 规则,也就是 translate.network.rules 中配置的某个。
//如果没有找到符合的,则返回 null
getRuleMatch: (url, method) => {
for (let i = 0; i < translate.network.rules.length; i++) {
const rule = translate.network.rules[i];
// 检查 URL 是否匹配
if (typeof rule.url == "undefined" && rule.url == "") {
console.log("WARINNG : translate.network.rule find url is null:");
console.log(rule);
continue;
}
//console.log(rule);
const isUrlMatch = rule.url.test(url);
if (!isUrlMatch) {
continue;
}
// 检查方法是否匹配(忽略大小写)
const isMethodMatch = rule.methods.includes(method.toUpperCase());
if (!isMethodMatch) {
continue;
}
return rule;
}
return null;
},
use: () => {
// 应用Hook
XMLHttpRequest.prototype.open = function (...args) {
return translate.network.hookOpen.apply(this, args);
};
XMLHttpRequest.prototype.send = function (...args) {
return translate.network.hookSend.apply(this, args);
};
// 劫持 setRequestHeader 方法
XMLHttpRequest.prototype.setRequestHeader = function (...args) {
return translate.network.setRequestHeader.apply(this, args);
};
translate.network.fetch.use();
},
// 私有工具方法
_translateText(text) {
if (
translate.language.getLocal() == translate.language.getCurrent() ||
(typeof text == "string" &&
text.length > 0 &&
translate.language.recognition(text).languageName ==
translate.language.getLocal())
) {
/*
1. 没有进行切换语言
2. 切换语言了,但是输入的文本的语言是不需要进行翻译的, 输入的文本本身就是本地的语言
这两种情况那就不需要拦截翻译
*/
return new Promise((resolve, reject) => {
const obj = {
from: "auto",
to: translate.language.getLocal(),
text: [text],
};
resolve(obj);
});
}
//有进行切换了,那进行翻译,将其他语种翻译为当前的本地语种
return new Promise((resolve, reject) => {
const obj = {
from: "auto",
to: translate.language.getLocal(),
texts: [text],
};
//console.log('翻译请求:', obj);
translate.request.translateText(obj, (data) => {
if (data.result === 1) {
resolve(data);
} else {
reject(data);
}
});
});
},
//劫持 setRequestHeader
setRequestHeader: function (header, value) {
if (this._requestContext) {
this._requestContext.headers = this._requestContext.headers || {};
this._requestContext.headers[header] = value;
}
return translate.network.setRequestHeaderOriginal.call(
this,
header,
value,
);
},
// 请求处理工具
RequestHandler: {
async handleGet(url, rule) {
//console.log(url);
//console.log(rule);
if (
typeof rule.params == "undefined" &&
typeof rule.params.length == "undefined" &&
rule.params.length < 1
) {
console.log("WARINNG: rule not find params , rule : ");
console.log(rule);
rule.params = [];
}
try {
const urlObj = new URL(url, window.location.origin);
const params = urlObj.searchParams;
//console.log(rule.params);
//for (const paramName in rule.params) {
for (var p = 0; p < rule.params.length; p++) {
var paramName = rule.params[p];
//console.log(paramName);
if (params.has(paramName)) {
const original = params.get(paramName);
const translateResultData =
await translate.network._translateText(original);
if (typeof translateResultData == "undefined") {
console.log("WARINNG: translateResultData is undefined");
} else if (typeof translateResultData.result == "undefined") {
console.log("WARINNG: translateResultData.result is undefined");
} else if (translateResultData.result != 1) {
console.log(
"WARINNG: translateResultData.result failure : " +
translateResultData.info,
);
} else {
params.set(
paramName,
decodeURIComponent(translateResultData.text[0]),
);
}
}
}
return urlObj.toString();
} catch (e) {
console.warn("GET处理失败:", e);
return url;
}
},
async handleForm(body, rule) {
try {
const params = new URLSearchParams(body);
const modified = { ...params };
for (const paramName of rule.params) {
if (params.has(paramName)) {
const original = params.get(paramName);
const translated =
await translate.network._translateText(original);
modified[paramName] = translated;
}
}
return new URLSearchParams(modified).toString();
} catch (e) {
console.warn("表单处理失败:", e);
return body;
}
},
async handleJson(body, rule) {
try {
const json = JSON.parse(body);
const modified = { ...json };
for (const paramName of rule.params) {
if (Object.hasOwn(modified, paramName)) {
const original = modified[paramName];
modified[paramName] =
await translate.network._translateText(original);
}
}
return JSON.stringify(modified);
} catch (e) {
console.warn("JSON处理失败:", e);
return body;
}
},
},
// 请求上下文管理
_requestContext: null,
// Hook open 方法
hookOpen(method, url, async, user, password) {
const matchedRule = null;
this._requestContext = {
method: method.toUpperCase(),
originalUrl: url,
async: async,
user: user,
password: password,
matchedRule: translate.network.getRuleMatch(url, method),
};
return translate.network.originalOpen.call(
this,
method,
url,
async,
user,
password,
);
},
// Hook send 方法
hookSend(body) {
const ctx = this._requestContext;
if (!ctx || !ctx.matchedRule) {
return translate.network.originalSend.call(this, body);
}
const processRequest = async () => {
let modifiedBody = body;
const method = ctx.method;
try {
// 处理GET请求
//if (method === 'GET') {
const newUrl = await translate.network.RequestHandler.handleGet(
ctx.originalUrl,
ctx.matchedRule,
);
translate.network.originalOpen.call(
this,
method,
newUrl,
ctx.async,
ctx.user,
ctx.password,
);
//}
// 恢复请求头
if (ctx.headers) {
for (const header in ctx.headers) {
translate.network.setRequestHeaderOriginal.call(
this,
header,
ctx.headers[header],
);
}
}
// 处理POST请求
if (method === "POST") {
if (
typeof body != "undefined" &&
body != null &&
body.length < 2000
) {
var isJsonBody = false; //是否是json格式的数据,是否json已经处理了, true 是
if (
body.trim().indexOf("[") == 0 ||
body.trim().indexOf("{") == 0
) {
//可能是json
try {
modifiedBody =
await translate.network.RequestHandler.handleJson(
body,
ctx.matchedRule,
);
isJsonBody = true;
} catch (je) {
isJsonBody = false;
}
}
if (!isJsonBody) {
try {
modifiedBody =
await translate.network.RequestHandler.handleForm(
body,
ctx.matchedRule,
);
} catch (je) {}
}
}
}
} catch (e) {
console.warn("请求处理异常:", e);
}
translate.network.originalSend.call(this, modifiedBody);
};
// 异步处理
if (ctx.async !== false) {
processRequest.call(this);
} else {
console.warn("同步请求不支持翻译拦截");
translate.network.originalSend.call(this, body);
}
},
//fetch请求
fetch: {
originalFetch: window.fetch,
// 保存原始 fetch 方法
use: function () {
window.fetch = (...args) => this.hookFetch.apply(this, args);
},
// 拦截 fetch 请求
hookFetch: async function (input, init) {
const request = new Request(input, init);
const url = request.url;
const method = request.method;
// 获取匹配规则
const rule = translate.network.getRuleMatch(url, method);
if (!rule) {
return this.originalFetch.call(window, request);
}
// 初始化请求上下文
const ctx = {
method,
url,
headers: {},
rule,
isModified: false,
};
// 保存请求头
request.headers.forEach((value, key) => {
ctx.headers[key] = value;
});
this._requestContext = ctx;
try {
const newUrl = await translate.network.RequestHandler.handleGet(
url,
rule,
);
// 处理 GET 请求
if (method === "GET") {
const newRequest = new Request(newUrl, {
method,
headers: new Headers(ctx.headers),
mode: request.mode,
credentials: request.credentials,
cache: request.cache,
redirect: request.redirect,
referrer: request.referrer,
referrerPolicy: request.referrerPolicy,
});
return this.originalFetch.call(window, newRequest);
}
// 处理 POST 请求
if (method === "POST") {
let body = null;
if (request.body) {
body = await request.clone().text();
}
const contentType = request.headers.get("Content-Type");
let modifiedBody = body;
if (
typeof body != "undefined" &&
body != null &&
body.length < 2000
) {
var isJsonBody = false; //是否是json格式的数据,是否json已经处理了, true 是
if (
body.trim().indexOf("[") == 0 ||
body.trim().indexOf("{") == 0
) {
//可能是json
try {
modifiedBody =
await translate.network.RequestHandler.handleJson(
body,
rule,
);
isJsonBody = true;
} catch (je) {
isJsonBody = false;
}
}
if (!isJsonBody) {
try {
modifiedBody =
await translate.network.RequestHandler.handleForm(
body,
rule,
);
} catch (je) {}
}
}
const newRequest = new Request(newUrl, {
method,
headers: new Headers(ctx.headers),
body: modifiedBody,
mode: request.mode,
credentials: request.credentials,
cache: request.cache,
redirect: request.redirect,
referrer: request.referrer,
referrerPolicy: request.referrerPolicy,
});
return this.originalFetch.call(window, newRequest);
}
// 其他方法直接返回原始请求
return this.originalFetch.call(window, request);
} catch (e) {
console.warn("fetch 请求处理异常:", e);
return this.originalFetch.call(window, request);
}
},
// 请求上下文管理
_requestContext: null,
},
},
/*js translate.network end*/
/*js translate.visual start*/
/*
人眼所看到的纯视觉层的处理
*/
visual: {
/**
* 获取一组节点的视觉矩形信息
* @param {Node[]} nodes - 节点数组,格式如
* [node1,node2,node3]
* @returns {Object[]} - 矩形信息数组,与输入节点一一对应
*/
getRects: (nodes) =>
nodes.map((node) => {
if (!node) return null;
let rect;
if (node.nodeType === Node.TEXT_NODE) {
const range = document.createRange();
range.selectNodeContents(node);
const rects = range.getClientRects();
//console.log(rect);
rect = rects.length > 0 ? rects[0] : null;
} else if (node.nodeType === Node.ELEMENT_NODE) {
rect = node.getBoundingClientRect();
}
return rect
? {
node,
left: rect.left,
top: rect.top,
right: rect.right,
bottom: rect.bottom,
width: rect.width,
height: rect.height,
}
: null;
}),
/*
对一组坐标进行排序
按开始坐标从左到右、从上到下排序
@param rects translate.visual.getRects获取到的坐标数据
*/
coordinateSort: (rects) => {
// 按从左到右、从上到下排序
const sortedRects = rects
.filter((rect) => rect !== null)
.sort((a, b) => {
if (Math.abs(a.top - b.top) < 5) {
// 同一行
return a.left - b.left;
}
return a.top - b.top;
});
return sortedRects;
},
/**
* 查找左右紧邻的矩形对
* @param rects translate.visual.getRects获取到的坐标数据
* @returns {Array<{before: Object, after: Object}>} - 左右紧邻的矩形对数组
*/
afterAdjacent: (rects) => {
var sortedRects = translate.visual.coordinateSort(rects);
const adjacentPairs = [];
const lineGroups = translate.visual.groupRectsByLine(sortedRects);
// 检查每行中的所有紧邻元素对
lineGroups.forEach((line) => {
for (let i = 0; i < line.length; i++) {
for (let j = i + 1; j < line.length; j++) {
const prev = line[i];
const next = line[j];
// 如果后续元素与当前元素不紧邻,则后续其他元素也不可能紧邻
if (!translate.visual.areHorizontallyAdjacent(prev, next)) {
break;
}
adjacentPairs.push({ before: prev, after: next });
}
}
});
return adjacentPairs;
},
/**
* 按行分组矩形
* @param rects - 排序后的矩形数组 @param rects translate.visual.coordinateSort 获取到的坐标数据
* @returns {Object[][]} - 按行分组的矩形
*/
groupRectsByLine: (rects) => {
const lineGroups = [];
let currentLine = [];
rects.forEach((rect) => {
if (currentLine.length === 0) {
currentLine.push(rect);
} else {
const lastRect = currentLine[currentLine.length - 1];
// 如果在同一行,则添加到当前行
if (Math.abs(rect.top - lastRect.top) < 5) {
currentLine.push(rect);
} else {
// 否则开始新的一行
lineGroups.push(currentLine);
currentLine = [rect];
}
}
});
// 添加最后一行
if (currentLine.length > 0) {
lineGroups.push(currentLine);
}
return lineGroups;
},
/**
* 判断两个矩形是否水平紧邻
* @param {Object} rect1 - 第一个矩形
* @param {Object} rect2 - 第二个矩形
* @returns {boolean} - 是否水平紧邻
*/
areHorizontallyAdjacent: (rect1, rect2) => {
// 检查垂直方向是否有重叠(在同一行)
const verticalOverlap =
Math.min(rect1.bottom, rect2.bottom) - Math.max(rect1.top, rect2.top);
// 检查水平间距是否在阈值范围内
const horizontalGap = rect2.left - rect1.right;
return verticalOverlap > 0 && Math.abs(horizontalGap) < 1; // 允许1px误差
},
/**
* 找到需要在节点文本末尾添加空格的节点
* @param {Array<{before: Object, after: Object}>} adjacentPairs - 左右紧邻的矩形对数组
* @returns {Node[]} - 需要添加空格的节点数组
*/
afterAddSpace: (adjacentPairs) => {
const nodesToAddSpace = [];
adjacentPairs.forEach((pair) => {
const { before, after } = pair;
const beforeNode = before.node;
const afterNode = after.node;
// 获取计算样式
const beforeStyle = window.getComputedStyle(
beforeNode.nodeType === Node.TEXT_NODE
? beforeNode.parentElement
: beforeNode,
);
const afterStyle = window.getComputedStyle(
afterNode.nodeType === Node.TEXT_NODE
? afterNode.parentElement
: afterNode,
);
// 检查间距是否由CSS属性引起
const hasRightSpacing =
Number.parseFloat(beforeStyle.marginRight) > 0 ||
Number.parseFloat(beforeStyle.paddingRight) > 0;
const hasLeftSpacing =
Number.parseFloat(afterStyle.marginLeft) > 0 ||
Number.parseFloat(afterStyle.paddingLeft) > 0;
// 如果没有明确的间距,且后一个节点的开始非空白符,则需要添加空格
if (!hasRightSpacing && !hasLeftSpacing) {
//判断 before 节点的最后一个字符是否是空白符
if (
typeof beforeNode.textContent == "string" &&
typeof afterNode.textContent == "string"
) {
if (/\s$/.test(beforeNode.textContent)) {
//before 最后一个字符是空格,则不需要追加空格符了
} else if (/^\s/.test(afterNode.textContent)) {
//after 节点的开始第一个字符是空白符,那么也不需要追加空格符了
} else {
//这里就需要对 beforeNode 追加空格了
nodesToAddSpace.push(beforeNode);
}
}
}
});
return nodesToAddSpace;
},
/**
* 主函数:处理翻译后的空格调整
* @param {Node[]} nodes - 节点数组
*/
adjustTranslationSpaces: (nodes) => {
//先判断当前要显示的语种,是否需要用空格进行间隔单词,如果本身不需要空格间隔,像是中文,那就根本不需要去计算视觉距离
if (!translate.language.wordBlankConnector(translate.to)) {
return;
}
//var startTime = Date.now();
// 1. 获取节点视觉矩形
const rects = translate.visual.getRects(nodes);
//console.log('rects:');
//console.log(rects);
// 2. 查找左右紧邻的矩形对
const adjacentPairs = translate.visual.afterAdjacent(rects);
//console.log('adjacentPairs:');
//console.log(adjacentPairs);
// 3. 确定需要添加空格的节点
const nodesToAddSpace = translate.visual.afterAddSpace(adjacentPairs);
//console.log('nodesToAddSpace:');
//console.log(nodesToAddSpace);
// 4. 添加非断行空格
nodesToAddSpace.forEach((node) => {
// 确保只修改文本内容,不影响HTML结构
if (node.nodeType === Node.TEXT_NODE) {
node.textContent = node.textContent + "\u00A0";
} else if (node.nodeType === Node.ELEMENT_NODE) {
// 如果是元素节点,修改其最后一个子节点(假设是文本节点)
const lastChild = node.lastChild;
if (lastChild && lastChild.nodeType === Node.TEXT_NODE) {
lastChild.textContent = lastChild.textContent + "\u00A0";
}
}
});
//var endTime = Date.now();
//console.log('visual recognition time: '+(endTime-startTime)+'ms');
},
/*
通过 translate.nodeQueue[uuid] 中的uuid,来传入这个 translate.nodeQueue[uuid] 中所包含涉及到的所有node (除特殊字符外 ,也就是 translate.nodeQueue[uuid].list 下 特殊字符那一类是不会使用的)
*/
adjustTranslationSpacesByNodequeueUuid: (uuid) => {
var nodes = [];
for (var from in translate.nodeQueue[uuid].list) {
if (!Object.hasOwn(translate.nodeQueue[uuid].list, from)) {
continue;
}
if (from.length < 1) {
continue;
}
for (var hash in translate.nodeQueue[uuid].list[from]) {
if (!Object.hasOwn(translate.nodeQueue[uuid].list[from], hash)) {
continue;
}
for (var nodeindex in translate.nodeQueue[uuid].list[from][hash]
.nodes) {
if (
!Object.hasOwn(
translate.nodeQueue[uuid].list[from][hash].nodes,
nodeindex,
)
) {
continue;
}
var node =
translate.nodeQueue[uuid].list[from][hash].nodes[nodeindex].node;
nodes.push(node);
}
}
}
translate.visual.adjustTranslationSpaces(nodes);
},
/*
通过 translate.nodeQueue 中最后一次执行的 uuid,来获取这个 translate.nodeQueue[uuid] 中所包含涉及到的所有node (除特殊字符外 ,也就是 translate.nodeQueue[uuid].list 下 特殊字符那一类是不会使用的)
*/
adjustTranslationSpacesByLastNodequeueUuid: (uuid) => {
var uuid = "";
for (var uuid_index in translate.nodeQueue) {
uuid = uuid_index;
break;
}
if (typeof uuid == "string" && uuid.length > 1) {
translate.visual.adjustTranslationSpacesByNodequeueUuid(uuid);
}
},
},
/*js translate.visual end*/
};
/*
将页面中的所有node节点,生成其在当前页面的唯一标识字符串uuid
开源仓库: https://github.com/xnx3/nodeuuid.js
原理: 当前节点的nodeName + 当前节点在父节点下,属于第几个 tagName ,然后追个向父级进行取,将node本身+父级+父父级+.... 拼接在一起
注意,如果动态添加一个节点到第一个,那么其他节点就会挤下去导致节点标记异常
*/
var nodeuuid = {
index: (node) => {
var parent = node.parentElement;
if (parent == null) {
return "";
}
var childs;
if (typeof node.tagName == "undefined") {
//console.log('undefi');
childs = parent.childNodes;
//console.log(Array.prototype.indexOf.call(childs, node));
} else {
// 使用querySelectorAll()方法获取所有与node元素相同标签名的子节点
//childs = parent.querySelectorAll(node.tagName);
// 不使用querySelectorAll,手动遍历子节点来找到相同标签名的子节点
childs = [];
var allChilds = parent.childNodes;
for (var i = 0; i < allChilds.length; i++) {
if (allChilds[i].tagName === node.tagName) {
childs.push(allChilds[i]);
}
}
}
var index = Array.prototype.indexOf.call(childs, node);
//console.log('--------'+node.tagName);
return node.nodeName + "" + (index + 1);
},
uuid: (node) => {
var uuid = "";
var n = node;
while (n != null) {
var id = nodeuuid.index(n);
//console.log(id);
if (id != "") {
if (uuid != "") {
uuid = "_" + uuid;
}
uuid = id + uuid;
}
//console.log(uuid)
n = n.parentElement;
}
return uuid;
},
};
/*js copyright-notice start*/
console.log(
"------ translate.js ------\nTwo lines of js html automatic translation, page without change, no language configuration file, no API Key, SEO friendly! Open warehouse : https://github.com/xnx3/translate \n两行js实现html全自动翻译。 无需改动页面、无语言配置文件、无API Key、对SEO友好!完全开源,代码仓库:https://gitee.com/mail_osc/translate",
);
/*js copyright-notice end*/
/*js amd-cmd-commonjs start*/
/*兼容 AMD、CMD、CommonJS 规范 - start*/
/**
* 兼容 AMD、CMD、CommonJS 规范
* node 环境使用:`npm i i18n-jsautotranslate` 安装包
*/
((root, factory) => {
if (typeof define === "function" && define.amd) {
define([], () => factory());
} else if (typeof module === "object" && module.exports) {
module.exports = factory();
} else {
root["translate"] = factory();
}
})(this, () => translate);
/*兼容 AMD、CMD、CommonJS 规范 - end*/
/*js amd-cmd-commonjs end*/