summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorXaver Hugl <xaver.hugl@kde.org>2025-07-17 18:18:17 +0200
committerSimon Ser <contact@emersion.fr>2025-08-03 11:38:49 +0000
commitc61399a0cc6947131f8f8a181bcbdca9d14747c4 (patch)
treecc4931af1ec275b4d96c3f86c0095f49f6752e76
parent46f46863b7b5ac8d9c5bcdb167b57ae803d064ac (diff)
xdg-shell: warn about putting UI outside of window geometry
There should only be decoration outside of it, no functional UI elements. This is especially important on some compositors that clip windows to their window geometry in some situations (like when it's in a tile). Signed-off-by: Xaver Hugl <xaver.hugl@kde.org>
-rw-r--r--stable/xdg-shell/xdg-shell.xml5
1 files changed, 4 insertions, 1 deletions
diff --git a/stable/xdg-shell/xdg-shell.xml b/stable/xdg-shell/xdg-shell.xml
index fb7b8b4..39ecf8a 100644
--- a/stable/xdg-shell/xdg-shell.xml
+++ b/stable/xdg-shell/xdg-shell.xml
@@ -514,7 +514,10 @@
The window geometry of a surface is its "visible bounds" from the
user's perspective. Client-side decorations often have invisible
portions like drop-shadows which should be ignored for the
- purposes of aligning, placing and constraining windows.
+ purposes of aligning, placing and constraining windows. Note that
+ in some situations, compositors may clip rendering to the window
+ geometry, so the client should avoid putting functional elements
+ outside of it.
The window geometry is double-buffered state, see wl_surface.commit.