summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorJonas Ådahl <jadahl@gmail.com>2016-07-15 16:52:50 +0800
committerJonas Ådahl <jadahl@gmail.com>2016-08-12 10:54:14 +0800
commite33b6ed9bb1013bd11f9af8227931c2dff4d3b60 (patch)
tree534a2781691ac4a846f538660021bb52ee155d67
parent9f7c809aaba23455426441eba60cc59ef10f0464 (diff)
downloadwayland-protocols-e33b6ed9bb1013bd11f9af8227931c2dff4d3b60.tar.gz
xdg-shell: Clarify focus semantics for popup grabs
Make it clearer what the focus semantics are during a popup grab. In short, when a grabbing popup is mapped, the top most popup will always have keyboard focus, while pointer and touch focus works just as normal except that only surfaces from the grabbing client will receive pointer and touch focus. This patch doesn't really change any semantics but rather clarifies what was ambiguous before. Signed-off-by: Jonas Ådahl <jadahl@gmail.com> Reviewed-by: Mike Blumenkrantz <zmike@osg.samsung.com>
-rw-r--r--unstable/xdg-shell/xdg-shell-unstable-v6.xml8
1 files changed, 4 insertions, 4 deletions
diff --git a/unstable/xdg-shell/xdg-shell-unstable-v6.xml b/unstable/xdg-shell/xdg-shell-unstable-v6.xml
index 1d59a0e..d3abe5b 100644
--- a/unstable/xdg-shell/xdg-shell-unstable-v6.xml
+++ b/unstable/xdg-shell/xdg-shell-unstable-v6.xml
@@ -1012,10 +1012,10 @@
popup will be immediately dismissed. If the parent is a popup that did
not take an explicit grab, an error will be raised.
- Clients will receive events for all their surfaces during this grab
- (which is an "owner-events" grab in X11 parlance). This is done so that
- users can navigate through submenus and other "nested" popup windows
- without having to dismiss the topmost popup.
+ During a popup grab, the client owning the grab will receive pointer
+ and touch events for all their surfaces as normal (similar to an
+ "owner-events" grab in X11 parlance), while the top most grabbing popup
+ will always have keyboard focus.
</description>
<arg name="seat" type="object" interface="wl_seat"