fix(console): 修「全屏时反而画标题栏」——窗口模式必须与 URL 的 windowed 一致

用户实机反馈:单屏窗口化窗口按 F11 全屏后标题栏不消失,退回窗口化反而没标题栏,
表现与预期完全相反。

根因不在标题栏,而在 Console 侧的窗口模式管理:entry 没记录窗口是以什么模式建的,
layout() 每次排布都拿「整机是否单屏」的 single 去覆盖每个已存在窗口的几何与模式
(!single 时会 win.setKiosk(true) + 铺满),而页面 URL 里的 windowed=1 是建窗时定死的、
loadPage 只在页码变化时才重载 —— 于是窗口的真实模式与页面认知脱钩:
窗口化窗口被改成 kiosk 全屏而 URL 仍带 windowed=1(全屏却画标题栏),反向亦然。

修复:建立并保证「窗口几何/模式 ↔ URL 的 windowed 必须永远一致」
- entry 记 { win, page, single, manual, reloadTimer }
- createWindow(..., manual=false);openOn() 传 manual=true(手动开的窗口不被排布改模式)
- layout() 的 existing 分支:target = manual ? entry.single : single,applyGeometry 与
  loadPage 都用同一个 target,且 modeChanged || page 变了都要重载 URL
- 删掉 isKioskWindow()(用 isFullScreen() 反推会把「窗口化窗口被 F11 全屏」误报成 kiosk),
  换成 modeOf(entry)
- F11 通信时序:enter/leave-full-screen 回调里不再回读 win.isFullScreen()(切换瞬间可能读到
  旧值,页面会收到相反状态),改为下发事件本身的确定值;F11 直接下发算出来的 next

回归测试 console/main/displays.test.js(8 例,assertModeConsistent 四处自洽)。
反向对照:修复前的 displays.js 跑同一份测试是 1 pass / 7 fail。
Console 语法检查 18 个文件、node --test 28 例全过。
This commit is contained in:
AskaEth committed 2026-09-11 00:13:09 +08:00
1 parent 5ae49b001c
commit 793d2ac064
3 files changed
+381 -25

No files matched your search

