Map Side Drawer

GIS-origin componentUpdated 2 weeks ago

Live preview

default

comparison

Components
2 variants Tokens-backed WCAG 2.2 AA target

Persistent right-side info drawer for map feature detail. Slides in on feature click; stays visible while the map remains interactive. Replaces the popup-on-marker pattern so the map never loses context underneath.

Rendered from components/map-side-drawer/recipe.json

When to use Map Side Drawer

Use Map Side Drawer to show detail for a single selected map feature — a persistent right-side panel that slides in on click and stays visible while the map underneath remains interactive. It replaces the popup-on-marker pattern, which forces the map to lose context every time a visitor inspects a feature.

Reference implementation: live at gis.woodfinegroup.com (v0.1.94).

Variants

VariantDescription
DefaultSingle-feature detail — the current, shipped GIS use.
ComparisonSplit drawer showing two features side-by-side, for federated cluster comparison. Decision pending, not yet built.

Anatomy

  • Header — brand-family badge, feature title, close button.
  • Facts list — address, NAICS code, year opened (definition list: term/value pairs).
  • Cluster context (hidden by default) — surfaces when the feature belongs to a retail cluster: cluster ID, anchor count, max radius.

Behaviour

Slides in at 340px width from the inline-end edge, 250ms entrance easing (collapses to a plain opacity fade under prefers-reduced-motion). role="complementary" with aria-label naming the feature type; aria-modal="false" since the map stays interactive underneath. Tab cycles within the drawer while open; Escape dismisses it and returns focus to the map canvas.

Open questions

  • Whether the drawer should expand to full width below 640px or keep its 340px overlay width on small viewports — not yet decided.
  • Comparison variant's exact layout (two drawer columns vs. split-screen with the map between) is pending cluster-comparison feature work.

When not to use

This is a map-context detail panel, not a generic modal or sidebar — for those, see the substrate's Modal Dialog and TOC Sidebar components.

Important Information

Design System disclosure

This site provides open-source design tokens, documentation, and self-hostable software published by Woodfine Capital Projects Inc. Information here is for general reference only and does not constitute an offer, warranty, or a guarantee of fitness for any particular purpose. Statements regarding planned, intended, or targeted future features are forward-looking and subject to change without notice; they are not undertaken to be updated except as required by law.