Docking
- Development Thread: https://github.com/ocornut/imgui/issues/2109
- Search Issues: https://github.com/ocornut/imgui/labels/docking
- See: Glossary -> Docking terms.
Docked windows
Docking is currently available in the docking branch. This is a well maintained branch and most large teams have been using this branch for a while. It is safe and recommended to use that branch. The branch also include the Multi-viewports feature.
ImGui::GetIO().ConfigFlags |= ImGuiConfigFlags_DockingEnable;
That's pretty much it. There are 4 additional docked related configuration flags in the io structure which you may toy with.
(Please note that the following paragraphs have been written by a overly cautious person)
Several advanced features (mostly in imgui_internal.h), such as tight interaction with native multi-viewports, or the DockBuilder are still expecting api changes. I am also not particularly happy with how some aspects of the code are current implemented, and considering to maybe rewrite all of docking from scratch a third time!
However, you can benefit from a lot of docking features without being impacted by any of this. The largest amount of interactions you'll have with the docking system are at end-user level and do not require API calls. By just enabling the config flag above and calling 1-2 functions you can benefit from 90% of Docking features. Even the hypothetical full rewrite of Docking system is not expected to impact most users. API that are most at risk of changing are hidden in imgui_internal.h for this reason, and even so, if they do change, we'll make reasonable effort to document the reasoning the update path.
In addition, Docking will only move forward with feedback from users, so the more people using it, the closer we are to a reach mergeable version. TL;DR; is totally fine to use for most users.
Also see our Glossary about Docking terminology.
Dock by dragging windows from their title tab or tab (hold SHIFT to disable docking)
-
Dock into an existing window or node
-
Split existing node
-
Undock a window from a node
-
Undock a node (all windows) from a hierarchy
-
Tab bar may be hidden
- Explain how/why the data persist
- Explain dockspace (~~ node positioned within an existing window)
- Explain central node
- Metrics window.
- Enable
IMGUI_DEBUG_LOG_DOCKING()
Prior to the official adoption of the Docking branch, various third-party versions existed: