油猴脚本实战:手把手教你打造稳定显示的网页翻译工具(基于DeepL API)

自动翻译工具·油猴脚本 这是一个Tampermonkey用户脚本,用于创建稳定显示的网页翻译工具。主要功能包括: 提供固定位置的翻译按钮(右下角) 支持三种翻译模式: 一键翻译全页 矩形区域选择翻译 不规则区域选择翻译 可恢复原文显示 使用DeepL和Google翻译API进行翻译 自动检测并跳过已翻译内容 该脚本通过强制样式和高优先级确保翻译按钮始终可见,不受页面样式影响。采用渐进式翻译策略,控制请求频率避免被封禁,并提供翻译完成通知。 阅读详情

油猴脚本实战:从零构建一个永不消失的网页翻译工具

不知道你有没有遇到过这种情况:辛辛苦苦写了个浏览器脚本,功能都实现了,但那个小小的翻译按钮却总是不听话——有时候被页面元素盖住,有时候样式冲突直接消失,有时候甚至整个UI都渲染不出来。用户反馈最多的问题往往不是“翻译不准”,而是“按钮去哪了?”。这种体验上的瑕疵,对于追求极致的产品来说,是致命的。

今天,我们不谈那些基础的API调用,也不重复那些随处可见的教程。我想和你深入聊聊,如何从架构层面设计一个真正稳定、永不消失的网页翻译工具。我们将以油猴脚本为载体,但思路适用于任何浏览器扩展或用户脚本开发。核心目标只有一个:无论页面如何复杂、样式如何冲突、DOM如何动态变化,我们的翻译工具UI必须始终可见、始终可用。

这不仅仅是加几个!important那么简单。它涉及到CSS层叠上下文的深度理解、DOM节点监控的防御性编程、事件流控制的精细管理,以及面对各种极端情况的优雅降级策略。我们将从最棘手的“z-index战争”开始,一步步构建一个坚如磐石的解决方案。

1. 理解“消失”的根源:为什么你的按钮总被覆盖?

在开始写代码之前,我们必须先搞清楚敌人是谁。一个元素在网页上“消失”或被覆盖,通常逃不出下面几种情况。只有精准诊断,才能对症下药。

1.1 CSS层叠顺序与z-index的陷阱

很多开发者第一反应是给按钮设置一个巨大的z-index,比如999999。这在一定程度上有用,但绝非万能。CSS的层叠顺序是一个复杂的规则体系:

层叠上下文(Stacking Context)内的渲染顺序(从底到顶):
1. 形成层叠上下文的元素的背景和边框
2. z-index为负的子层叠上下文
3. 块级盒子(block-level boxes)
4. 浮动盒子(float boxes)
5. 内联盒子(inline boxes)
6. z-index为0或auto的子层叠上下文
7. z-index为正的子层叠上下文

关键在于,z-index只在同一个层叠上下文内比较才有效。如果页面上的某个弹窗、某个全屏广告自己创建了一个新的层叠上下文,并且它的z-index也很大,那么你的按钮即便设置了2147483647(z-index的最大值),如果处于不同的上下文,依然可能被覆盖。

更棘手的是,一些页面会使用transform、opacity小于1、filter等属性,这些属性都会隐式地创建一个新的层叠上下文,把你的元素“关”在里面。

实战诊断技巧:打开浏览器开发者工具,选中你的按钮元素,查看“Computed”样式。如果看到isolation: isolate、transform、opacity等属性,或者其某个祖先元素的z-index不是auto,那么它很可能已经身处一个孤立的层叠上下文中了。

1.2 动态DOM与脚本冲突

现代网页大量使用JavaScript动态操作DOM。你的脚本可能在页面加载初期成功注入了按钮,但随后:

  1. 单页应用(SPA)路由切换:整个<body>内容被替换,你的按钮随之消失。
  2. 懒加载与异步渲染:页面主体内容后加载,其自带的样式表可能覆盖你的样式。
  3. 其他脚本的恶意竞争:某些广告拦截脚本或页面自身的脚本可能会选择性地移除带有特定id或class的元素。

1.3 样式污染与CSS重置

许多网站会使用* { box-sizing: border-box; }这样的全局重置,或者更激进地,使用!important来确保自己的样式优先级。如果你的样式特异性(Specificity)不够高,或者没有使用!important,就很容易被覆盖。例如,页面可能有一条规则:

div[class*="btn"], button {
    display: none !important; /* 隐藏所有疑似按钮的元素 */
}

如果你的按钮恰好是个<div>,那就中招了。

