多站点

把多个站点合并到一个应用,可选择布局。

适用场景

链接枢纽、门户和应用合集 —— 想把多个站点放在一个屋檐下。

核心配置

由 MultiWebConfig 和一个 MultiWebSite 条目列表支撑。

站点

每个站点条目有:

• 名称与 URL —— 站点的标签和地址。
• 类型 —— URL、LOCAL、INLINE_HTML 或 EXISTING(复用另一个应用/项目)。
• 图标 —— emoji 图标或 favicon URL。
• 主题色 —— 按站点的强调色。
• 分类 —— 在应用内对站点分组。
• 选择器 —— 用于内容提取的 CSS 选择器(cssSelector)和链接选择器(linkSelector)。
• 启用与排序 —— 开关站点并设置排序索引。
• 按站点配置 —— 站点可携带自己的 webViewConfig 或 htmlConfig。数据模型也有服务端运行时的配置槽位,但被标为服务端运行时类型的站点无法嵌入 —— 见下文说明。

布局与显示

• 显示模式(displayMode)—— 在编辑器里选择。底部标签(TABS,新建应用的默认值)、顶部标签(TOP_TABS)、卡片主页(CARDS)、侧边抽屉(DRAWER)或信息流(FEED)。
• 顶部标签 —— 标签在状态栏下方。选中的站点有一个小圆点。左右滑动会跟着手指走,松手后滑到相邻站点。一次手势只停在当前页或下一页;到头时页面会回弹。底部标签、卡片、抽屉和信息流仍是一次切一页。栏背景先取当前页顶部的实时采样,再回退到站点主题色。首屏绘制后会再采一次,所以第一屏不会停在浅色回退上。显示站点图标在这里同样生效。GeckoView 拿不到采样,栏就用主题色。被挡住的 Gecko 标签会收起,切回去时显示的是该标签自己的页面,而不是最新一帧。
• 卡片主页和抽屉 —— 卡片主页 1–4 列(cardColumns,默认 2)。侧边抽屉 1–3 列(drawerColumns,默认 1)。列越多,整张卡片越小。高度滑杆可以再把它缩短(cardAspectRatio,默认 1.2)。旧配置没有这些字段时保持原来的布局。抽屉顶栏可以按显示名、主机或完整网址过滤。星标只收藏、不打开。收藏的站点在列表上方单独成组。星标和上次打开的站点一起留在这台设备上,不写入编辑器配置。
• 站点顺序 —— 在站点列表里长按握把拖动。顺序随应用保存,并写入导出配置,生成的应用用同一顺序。
• 启动时打开的标签(startTab)—— 上次打开(LAST,默认)或指定站点(SITE 加 startSiteId)。指定的站点被删掉或关掉时,回退到第一个站点。卡片主页在指定了站点时会跳过网格。信息流没有当前标签,所以那里不显示这个选项。
• 显示站点图标(showSiteIcons)。

刷新

• 刷新间隔(refreshInterval)—— 自动刷新之间的秒数。

共享注入

• 跨所有站点应用的公共 JS/CSS。

说明

• 每个站点仍是一个网页目标,因此按应用的网络和隐私选项作用于整个多站点应用。
• 画廊/单图/单视频站点的媒体会在导出时嵌入、运行时解析,正常渲染而不会黑屏。
• 服务端运行时应用(Node.js / PHP / Python / Go / WordPress)无法作为站点嵌入 —— 它们的运行时不会打进多网站 APK。站点选择器会隐藏它们,仍有此类引用的旧配置会在导出时回退为站点 URL。
• 单个站点请改用网页。