vue3+Ts+Ant Design Vue +天地图组件封装

🌈个人主页：前端青山
🔖人终将被年少不可得之物困其一生

依旧青山,本期给大家带来Vue3+Ts+AntDesign-Vue组件+天地图组件的封装

示例图

首先,在index.html引入天地图资源,vue3选择v4版本

    <script src="http://api.tianditu.gov.cn/api?v=4.0&tk=你的秘钥" type="text/javascript"></script>

使用<BasicModal>组件作为模态框基础样式，并通过@register、@ok、@cancel等事件来注册、提交和取消选择点位操作。
组件内部使用天地图（Tianditu）进行地图展示和操作，包括初始化地图、点击地图获取坐标、根据地址搜索坐标等。
组件提供了一个搜索框，用户可以输入地址，通过点击搜索按钮来搜索对应的坐标，并在地图上标记。
组件可以接收初始的经纬度信息（通过initialLongitude和initialLatitude两个props传递），并在地图上标记该位置。
组件内部使用了一些变量和函数来保存和操作地图、标记等信息，例如mapInstance、currentMaker、longitude、latitude等。
组件提供了success和cancel两个自定义事件，用于在选择点位成功或取消时通知父组件。

地图弹框示例代码

<template><div style="width: 100%" @click="show"><slot></slot><!-- 弹框组件 --><BasicModalwidth="1000px"@register="registerModal"@ok="submit"@cancel="handleCancel"destroy-on-close:title="'请选择点位'"><div class="mb-2"><Input id="tipinput" v-model:value="searchValue" :placeholder="'请填写详细地址'"/><a-button type="primary" @click="search">搜索</a-button></div><!-- 使用天地图容器 --><div id="mapDiv" ref="wrapRef" style="width: 100%; height: 500px"><div id="Tip" v-if="showCurrent">当前坐标:{{longitude}}-{{latitude}}</div></div></BasicModal></div>
</template><script setup lang="ts">import { onMounted, ref ,nextTick,toRefs } from 'vue';import { BasicModal, useModal } from '/@/components/Modal';import { Input, message } from 'ant-design-vue';import GpsIcon from '/@/assets/images/gps.png';const emits = defineEmits(['success', 'cancel']);// 天地图相关数据绑定const mapInstance = ref(null as any);// 搜索区域内容const searchValue = ref('');// 变量保存Maker实例const currentMaker = ref(null as any);// 经度const longitude = ref('');// 纬度const latitude = ref('');// 判断当前坐标是否显示const showCurrent = ref(false);
// 在setup函数顶部声明缓存位置信息的ref
const lastSelectedLocation = ref({ longitude: '', latitude: '' });// 地理编码服务相关的变量let geocoder: any = null;const siteInfo = ref({longitude: '',address: '',latitude: ''});const props = defineProps({// 添加初始经纬度propsinitialLongitude: {type: String,default: '',},initialLatitude: {type: String,default: '',},// ... 其他props不变 ...
});
const { initialLongitude, initialLatitude } = toRefs(props);const [registerModal, { closeModal, openModal }] = useModal();declare global {interface Window {T: any;TMAP_VECTOR_MAP: any;}}
var T = window.T;// 初始化天地图<style scoped>#mapDiv {width: 100%;height: 100vh;}.mb-2 {display: flex;}#Tip {position: absolute;color: #424B5A;font-weight: bold;font-size: 14px;bottom: 40px;left: 18px;z-index: 999;}
</style>

这段代码是Vue组件中的一部分，主要功能是实现了天地图的初始化和地图功能的绑定。