注意:滥用!important是CSS中的“核选项”,它会破坏样式表的可维护性。但在用户脚本这种“入侵式”的开发场景中,为了确保功能的绝对可用性,我们有时不得不使用它。关键在于精准和节制。

2. 构建坚不可摧的UI容器系统

知道了问题所在,我们就可以设计防御体系了。我们的核心策略是:创建一个独立于页面主文档流的、最高优先级的UI容器,并建立一套持续的“健康检查”机制。

2.1 创建绝对独立的根容器

我们不能简单地把按钮挂在document.body末尾。我们需要一个更靠前、更独立的位置。

function createUnbreakableRoot() {
    // 先检查是否已存在,避免重复创建
    let root = document.getElementById('translator-root-ultimate');
    if (root) return root;

    root = document.createElement('div');
    root.id = 'translator-root-ultimate';

    // 关键策略1:插入到body的最前面
    // 这能确保我们的容器在DOM树中顺序靠前,减少被后续动态内容样式覆盖的风险
    if (document.body.firstChild) {
        document.body.insertBefore(root, document.body.firstChild);
    } else {
        document.body.appendChild(root);
    }

    // 关键策略2:为根容器创建最强的层叠上下文
    // 使用‘isolation: isolate’显式创建新上下文,并赋予最大z-index
    root.style.cssText = `
        position: fixed !important;
        top: 0 !important;
        left: 0 !important;
        width: 0 !important;
        height: 0 !important;
        pointer-events: none !important; /* 容器本身不拦截事件 */
        z-index: 2147483647 !important; /* 32位有符号整数最大值 */
        isolation: isolate !important; /* 创建独立的层叠上下文 */
    `;

    return root;
}

这个根容器本身不可见、不占空间,但它创建了一个位于最顶层的、独立的层叠上下文。我们所有实际的UI元素(按钮、菜单)都将作为这个容器的子元素,从而继承其极高的z-index和独立的上下文环境。

2.2 设计防御性样式表

接下来,我们为UI元素注入样式。这里的原则是:特异性最大化,覆盖所有可能被重置的属性,并预留逃生通道。

function injectDefensiveStyles() {
    const styleId = 'translator-atomic-styles';
    if (document.getElementById(styleId)) return;

    const style = document.createElement('style');
    style.id = styleId;
    style.textContent = `
        /* 针对根容器内的所有元素,使用属性选择器提高特异性 */
        #translator-root-ultimate > * {
            all: initial !important; /* 核弹级重置,慎用但有效 */
            pointer-events: auto !important; /* 恢复子元素的事件接收 */
        }

        /* 主按钮 - 使用多重选择器增加特异性 */
        #translator-root-ultimate #translator-float-btn,
        div#translator-root-ultimate div#translator-float-btn {
            position: fixed !important;
            bottom: 24px !important;
            right: 24px !important;
            width: 56px !important;
            height: 56px !important;
            background-color: #3b82f6 !important; /* 现代蓝色 */
            color: white !important;
            border-radius: 50% !important;
            display: flex !important;
            align-items: center !important;
            justify-content: center !important;
            cursor: pointer !important;
            box-shadow: 0 6px 20px rgba(59, 130, 246, 0.4) !important;
            font-size: 24px !important;
            font-family: -apple-system, BlinkMacSystemFont, sans-serif !important;
            border: none !important;
            padding: 0 !important;
            margin: 0 !important;
            opacity: 1 !important;
            visibility: visible !important;
            transition: transform 0.2s ease, box-shadow 0.2s ease !important;
            z-index: 2147483647 !important; /* 继承并确认 */
            outline: 2px solid transparent !important; /* 为焦点状态准备 */
            outline-offset: 2px !important;
        }

        /* 悬浮和焦点状态 */
        #translator-root-ultimate #translator-float-btn:hover,
        #translator-root-ultimate #translator-float-btn:focus-visible {
            transform: scale(1.08) !important;
            box-shadow: 0 8px 25px rgba(59, 130, 246, 0.6) !important;
            outline-color: #93c5fd !important;
        }

        /* 菜单面板 - 使用子代选择器确保只影响目标 */
        #translator-root-ultimate #translator-control-panel {
            position: absolute !important;
            bottom: calc(100% + 12px) !important; /* 紧贴按钮上方 */
            right: 0 !important;
            background: white !important;
            border-radius: 12px !important;
            box-shadow: 0 10px 30px rgba(0, 0, 0, 0.15) !important;
            padding: 8px !important;
            min-width: 180px !important;
            border: 1px solid #e5e7eb !important;
            display: none !important; /* 默认隐藏 */
            z-index: 2147483647 !important;
            backdrop-filter: blur(10px) !important; /* 毛玻璃效果,增强视觉层级 */
        }

        /* 菜单项 */
        #translator-root-ultimate .translator-menu-option {
            all: initial !important; /* 每个菜单项也独立重置 */
            display: block !important;
            width: 100% !important;
            padding: 12px 16px !important;
            text-align: left !important;
            background: transparent !important;
            border: none !important;
            cursor: pointer !important;
            font-family: -apple-system, BlinkMacSystemFont, sans-serif !important;
            font-size: 14px !important;
            color: #374151 !important;
            border-radius: 8px !important;
            box-sizing: border-box !important;
            transition: background-color 0.15s ease !important;
        }

        #translator-root-ultimate .translator-menu-option:hover {
            background-color: #f3f4f6 !important;
        }

        /* 高亮危险操作(如重置) */
        #translator-root-ultimate .translator-menu-option.danger {
            color: #dc2626 !important;
        }
    `;

    // 将样式表插入到head的最前面,尽可能早地生效
    document.head.insertBefore(style, document.head.firstChild);
}

