@fusion.dev/helix-docs 0.115.0 → 0.117.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -53,7 +53,7 @@ open.
53
53
 
54
54
  [//]: # (renders)
55
55
 
56
- **27 of the 97 headless families interpolate another family's tag**, across 20 distinct children.
56
+ **27 of the 98 headless families interpolate another family's tag**, across 20 distinct children.
57
57
 
58
58
  | Family | Renders |
59
59
  |---|---|
package/content/maps.mdx CHANGED
@@ -227,6 +227,35 @@ removing it to your framework.
227
227
  A snapshot is a flat map. A map zoomed out past about 6 is a globe in MapLibre,
228
228
  so draw snapshots of city and street views.
229
229
 
230
+ ## Share the scroll with the page
231
+
232
+ By default a map takes every gesture over it: the wheel zooms the map, and one
233
+ finger pans it. That suits a map that is the page, such as a full-screen view.
234
+ A map embedded in a page, such as a hero, takes the wheel from a reader who is
235
+ scrolling past it. Set `gestures` on the frame to share them:
236
+
237
+ ```html
238
+ <helix-map gestures="cooperative" label="Downtown Austin">
239
+ <div id="map"></div>
240
+ </helix-map>
241
+ ```
242
+
243
+ - `cooperative` leaves the wheel and one finger to the page. The map takes Ctrl
244
+ or ⌘ with the wheel, and two fingers. When a gesture passes to the page, the
245
+ frame says how to reach the map, where the gesture was. Use it for a map
246
+ embedded in a page.
247
+ - `activate` takes nothing until the map is pressed. The frame then shows that
248
+ the map has the gestures, and gives them back when the reader presses Escape,
249
+ moves the pointer off the map, or presses elsewhere on the page.
250
+ - `always`, the default, takes every gesture.
251
+
252
+ The keyboard and the frame's buttons work the same in every mode. `connectMap`
253
+ tells the renderer, so MapLibre and Leaflet behave alike, and MapLibre's own
254
+ message is replaced by the frame's. For Leaflet, pass `L`, as
255
+ `leafletDriver(map, L)`. Change the words with `wheel-hint-label`,
256
+ `two-finger-hint-label`, `activate-hint-label`, and `using-label`. Style the
257
+ hint and the line with `::part(gesture-hint)` and `::part(gesture-status)`.
258
+
230
259
  ## Show the map once it is drawn
231
260
 
232
261
  MapLibre draws a map in stages: the streets, then the imagery tile by tile,