BaseMap Control

Usecase

• Allow end users to switch base layers (streets/satellite/dark) quickly.
• Preconfigure a curated list of base maps for consistency across apps.

Props

Prop	Description	Type	Required	Default Value
mapId		string	false	--
dragId		string	false	--
btnWidth		number	false	40
controlOrder	CSS flex order for the standalone button	number	false	0
position		'top-left', 'top-right', 'bottom-left', 'bottom-right'	false	'bottom-right'
controlLayout	'standalone' (corner), 'toolbar' (always in toolbar), 'button' (always corner; not auto-promoted on mobile)	'standalone' | 'toolbar' | 'button'	false	'standalone'
controlVisible		boolean	false	true

Map also accepts buttonInMobile ('button' | 'toolbar' | 'menu', default 'button'). On viewports ≤640px:

• 'button' — leave corner buttons unchanged
• 'toolbar' — move declared control buttons into a single ToolbarControl host (except controlLayout="button"). Mount one ToolbarControl in the map slot
• 'menu' — hide per-control corner buttons; fan out intact clusters by position into corner stacks with outside-in More. Mount one ToolbarControl.

See ToolbarControl.

and

Prop	Description	Type	Required	Default Value
title		string	false	``
defaultBaseMap		string	false	Open Street Map
controlIcon		string	false	``
baseMaps	BaseMapItem[]	array	false	``
showOpacity	Show opacity slider in the settings popup	boolean	false	false
allowAddBasemap	Show an Add tile in the basemap grid (opens URL form). Custom tiles show a remove control on the thumbnail.	boolean	false	false

Slots

Name	Description
default	id:string

Events

Event	Payload	Description
basemap-change	Basemap	Fired when basemap changes

Usage

Vue

<script setup lang="ts">
import { Map } from '@hungpvq/vue-map-core';
import { BaseMapControl } from '@hungpvq/vue-map-core';
import '@hungpvq/vue-map-core/style.css';
const baseMaps = [];
</script>

<template>
  <Map>
    <BaseMapControl :baseMaps="baseMaps" />
  </Map>
</template>

React

import { Map, BaseMapControl } from '@hungpvq/react-map-core';
import '@hungpvq/react-map-core/style.css';

const baseMaps = [];

<Map>
  <BaseMapControl baseMaps={baseMaps} />
</Map>;