这份样式表有几个关键点:

  1. all: initial的谨慎使用:它在某些极端情况下能彻底清除继承或页面定义的样式,但会影响子元素,所以我们只用在最需要的地方。
  2. 多重选择器:像#translator-root-ultimate #translator-float-btn这样的选择器,具有非常高的特异性(ID + ID),很难被页面普通样式覆盖。
  3. 显式定义所有视觉属性:包括字体、边框、阴影等,不留任何可能被继承的缺口。
  4. backdrop-filter:为菜单添加毛玻璃效果,这不仅是美观,其本身也会创建新的层叠上下文,进一步巩固我们的层级优势。

2.3 实现持续性健康检查与自我修复

这是保证“永不消失”的核心逻辑。我们需要一个守护进程,定期检查UI状态,并在发现问题时自动修复。

class UIGuardian {
    constructor(checkInterval = 1500) {
        this.rootId = 'translator-root-ultimate';
        this.buttonId = 'translator-float-btn';
        this.panelId = 'translator-control-panel';
        this.checkInterval = checkInterval;
        this.observer = null;
        this.healthCheckTimer = null;
  
告别翻译插件!这个油猴脚本让你的网页翻译更稳定(附完整配置指南) 本文提供了一种告别传统翻译插件的解决方案,通过使用油猴脚本管理器(如Tampermonkey)和自定义用户脚本,打造更稳定、更自由的网页翻译工具。文章详细介绍了从脚本安装、核心代码编写到高级功能(如区域选择、多API备用、UI守护进程)的完整配置指南,帮助用户实现精准、可控的网页翻译体验。 阅读详情

相关推荐

油猴脚本·网页翻译工具开发实战

本文详细介绍了如何利用油猴脚本开发一个高度定制化的网页翻译工具。通过原生JavaScript与GM API,实现了矩形区域选择、自由框选、一键全页翻译及状态持久化等核心功能,解决了浏览器自带翻译功能不灵活、质量不佳的痛点。文章提供了从脚本骨架搭建、UI设计、文本捕获到集成DeepL/Google翻译API的完整实战代码与思路,适合前端开发者学习浏览器扩展开发与自动化工具构建。

weixin_29205061的博客 326

浏览器翻译神器:用Tampermonkey+油猴脚本实现区域选择翻译(附完整代码)

本文详细介绍了如何利用Tampermonkey(油猴)脚本管理器,创建一个强大的浏览器区域选择翻译工具。该工具突破传统整页或划词翻译的限制,允许用户自由圈选网页任意区域(矩形或不规则形状)进行精准翻译,并支持自定义翻译引擎和UI,实现高度定制化的自动化翻译体验。

yog99的博客 1212

翻译脚本(包含:金山、有道、谷歌、沪江等)

本翻译脚本调用“金山词霸、有道词典(有道翻译)、Google Translate(谷歌翻译)、沪江小D、搜狗翻译、必应词典(必应翻译)、Microsoft Translator(必应在线翻译)、海词词典、百度翻译、Oxford Learner's Dictionaries、Oxford Dictionaries、Merriam-Webster、PDF 划词翻译”等网页翻译。 支持浏览器:Google Chrome、Firefox、Safari、Firefox for Android(无拖动) 支持发音 支持面板拖动

SPMI、PMBus、AVSBus:三大电源管理总线对比与选型指南

在现代电子系统中,电源管理是确保高性能与低功耗平衡的核心技术。其原理在于通过数字通信协议,实现电源管理单元(PMIC)与用电芯片间的精准“对话”,从而动态调整供电。这项技术的核心价值在于提升系统能效、增强可靠性并简化设计。其应用场景广泛,从智能手机、服务器到汽车电子无处不在。具体实现上,衍生出了三大主流协议:为移动嵌入式高度集成的SPMI总线、专注于工业标准监控的PMBus总线,以及追求极致实时能效的AVSBus总线。理解SPMI在复杂时序控制与PMBus在标准化配置方面的异同,是进行电源架构选型与调试的关

ithome 470

基因家族Motif 分析

MEME

hgz2020的博客 6333

U8二次开发CO-基于Net8调用COM对象

本文章介绍的U8二次开发CO技术,就是基于微软COM组件技术,使用微软开源的编程框架Net6/7/8/9来调用U8的COM组件,完成基本的登录认证,工作流处理,数据库操作等。

pccai的博客 5517

ChatGPT设置密钥后Codex免手机验证:配置顺序与身份凭证复用机制

API Key 是一种用于身份识别的凭证,其核心原理是通过预配置的密钥替代交互式登录流程。在开发工具中,密钥认证优先级通常高于会话认证,当本地存在有效密钥时,工具会直接复用该凭证,从而减少重复验证环节。这种机制的技术价值在于提升开发效率与配置一致性,尤其适用于多设备切换、CI/CD 流水线及编程辅助工具等场景。以 Codex 为例,在 ChatGPT 界面提前配置 API 密钥后,Codex 启动时可读取持久化存储的密钥,避免触发手机号验证,实现身份凭证的跨入口复用。

weixin_33940469的博客 526

(八)基于MuJoCo的LeRobot SO100仿真操控实战指南(操作优化)

本文详细介绍了如何在MuJoCo仿真环境中搭建并优化LeRobot SO100机械臂的操控。通过两种核心模式(纯键盘仿真与实机镜像同步)的实战演示,重点讲解了关键的参数标定方法,以实现虚拟模型与真实硬件的精准同步。文章还提供了性能优化技巧,旨在帮助开发者构建高效、安全的机器人算法开发与测试流程。

weixin_29083649的博客 321

Claude Code Auto Memory 的 Storage Location,SAP ABAP 项目里的本地记忆仓库应该怎么理解

本文介绍了 SAP ABAP 项目中 Claude Code 的 auto memory 机制,重点探讨了其存储位置的设计原理。auto memory 不是存储在项目目录中,而是默认位于 ~/.claude/projects/<project>/memory/,其中 <project> 基于 Git 仓库路径推导,确保同一仓库下的所有工作目录和分支共享记忆。记忆目录包含入口文件 MEMORY.md(仅加载前 200 行)和详细主题文件,这种分层设计类似 CDS View 架构思想。文章还分析了按 Git 仓

2007 年 ~ 2025 年,深耕 SAP 技术 18 年 105

Autosar诊断实战系列07-Dcm之0x19 06扩展数据配置及工程问题讨论

19 06扩展数据如何配置?如果某DTC没有出现过故障扩展数据该如何响应?

initiallizer的博客 1705

Challenge 5 - OSCP B

jdwp可以执行命令,但是这个脚本需要python2来运行,靶机上没有,那么我们只能将8000端口代理出来了,我这里代理到我本地的7800端口上。访问8080端口显 hostname,我们通过nmap可以看到hostname为ms01.oscp.exam,修改/etc/hosts。试了下impacket-smbexec没有成功, 不过他开放了22端口,我们可以ssh登录web_svc用户。得到下面的结果,root用户运行了一个貌似是debug的进程。nmap扫描发现了一个可以的端口8021。

羽的博客 4969

VB摄像头监控

该VB模块可对摄像头捕获的画面进行录像等,可在创建的窗口进行控制

怀旧版电脑GBC模拟器

再现原版GBC掌机的界面,电脑运行连游戏界面都一样大小,很怀旧,很真实,(英文版)强烈推荐,很小的文件,很难才找到的。

jdk-8u144-linux-x64.tar.gz.

该资源为搭建Linux系统Java环境用,资源的后缀为tar.gz格式的压缩包

LinePhone3.2.7(android端最新版本) sip客户端

SIP客户端For android:LinePhone3.2.7(最新版本),官网地址:http://www.linphone.org/

上一篇: Windows系统下OpenCV摄像头调用终极指南:从GUID解析到多摄像头控制
下一篇: ZPL宏编程实战:从自动化脚本到定制化分析工具
zhuyuhe666
博客等级 码龄10年 45粉丝 1598原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符  | 博主筛选后可见
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值
⌂ 换网址