Qml实现Dock浮动、停靠功能

效果展示

github地址:

https://github.com/longtwilight/QmlDock

介绍

这是一个使用纯qml实现的Dock组件，它支持停靠、浮动、窗体分离、窗体独立、大小调整等功能。开源它的目的是为了寻求更多的功能(如侧边栏)、更好的结构设计、更通用的应用场景以及更好的稳定性和易用性。欢迎批评和指正。

环境

Qt版本：Qt6.2.4
编译器：mingw、msvc、gcc均支持

Demo代码

import QtQuick
import QtQml
import QtQuick.Controls
import QtQuick.Window
import "./Dock/"ApplicationWindow {width: 1400height: 800visible: truetitle: qsTr("QmlDock Demo")MyDockHome{id: dockHomemyDockState: MyDockBase.DockState.Fillanchors.margins: 2Dock{id: dock1width: 600height: 550name: "dock1"dockHome: dockHomeclosable: falsedockTo: dock3direction: Dock.Direction.Center}Dock{id: dock2width: 300height: 600name: "dock2"dockHome: dockHomesplittable: falsedockTo: dock3direction: Dock.Direction.Left}Dock{id: dock3myDockState: MyDockBase.DockState.Fillname: "dock3"dockHome: dockHome}Dock{id: dock4width: 400height: 400myDockState: MyDockBase.DockState.Centername: "dock4"dockHome: dockHomeclosable: falsesplittable: false}}
}

参数说明

关键字	说明	取值
name	Dock窗体的标题	字符串
width / height	Dock窗体宽度 / 高度	整数
dockHome	为了实现边缘的停靠，所有Dock窗体必须声明在DockHome类中，且该字段需声明为DockHome的id	DockHome的id
closable	Dock窗体是否允许关闭	true / false
splittable	Dock窗体是否允许从主窗体中独立出来成为单独窗体	true / false
hide	Dock窗体默认是否显示，相当于visible属性，但visible与stacklayout视图有冲突，所以在此基础上多封装了一层	true / false
myDockState	Dock在DockHome中的默认状态，与anchors属性相似，但使用anchors属性会存在问题	MyDockBase.DockState: Fill、Center、Top、Left、Right、Bottom、Float、Tab
dockTo	窗体初始化时的停靠对象	其他Dock窗体的id
direction	窗体初始化时的停靠方向	Dock.Direction: Center、Left、Top、Right、Bottom

API说明

方法名	参数	说明
focusDock()	null	使Dock窗体获得焦点(标题栏变成金黄色渐变色)
doDockTo(target,direction)	target:待停靠的目标对象；direction：停靠方向	用于js代码中动态停靠窗体
releaseDock()	null	取消停靠
splitToWindow()	null	将Dock窗体分离成为独立窗体
returnToDockHome()	null	将分离出去的Dock独立窗体收回到DockHome中