Files
Thing/src/modules/diff/openWindow.ts
T

85 lines
3.3 KiB
TypeScript

/**
* 对比窗口的创建入口(由前端创建,范式同 `editor/openWindow.ts`)。
*
* # 为什么是单例
*
* 与编辑器窗口(可多开、按目标判重)不同,对比工具的语义是「比较这一对目标」,
* 窗口里本来就同时容纳左右两侧 —— 多开只会让用户分不清哪一对是哪一对。
* 因此 label 固定为 `diff-window`,已存在就强制置前。
*
* # 隐藏创建 + 先应用主题
*
* 窗口初始底色是白的,而深色主题要等前端读 localStorage 后才应用 —— 直接显示会先
* 闪一下纯白。因此 `visible: false` 创建,由 `DiffWindow.vue` 应用完主题(含窗口效果)
* 与任务栏身份之后再自己 `show()`(同编辑器 / 终端窗口)。
*
* # 置前走原生命令
*
* `SetForegroundWindow` 不受 Windows 前台锁定限制;前端 `setFocus()` 在「本进程不拥有
* 前台」时会被系统直接忽略(表现为窗口明明开着却唤不到前面)。同下载窗口 / 快速面板。
*/
import { WebviewWindow } from '@tauri-apps/api/webviewWindow'
import { invoke } from '@tauri-apps/api/core'
import { createLogger } from '@/lib/logger'
import { WINDOWS } from '@/lib/constants'
const logger = createLogger('diff')
const LABEL = WINDOWS.diffWindow
/**
* 打开(或唤出)对比窗口。
*
* @param target 可选:P2 起用于把某个文件 / 文件夹作为初始目标(写入 URL 查询串)
*/
export async function openDiffWindow(target?: { path?: string }): Promise<void> {
const existing = await WebviewWindow.getByLabel(LABEL)
if (existing) {
try {
await invoke('window_focus_window', { label: LABEL })
return
} catch (e) {
logger.warn(`唤出既有对比窗口失败:${String(e)}`)
}
}
const query = target?.path ? `?path=${encodeURIComponent(target.path)}` : ''
const win = new WebviewWindow(LABEL, {
url: `index.html#${LABEL}${query}`,
title: '对比',
width: 1180,
height: 780,
minWidth: 720,
minHeight: 460,
resizable: true,
// 自绘标题栏(与编辑器 / 终端 / 文件窗口一致)
decorations: false,
// 透明通道用于承载 mica / acrylic
transparent: true,
shadow: true,
center: true,
visible: false,
focus: false,
// 拖入任意文件 / 文件夹作为某一侧目标(P2 起真正使用)
dragDropEnabled: true
})
// 不要等到 `tauri://created` 之后才挂错误监听:窗口创建过快时事件可能早于监听注册
win.once('tauri://error', e => logger.error(`打开对比窗口失败:${String(e)}`))
// 补注入拖放支持:wry 只在创建 webview 那一刻扫一次子窗口,运行期新建的窗口拿不到
// OLE drop target(拖文件进去是禁止光标)。详见 src-tauri/src/drag_drop.rs
//
// 注意**不要**放到下面那个 `await` 之后:`tauri://created` 在窗口创建过快时可能早于
// 监听注册而永远等不到。Rust 侧会自行重试等待窗口与 WebView2 子窗口就位,因此这里
// fire-and-forget 即可。
void invoke('window_attach_drag_drop', { label: LABEL }).catch(e => {
logger.warn(`拖放补注入失败:${String(e)}`)
})
await new Promise<void>((resolve, reject) => {
win.once('tauri://created', () => resolve())
win.once('tauri://error', e => reject(new Error(String(e))))
})
}