@map-component/vue-tmap
v1.0.1
Published
基于腾讯地图 JavaScript API GL、TypeScript 封装适用于 Vue3 的高性能地图组件库
Downloads
50
Readme
vue-tmap
- zh_CN 简体中文
Introduction
vue-tmap, a high-performance map component library for Vue3 based on Tencent Maps and TypeScript encapsulation, has the following features:
- Improve documentation: improve the readability of documentation based on official documentation and framework usage, and improve component examples
- Componentization: Encapsulate the Tencent Maps imperative api as a responsive component, no need to care about the complex map api, only need to operate the data
- Multi-framework: including react-tmap and vue-tmap, and share the same set of type definitions
- Type-safe: supplemented the type declaration of Tencent Maps sdk, components are also developed using TypeScript, a better development experience
- Custom components: provide an open map instance, you can write custom components or directly call the map's native api
- Performance optimization: unify the map api calling method and data monitoring to prevent performance problems caused by misuse of the map api
Documentation and Examples
Welcome to Official document address to view more map components.
Main Components
| tmap-class | vue component | Introduction | | ------------- | ------------------- | -------------------------- | | Map | tmap-map | Map base components | | MultiMarker | tmap-multi-marker | Multiple Marker Points | | MultiPolyline | tmap-multi-polyline | Polyline | | MultiPolygon | tmap-multi-polygon | Polygon | | MultiLabel | tmap-multi-label | Text Labeling | | MultiCircle | tmap-multi-circle | Circle | | DOMOverlay | tmap-dom-overlay | DOM overlay abstract class | | InfoWindow | tmap-info-window | Information prompt window | | MarkerCluster | tmap-marker-cluster | Point Aggregation |
Quick start
Install
npm install @map-component/vue-tmap
Apply for Tencent map key
https://lbs.qq.com/dev/console/key/manage
Simple example
<template>
<tmap-map
mapKey="CGABZ-3MH66-6VGST-MEMS3-K6U3V-DGBKA"
:events="events"
:center="center"
:zoom="zoom"
:doubleClickZoom="doubleClickZoom"
:control="control"
>
</tmap-map>
</template>
<script lang="ts">
import { defineComponent, ref } from 'vue';
export default defineComponent({
name: 'Home',
setup() {
const center = ref({ lat: 30.290756, lng: 120.074387 });
const zoom = ref(10);
const doubleClickZoom = ref(true);
const print = (e: unknown) => {
console.log(e);
};
return {
events: {
dblclick: print,
},
center,
zoom,
doubleClickZoom,
control: {
scale: {},
zoom: {
position: 'bottomRight',
},
},
};
},
});
</script>
mapKey is the newly applied key
Contribution Guidelines
Thanks to all the technical enthusiasts who participated in the contribution, let's build an easy-to-use map component library together
Commit bug
Please submit a bug through issue, and describe in detail how to reproduce the error and the version of dependencies. It is best to display the reproduced code through an online code editor.
Submit code
Please submit your code via pull request and we'll take a look soon
Start development
git clone xxx
cd react-tmap // cd vue-tmap
npm install
npm run dev
communicate with
Add WeChat group after open source