Velocity X Components by Aidxn Design

Standard Data

Standard Map Layer Toggles

StandardMapLayerToggles — the row of pills that sits over a map or canvas and switches overlays on and off.

Lifetime access Included with the VX Components lifetime licence.
bash
$ velocityx add standard-map-layer-toggles

Built for react. Needs react already installed as a peer dependency. An Astro-only project needs @astrojs/react wired up first — this won't run on its own in plain Astro.

Full docs for Standard Map Layer Toggles →

Needs a licence key — buy lifetime access here, then velocityx login once.

react v1.0.0
Standard Map Layer Toggles
Map layers
Framework
react
Source
179 lines
StandardMapLayerToggles.jsx
Runtime
Interactive
runs in the browser
Theme
10 tokens
re-themes from your scale
Responsive
sm · md
2 breakpoints
Dark mode
Built in
dark: variants
Accessibility
5 ARIA
attributes and roles

Props

NameTypeRequiredDefaultDescription
layersarrayNoDEMO_LAYERS{ id: string; label: string; enabled?: boolean; count?: number;
onToggle(id: string, next: boolean) => voidYes
size'sm' | 'md'No'md'
labelstringNo'Map layers'accessible group name
classNamestringNo''

Using it

The smallest call that compiles — required props only. The import is written for your own file at src/components/Example.jsx; adjust the relative import if yours sits elsewhere. Everything optional is in the table above, with its default.

tsx
import StandardMapLayerToggles from './velocity/standard-map-layer-toggles/StandardMapLayerToggles';

export default function Example() {
  return (
    <StandardMapLayerToggles
      onToggle={() => {}}
    />
  );
}

Built from Standard Map Layer Toggles's own prop signature and the path the CLI installs it to, so it can't drift from either.

Accessibility

ARIA roles
group
ARIA attributes
aria-busy, aria-hidden, aria-labelledby, aria-pressed
Keyboard
Built on native controls — Enter/Space work as standard
Screen readers
Ships screen-reader-only text
Motion
Respects prefers-reduced-motion

Read from the source, not asserted — anything not listed simply isn't in this component's markup.

Behaviour

Ships client JS
Yes — this one needs to hydrate
React hooks
useId
Breakpoints
sm: md:
Dark mode
Carries its own dark: variants

Theming

This component paints from 10 steps of your theme scale — no hardcoded colours, and no font-family of its own, so your type cascade wins. Override the variables and it follows.

accent-400accent-500accent-600primary-50primary-100primary-400primary-500primary-600primary-700primary-900

Get the Velocity preset and CSS theme from the public source guide. The CLI theme command is not available on npm yet.

File this creates

The CLI writes this path into your project — nothing else moves. Paths are under your source root, which defaults to src/; pass --dest if yours is elsewhere.

  • src/components/velocity/standard-map-layer-toggles/StandardMapLayerToggles.jsx 179 lines
Copy the paths
text
src/components/velocity/standard-map-layer-toggles/StandardMapLayerToggles.jsx

Standard Map Layer Toggles — questions

How do I install Standard Map Layer Toggles?

Run velocityx add standard-map-layer-toggles . The CLI writes the source straight into your project — it is not a runtime package dependency.

Do I need a licence for Standard Map Layer Toggles?

Yes. It is part of the lifetime library — buy access at https://aidxn.com/shop/velocity-x-component-library/, authenticate once, and install it. Your lifetime licence includes future component updates.

Can I edit Standard Map Layer Toggles after installing it?

Yes — the files are yours once written. The CLI compares its lockfile hash before upgrades and refuses to overwrite code you changed.

Does Standard Map Layer Toggles ship JavaScript to my users?

Yes. It runs in the browser (useId), so it needs to hydrate — in Astro, give it a client:* directive.

Will Standard Map Layer Toggles match my brand colours?

Yes. It paints entirely from your theme scale — 10 steps of primary-* / accent-* — with no hardcoded hex values and no font-family of its own. Override the theme CSS variables and it follows your design system instead of ours.

Is Standard Map Layer Toggles accessible?

It ships ARIA roles (group), 4 ARIA attributes, native controls that are keyboard-operable by default. That is read directly from the source rather than claimed — you should still test it in the context you drop it into.

Does Standard Map Layer Toggles work on mobile?

It carries its own responsive rules at the sm, md breakpoints, so it re-flows rather than relying on the page around it to do the work.

Does Standard Map Layer Toggles pull in any dependencies?

No external ones. Every component in the library is built with react/react-dom or plain Astro only — no GSAP, Radix, Swiper or Headless UI — which is what makes dropping it into an existing project safe.

Set up & reference

All docs →

Install this component:

bash
$ velocityx add standard-map-layer-toggles

More from Standard Data.