首先，通过ref函数定义了一些变量，用于保存地图实例、搜索区域内容、Maker实例、经度、纬度、当前坐标是否显示等。
然后，通过defineProps定义了组件接收的props，包括初始经度和纬度等。
使用useModal函数定义了一个模态框的实例。
在全局声明了一个Window接口，增加了T和TMAP_VECTOR_MAP属性。
最后，定义了一个initTiandituMap异步函数，用于初始化天地图。该函数会创建一个天地图实例，并根据传入的初始经纬度进行定位，并添加一个标记到地图上。
- 首先，根据initialLongitude和initialLatitude的值进行地图中心点的设置和缩放级别设定，并添加一个新的标记到地图上。
- 如果没有传入初始经纬度，则将地图中心点设置为默认值(97.53662, 35.36499)。

  const initTiandituMap = async () => {var map: any = null;var T = window.T;map = new T.Map("mapDiv");map.setMapType(window.TMAP_VECTOR_MAP);// 根据传入的初始经纬度进行定位if (initialLongitude.value && initialLatitude.value) {map.centerAndZoom(new T.LngLat(Number(initialLongitude.value) ,Number(initialLatitude.value) ), 7);const newMarker = createNewMarker(new T.LngLat(initialLongitude.value, initialLatitude.value));map.addOverLay(newMarker);currentMaker.value = newMarker;} else {map.centerAndZoom(new T.LngLat(97.53662, 35.36499), 7);}mapInstance.value = map;map.addEventListener('click', (val: any) => {handleMapClick(val);});
};const handleMapClick = (val: any) => { if (currentMaker.value) {console.log(currentMaker.value,'有之前点位信息');mapInstance.value.removeOverLay(currentMaker.value);}siteInfo.value.longitude = val.lnglat.lng;siteInfo.value.latitude = val.lnglat.lat;longitude.value = val.lnglat.lng;latitude.value = val.lnglat.lat;showCurrent.value = true;const icon = new T.Icon({iconUrl: GpsIcon,iconSize: new T.Point(30, 30),iconAnchor: new T.Point(15, 15),});const newMarker = new T.Marker(val.lnglat);newMarker.setIcon(icon);mapInstance.value.addOverLay(newMarker);currentMaker.value = newMarker;};onMounted(() => {geocoder = new window.T.Geocoder();initTiandituMap();});function show() {openModal();// 确保在模态框打开且DOM更新后初始化或重新初始化地图nextTick(() => {initTiandituMap(); // 直接调用 initTiandituMapsearchValue.value= '';longitude.value = '';latitude.value = '';showCurrent.value = false; // 默认不显示当前坐标});}const search =  () => {console.log(searchValue.value,'search');const map:any = mapInstance.value;if (!geocoder || !searchValue.value) return;// 清除地图上覆盖物if (currentMaker.value) {mapInstance.value.removeOverLay(currentMaker.value);}geocoder.getPoint(searchValue.value, function(result) {if (result) {if (result.status == 0) {map.panTo(result.getLocationPoint(), 16);const newMarker = createNewMarker(result.getLocationPoint());map.addOverLay(newMarker);map.clearOverLays();updateCoordinates(newMarker.getPosition());} else {message.error(`搜索失败: ${result.getMsg()}`);}}});};function createNewMarker(position: any) {const icon = new T.Icon({iconUrl: GpsIcon,iconSize: new T.Point(30, 30),iconAnchor: new T.Point(15, 15),});const marker = new T.Marker(position);marker.setIcon(icon);return marker;}function updateCoordinates(position: any) {longitude.value = position.lng;latitude.value = position.lat;showCurrent.value = true;siteInfo.value.longitude = position.lng;siteInfo.value.latitude = position.lat;}// 在submit函数中更新缓存的位置信息
function submit() {lastSelectedLocation.value = { longitude: siteInfo.value.longitude, latitude: siteInfo.value.latitude };emits('success', {latitude: siteInfo.value.latitude.toString(),longitude: siteInfo.value.longitude.toString(),});closeModal();
}function handleCancel() {emits('cancel');closeModal();}
</script>

首先，将地图实例赋值给mapInstance，然后给地图添加点击事件监听器，当点击地图时，会调用handleMapClick函数。
handleMapClick函数根据点击的坐标点信息，移除之前添加的标记（如果有），更新当前位置信息，并添加一个新的标记到地图上。
onMounted生命周期函数用于在组件挂载后执行初始化地图的操作。
show函数用于打开模态框并初始化或重新初始化地图。
search函数用于根据输入的搜索值进行地点搜索，清除之前添加的标记，将搜索结果标记在地图上，并更新当前位置信息。
createNewMarker函数用于创建一个新的标记，并设置标记的样式。
updateCoordinates函数用于更新当前位置信息。
submit函数用于在提交表单时更新缓存的位置信息，并触发success事件。
handleCancel函数用于在取消操作时触发cancel事件，并关闭模态框。

表单封装

把我们封装好的地图弹框引入给于事件传参

表单组件示例代码

<div><FormItemRest><MapModal v-model:value="location" @success="handleSuccess":initial-longitude="location.longitude":initial-latitude="location.latitude"><div calss="map" style="display:flex"><div><a-inputreadonly:disabled="disabled":placeholder="placeholder"v-model:value="location.longitude":size="size":bordered="bordered"@blur="emit('blur')"style="min-width: 150px"> </a-input></div><div style="margin:5px 10px">-</div><div> <a-inputreadonly:disabled="disabled":placeholder="placeholder"v-model:value="location.latitude":size="size":bordered="bordered"@blur="emit('blur')"style="min-width: 150px"></a-input></div> <div style="margin:5px 10px;"><Icon icon='mdi:map-marker-radius-outline' /></div></div></MapModal></FormItemRest></div><style scoped>
.map{display: flex;
}
</style>

这段代码是Vue的一个模板，用于渲染一个包含地图模态框和两个输入框的表单项。其中：

<FormItemRest> 是一个表单项容器组件；
<MapModal> 是一个地图模态框组件，通过 v-model:value 绑定到 location 属性，表示地图选择的地理位置，@success 事件在选择成功时触发，:initial-longitude 和 :initial-latitude 分别绑定到 location.longitude 和 location.latitude，表示地图的初始经度和纬度；
<a-input> 是一个输入框组件，通过 v-model:value 绑定到 location.longitude 和 location.latitude，表示经度和纬度的值，readonly 和 :disabled 表示输入框为只读且不可用状态，:placeholder 表示占位符，:size 和 :bordered 分别表示输入框的大小和边框样式，@blur 表示输入框失去焦点时触发的事件；
<Icon> 是一个图标组件，显示一个地图标记的图标。

<script>import { Form } from 'ant-design-vue';import { MapModal } from '/@/components/Map/index';import { watch, ref, inject } from 'vue';import { Icon } from '/@/components/Icon';import { camelCaseString } from '/@/utils/event/design';// 用于包裹弹窗的form组件 因为一个FormItem 只能收集一个表单组件  所以弹窗的form 必须排除const FormItemRest = Form.ItemRest;const props = defineProps({value: String,prefix: String,suffix: String,placeholder: String,readonly: Boolean,disabled: Boolean,size: String,bordered: {type: Boolean,default: true,},latitude: String,latiAndLong: String,index: Number,mainKey: String,longitude:String,});const location:any = ref<{ latitude: string; longitude: string }>({ latitude: '', longitude: '' });//对象形式接收经度维度const emit = defineEmits(['update:value', 'change', 'blur']);const formModel = inject<any>('formModel', null); // 注入表单数据const isCustomForm = inject<boolean>('isCustomForm', false);watch(() => props.value,() => {location.value.longitude = props.longitude,location.value.latitude = props.valueconsole.log('props.value', props);if (!props.value) {//预览页面 重置location.value = { latitude: '', longitude: '' };}},{immediate: true,},);function handleSuccess(v) {location.value = { latitude: v.latitude, longitude: v.longitude };console.log('MAP handleSuccess ', v);changeFieldData(v);emit('update:value', location.value.latitude,location.value.longitude);emit('change',location.value.latitude,location.value.longitude);}function changeFieldData(v) {if (!formModel) return;if (props.latitude) {const latitudeField: any = isCustomForm ? props.latitude : camelCaseString(props.latitude);if (props.mainKey && props.index !== undefined && props.index !== null) {formModel[props.mainKey][props.index][latitudeField] = v.latitude;} else {formModel[latitudeField] = v.latitude;}}if (props.latiAndLong) {const latiAndLong: any = isCustomForm? props.latiAndLong: camelCaseString(props.latiAndLong);if (props.mainKey && props.index != undefined && props.index !== null) {formModel[props.mainKey][props.index][latiAndLong] = v.lnglat.join(',');} else {formModel[latiAndLong] = v.lnglat.join(',');}}}
</script>

引入Ant Design Vue的Form组件和自定义的MapModal组件。
引入Vue 3的watch、ref、inject等函数。
定义组件的props，包括输入框的值、前缀、后缀、占位符、只读、禁用、大小、是否带边框、经度、纬度等。
使用ref定义一个location的响应式对象，用来保存经度和纬度数据。
使用defineEmits定义组件可以发出的事件，包括update:value、change和blur。
使用inject来注入表单数据的formModel和是否为自定义表单的isCustomForm。
使用watch来监听props.value的变化，并更新location的值。如果props.value为空，则重置location。
定义handleSuccess函数，用来处理地图弹窗成功获取到数据的情况。将数据更新到location，并调用changeFieldData函数更新表单数据，最后通过emit发出事件。