+44 -25
View File
@@ -22,7 +22,9 @@ class DisplayManager {
this.enabled = false
this.single = true
this.boundSingle = null
this.windows = new Map() // displayId -> { win, page, reloadTimer }
// entry.single 记这个窗口是以哪种模式建的(true=窗口化,false=kiosk),
// entry.manual 记它是管理面板手动开的(不跟随自动排布改模式)
this.windows = new Map() // displayId -> { win, page, single, manual, reloadTimer }
this.screenListeners = []
this.layoutTimer = null
}
@@ -102,10 +104,17 @@ class DisplayManager {
// 窗口可能被外部关闭/崩溃销毁而没走 destroyEntry,这里当作不存在重建,
// 否则 applyGeometry/loadPage 对 destroyed 窗口静默 return,现场只剩余黑屏
if (existing && existing.win && !existing.win.isDestroyed()) {
this.applyGeometry(existing.win, display, single)
if (existing.page !== page) {
// 手动开的窗口保持建窗时定的模式,自动排布只负责摆位置;
// 排布自己开的窗口跟随本次排布(电视拔了就该变回窗口化)
const target = existing.manual ? existing.single : single
const modeChanged = target !== existing.single
existing.single = target
this.applyGeometry(existing.win, display, target)
// 模式变了必须连 URL 一起换:URL 里的 windowed 是页面对「要不要画标题栏」的全部认知,
// 只改几何不重载,页面就会带着旧参数画(全屏仍画标题栏、窗口化却空着一条)
if (modeChanged || existing.page !== page) {
existing.page = page
this.loadPage(existing, display, page, single)
this.loadPage(existing, display, page, target)
}
return
}
@@ -119,7 +128,7 @@ class DisplayManager {
this.log.push('console', `大屏排布完成:${single ? '单屏窗口化' : `多屏 kiosk × ${displays.length}`},显示器 ${displays.map((d) => d.id).join(', ')}`)
}
createWindow(display, index, single, page) {
createWindow(display, index, single, page, manual = false) {
const bounds = display.bounds
const win = new BrowserWindow({
...this.geometryFor(display, single),
@@ -149,26 +158,32 @@ class DisplayManager {
win.setIgnoreMouseEvents(true)
}
// 窗口级全屏只在主进程可见:页面拿不到 setFullScreen 的结果,标题栏也就不会让位。
// 负载优先用调用方给的确定值——在回调里回读 win.isFullScreen() 会读到切换瞬间的旧值
// (Windows 上尤其),页面就会收到相反的状态、把标题栏画反。只有加载完成那次窗口
// 状态已经稳定,才回落到「读一次」。
const notifyFullscreen = (fullscreen) => {
if (win.isDestroyed()) return
win.webContents.send('window:fullscreen-changed', fullscreen === undefined ? win.isFullScreen() : fullscreen === true)
}
// F11 只在单屏模式下有意义(现场调试用),多屏 kiosk 不允许切走
if (single) {
win.webContents.on('before-input-event', (event, input) => {
if (input.type === 'keyDown' && input.key === 'F11') {
event.preventDefault()
win.setFullScreen(!win.isFullScreen())
const next = !win.isFullScreen()
win.setFullScreen(next)
notifyFullscreen(next)
}
})
}
// 窗口级全屏只在主进程可见:页面拿不到 setFullScreen 的结果,标题栏也就不会让位。
// 状态变化下发一次之外,加载完成还要补发一次——重载/渲染进程崩溃恢复后窗口可能
// 已经是全屏,只挂事件会让页面一直画着标题栏。
const notifyFullscreen = () => {
if (win.isDestroyed()) return
win.webContents.send('window:fullscreen-changed', win.isFullScreen())
}
win.on('enter-full-screen', notifyFullscreen)
win.on('leave-full-screen', notifyFullscreen)
win.webContents.on('did-finish-load', notifyFullscreen)
win.on('enter-full-screen', () => notifyFullscreen(true))
win.on('leave-full-screen', () => notifyFullscreen(false))
win.webContents.on('did-finish-load', () => notifyFullscreen())
win.once('ready-to-show', () => {
if (!win.isDestroyed()) win.show()
@@ -179,7 +194,9 @@ class DisplayManager {
if (!win.isDestroyed()) win.webContents.reload()
})
const entry = { win, page, reloadTimer: null }
// single 必须跟着 entry 走:页面 URL 里的 windowed 是按它生成的,
// 排布后来改了模式而这里没记,窗口的真实模式就和页面的认知脱钩了
const entry = { win, page, single, manual, reloadTimer: null }
// 窗口销毁(外部关闭/渲染进程崩溃)后必须把 entry 从 map 摘掉,
// 否则 layout/relayout 一直拿到已销毁窗口而静默跳过,现场只剩余黑屏
@@ -299,10 +316,10 @@ class DisplayManager {
this.layout()
}
// 窗口的当前全屏状态:以窗口为准,配置改了 kiosk 但窗口没重建时也能报对
isKioskWindow(win) {
if (!win || win.isDestroyed()) return false
return Boolean(win.isKiosk() || win.isFullScreen())
// 窗口模式只看 entry 记的建窗模式,不用 win.isKiosk()/isFullScreen() 反推:
// 窗口化窗口被 F11 全屏后 isFullScreen() 也是 true,反推会把窗口化误报成 kiosk
modeOf(entry) {
return entry && entry.single === false ? 'kiosk' : 'windowed'
}
// 管理面板手动为某块屏开窗:已经开着就只聚焦,重建会打断正在展示的大屏
@@ -315,8 +332,8 @@ class DisplayManager {
if (existing.win.isMinimized()) existing.win.restore()
existing.win.show()
existing.win.focus()
// 已有窗口按它的真实状态报模式(可能与本次请求不同),面板才不会说反
return { created: false, mode: this.isKioskWindow(existing.win) ? 'kiosk' : 'windowed' }
// 已有窗口按它的真实模式报(可能与本次请求不同),面板才不会说反
return { created: false, mode: this.modeOf(existing) }
}
// 已销毁的窗口占着 map 会让后续 layout 静默跳过,先摘掉旧 entry 再建
if (existing) {
@@ -324,10 +341,12 @@ class DisplayManager {
this.windows.delete(display.id)
}
// 手动开的窗口也计入 enabled:服务停止时 closeAll 才会把它一起收走
// 手动开的窗口也计入 enabled:服务停止时 closeAll 才会把它一起收走。
// manual=true:自动排布不许改它的模式,否则面板开的小窗会被下一次排布顶成 kiosk
this.enabled = true
this.windows.set(display.id, this.createWindow(display, 0, !kiosk, wantedPage))
return { created: true, mode: kiosk ? 'kiosk' : 'windowed' }
const entry = this.createWindow(display, 0, !kiosk, wantedPage, true)
this.windows.set(display.id, entry)
return { created: true, mode: this.modeOf(entry) }
}
// 关掉某块屏上的大屏窗口:kiosk 窗口刻意忽略鼠标,误开后只能从这里收
@@ -355,7 +374,7 @@ class DisplayManager {
scaleFactor: display.scaleFactor,
open,
page: open ? entry.page : this.pageFor(index),
mode: open ? (this.isKioskWindow(entry.win) ? 'kiosk' : 'windowed') : null
mode: open ? this.modeOf(entry) : null
}
})
// 单屏机器上谈「扩展屏全屏」没有意义,与 pickDisplays 同一口径