网页

把远程 URL 套进 WebView。这是最常见、也是配置最丰富的应用类型。

适用场景

已经有一个 URL 的落地页、工具、仪表盘、文档和内部系统。

核心配置

网页类型的核心配置是 WebView 行为(由 WebViewConfig 支撑)。

目标与引擎

• 目标 URL —— 要加载的站点。
• 浏览器引擎 —— 默认系统 WebView;可选 GeckoView(构建前先在浏览器内核下载,ECH 必需)。见浏览器内核。

User-Agent 与显示

• User-Agent 模式 —— 系统默认或自定义 UA 字符串(userAgentMode、customUserAgent)。
• 桌面模式 —— 请求桌面版站点(desktopMode)。
• 缩放与视口 —— 启用缩放、初始缩放和视口模式。

注入

• JS/CSS 注入 —— 在 document-start、document-end 或 idle 注入脚本/样式(injectScripts)。查看代码会打开内置编辑器,包括以文件保存的油猴脚本。在编辑器里保存会更新草稿。不保存就离开脚本对话框时,已存储的脚本保持原样。

弹窗与窗口

• 新窗口行为 —— 弹窗/新窗口如何打开(newWindowBehavior:同窗口、外部浏览器、弹窗)。
• 弹窗拦截 —— 拦截弹窗(popupBlockerEnabled)。
• JS 可打开窗口 —— 带策略(javaScriptCanOpenWindows、jsOpenWindowsPolicy)。

说明

• 网页编辑器在单一界面中暴露 完整 的能力卡片(全屏、启动画面、去广告、DNS、伪装等)—— 网页应用有一个合并的编辑器,而非拆分的核心/通用配置。
• 多个站点合并到一个应用,用多站点。
• 把网站归档为离线使用,用离线包。
• 系统 WebView 会把 <video> 留在页面写明的长度里,单位可以是 px、rem、em、vw 或 vh,写在视频上或它的上层元素上都可以。已经符合这个盒子的播放器,以及按百分比铺满的播放器,保持原样。Gecko 本身会遵守页面的 CSS。
• Godot 网页导出会在系统 WebView 里启动。只有 User-Agent 里同时有 Chrome 时才去掉 Version/4.0,这样引擎不会被当成 Safari 4。真正的 Safari 版本号会保留。