From 02912098345bc2d73f08dafac0874c2fa7451c85 Mon Sep 17 00:00:00 2001 From: Mark Dumay <61946753+markdumay@users.noreply.github.com> Date: Mon, 13 Jul 2026 15:26:50 +0200 Subject: [PATCH] docs(map): document the cooperative gestures MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit mod-leaflet v3.1.0 stops the map from trapping page scroll: a plain wheel and a single finger now belong to the page, and the map zooms with Ctrl/Cmd + wheel or two fingers. Nothing on this page said so, so a visitor whose wheel no longer zooms would read the map as broken. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.8 (1M context) --- content/components/map.md | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/content/components/map.md b/content/components/map.md index 3d2b6ea..296f6d8 100644 --- a/content/components/map.md +++ b/content/components/map.md @@ -53,6 +53,20 @@ Assign a specific identifier to the map by setting the `id` argument. The follow {{< /example >}} +### Gestures + +The map uses cooperative gestures, so scrolling the page never gets trapped by a map in its path. It only responds to a gesture that is unambiguously meant for it. + +| Gesture | Result | +| --- | --- | +| Wheel | Scrolls the page | +| `Ctrl`/`⌘` + wheel | Zooms the map | +| Mouse drag | Pans the map | +| One finger | Scrolls the page | +| Two fingers | Pans and pinch-zooms the map | + +A gesture that the map ignores briefly shows an overlay explaining how to address the map instead. Override the `mapZoomHint` and `mapDragHint` translations to change its wording. + ## Arguments The shortcode supports the following arguments: