Vite + Vue3 + OpenLayers 手动激活地图

一、需求说明

Vite + Vue3 + OpenLayers 手动激活地图

开发中遇到一种需求：

1. 需要展示地图，但默认不影响页面滚动。
2. 点击地图后，在地图上方滚动鼠标滚轮可以缩放地图。
3. 点击地图之外的地方，鼠标再回到地图上滚动滚轮时，页面可以上下滚动，但地图不会缩放。

二、开发环境

Vite + Vue3 + ol6

# 1、使用 Vite 创建项目；取个好听的项目名；拉取 vue 的代码模板
npm init vite@latest

# 2、初始化项目
cd you-project
npm install

# 3、安装 ol
npm i ol -S

# 4、启动项目
npm run dev

使用 Vite 初始化项目并安装 ol ，更详细做法可以查看 『Vite + Vue3 + OpenLayers 起步』

三、编码

<template>
  <!-- 地图容器 -->
  <div tabindex="2" id="map" class="map__x"></div>
</template>

<script setup>
import { ref, onMounted } from 'vue'
import { Map, View } from 'ol'
import Tile from 'ol/layer/Tile'
import OSM from 'ol/source/OSM'
import 'ol/ol.css'

const map = ref(null) // 绑定地图实例的变量

// 初始化地图
function initMap() {
  map.value = new Map({
    target: 'map', // 对应页面里 id 为 map 的元素
    layers: [ // 图层
      new Tile({ // 瓦片
        source: new OSM() // OSM底图
      })
    ],
    view: new View({ // 地图视图
      projection: "EPSG:4326", // 投影规则
      center: [113.120444,23.034742], // 中心点
      zoom: 12 // 默认缩放级别
    })
  })
}

onMounted(() => {
  // 在元素加载完之后再执行地图初始化
  initMap()
})
</script>

<style lang="scss" scoped>
.map__x {
  width: 600px;
  height: 600px;
  border: 1px solid #eee;
}
</style>

上面的代码最主要的部分是 地图容器（HTML） 部分添加了一个 tabindex 属性，有了该属性，鼠标放到地图容器上默认也是不会被选中的，所以滚动的时候就是触发页面滚动，不会操作到地图。

这其实是 HTML 原生的属性，这个属性指定 tab 键控制次序。W3C 上面说 Safari 不支持该属性，但据我实际测试是支持的！

四、推荐

本例展示地址（vite+vue3+ol）

本例仓库（vite+vue3+ol）

ol在vue2中使用（预览）

ol在vue2中使用（仓库）

OpenLayers 官网

《WebGIS之OpenLayers全面解析（第2版）》

如果不清楚 OpenLayers 是什么，可以阅读： 『Vite + Vue3 + OpenLayers 起步』