求助：在i3wm平铺模式打开JavaFX(TornadoFX/Kotlin)子窗口失败

嘿，我懂你现在的头疼点——用TornadoFX开发JavaFX应用，想让子窗口在i3wm里自动平铺，非平铺管理器下直接最大化，但现在子窗口却一直飘着浮动。之前试的onDock()方法没起效，核心原因是i3wm这类平铺窗口管理器对JavaFX窗口的默认属性不认可，单纯的最大化操作不足以让它把窗口识别成可平铺的普通窗口。

问题根源 #

i3wm判断窗口是平铺还是浮动，主要看两个点：

• JavaFX默认打开的子窗口（比如Fragment窗口）常被标记为UTILITY或DIALOG类型，这类窗口在i3里默认是浮动状态
• 没有设置正确的WM_CLASS属性，i3无法识别它为普通应用窗口

解决方案：调整窗口属性+适配i3wm #

下面给你一套可行的实现方案，结合窗口属性配置和i3wm适配：

1. 完整的Fragment实现代码

class FileMapFragment : Fragment() {
    val file: Path by param()

    // 你的UI布局
    override val root = borderpane {
        // 这里放你的界面组件，比如Label(file.toString())
    }

    override fun onDock() {
        super.onDock()
        currentStage?.let { stage ->
            // 关键1：设置窗口为标准装饰类型，避免被识别为工具/对话框窗口
            stage.initStyle(StageStyle.DECORATED)

            // 关键2：针对Linux/X11环境（i3wm）设置WM_CLASS属性
            if (System.getProperty("os.name").lowercase().contains("linux")) {
                configureWMClassForI3(stage, "your-app-id", "YourAppName")
            }

            // 最大化窗口，非平铺管理器下直接生效
            stage.isMaximized = true
        }
    }

    /**
     * 为i3wm设置WM_CLASS属性，让i3识别为普通窗口
     */
    private fun configureWMClassForI3(stage: Stage, className: String, instanceName: String) {
        try {
            // 通过反射获取JavaFX底层窗口对象，适配不同JavaFX版本
            val peer = stage.javaClass.getMethod("impl_getPeer").invoke(stage)
            val window = peer.javaClass.getMethod("getWindow").invoke(peer)
            
            if (window.javaClass.name.contains("GtkWindow")) {
                val setWMClassMethod = window.javaClass.getMethod(
                    "setWMClass",
                    String::class.java,
                    String::class.java
                )
                setWMClassMethod.invoke(window, className, instanceName)
            }
        } catch (e: Exception) {
            // 兼容不同JavaFX版本，捕获异常不影响主逻辑
            println("Failed to set WM_CLASS for i3wm: ${e.message}")
        }
    }
}

2. 打开Fragment时的配置（可选）

如果你想在打开窗口时直接指定属性，也可以用openWindow的block参数：

// 打开FileMapFragment时的代码
find<FileMapFragment>(mapOf(FileMapFragment::file to yourFilePath)).openWindow(
    stageStyle = StageStyle.DECORATED,
    block = {
        isMaximized = true
        // 同样可以在这里调用configureWMClassForI3方法
    }
)

额外说明 #

• WM_CLASS的作用：i3wm通过WM_CLASS来识别窗口，设置后你还可以在i3配置里针对这个类做更精细化的规则（比如指定固定工作区）
• 内部API兼容：上面用到的impl_getPeer是JavaFX的内部API，虽然在OpenJFX的多数版本中可用，但如果后续版本变动，你可以改用JavaFX的Window相关反射方法替代
• i3配置兜底：如果应用层面的设置还是无效，可以在i3的配置文件（~/.config/i3/config）里添加规则，强制让你的窗口平铺：

  for_window [class="YourAppName"] floating disable
  

这样调整后，子窗口在i3wm里会被识别为普通窗口自动平铺，在GNOME/KDE这类非平铺管理器下会直接最大化，应该就能满足你的需求了！

内容的提问来源于stack exchange，提问作者pixix4