vue-amap引入高德JS?API的原理是什么

這篇文章主要介紹“vue-amap引入高德JS API的原理是什么”，在日常操作中，相信很多人在vue-amap引入高德JS API的原理是什么問(wèn)題上存在疑惑，小編查閱了各式資料，整理出簡(jiǎn)單好用的操作方法，希望對(duì)大家解答”vue-amap引入高德JS API的原理是什么”的疑惑有所幫助！接下來(lái)，請(qǐng)跟著小編一起來(lái)學(xué)習(xí)吧！

vue-amap使用

在使用vue-amap時(shí)，main.js文件往往有這樣一段代碼：

import VueAMap from 'vue-amap'
Vue.use(VueAMap)
VueAMap.initAMapApiLoader({
  key: '82732XXXXXa5eXXXXb3face28c25',//你的高德key
  plugin: [
    'AMap.Autocomplete',
    'AMap.PlaceSearch',
    'AMap.Scale',
    'AMap.OverView',
    'AMap.ToolBar',
    'AMap.MapType',
    'AMap.PolyEditor',
    'AMap.CircleEditor'
  ],
  // 默認(rèn)高德 sdk 版本為 1.4.4
  v: '1.4.14'
})

這段代碼的關(guān)鍵就是initAMapApiLoader方法。

vue-amap入口文件

看vue-amap源碼，index.js 文件有如下代碼（部分代碼）：

// 初始化接口
import {initAMapApiLoader} from './services/injected-amap-api-instance';
export {
  AMapManager,
  initAMapApiLoader,
  createCustomComponent
};

可見(jiàn)initAMapApiLoader方法是被vue-amap直接向使用者暴露的，我們研究其具體實(shí)現(xiàn)。

initAMapApiLoader方法

接著我們到對(duì)應(yīng)目錄查看initAMapApiLoader的定義：

let lazyAMapApiLoaderInstance = null;
import AMapAPILoader from './lazy-amap-api-loader';
import Vue from 'vue';
export const initAMapApiLoader = (config) => {
  if (Vue.prototype.$isServer) return;
  // if (lazyAMapApiLoaderInstance) throw new Error('You has already initial your lazyAMapApiLoaderInstance, just import it');
  if (lazyAMapApiLoaderInstance) return;
  if (!lazyAMapApiLoaderInstance) lazyAMapApiLoaderInstance = new AMapAPILoader(config);
  lazyAMapApiLoaderInstance.load();
};

initAMapApiLoader中使用到了lazy-amap-api-loader中定義的AMapAPILoader類，new了一個(gè)實(shí)例，并且調(diào)用了load()方法。

AMapAPILoader類

下面我們就看一下AMapAPILoader類的定義：

看長(zhǎng)長(zhǎng)的代碼先折疊，了解大概

下面就看load()方法：

load() {
  // 如果window上掛載了AMap，那么直接調(diào)用loadUIAMap()
  if (this._window.AMap && this._window.AMap.Map) {
    return this.loadUIAMap();
  }

  if (this._scriptLoadingPromise) return this._scriptLoadingPromise;
  // 新建一個(gè)script標(biāo)簽
  const script = this._document.createElement('script');
  script.type = 'text/javascript';
  // 異步執(zhí)行
  script.async = true;
  script.defer = true;
  script.src = this._getScriptSrc();

  const UIPromise = this._config.uiVersion ? this.loadUIAMap() : null;

  this._scriptLoadingPromise = new Promise((resolve, reject) => {
    this._window['amapInitComponent'] = () => {
      while (this._queueEvents.length) {
        this._queueEvents.pop().apply();
      }
      if (UIPromise) {
        UIPromise.then(() => {
          // initAMapUI 這里調(diào)用initAMapUI初始化
          window.initAMapUI();
          setTimeout(resolve);
        });
      } else {
        return resolve();
      }
    };
    script.onerror = error => reject(error);
  });
  // script標(biāo)簽插入到head中
  this._document.head.appendChild(script);
  return this._scriptLoadingPromise;
}

可以看到這段代碼做了兩件事情：（1）增加引入高德的script標(biāo)簽 ，script標(biāo)簽的src是通過(guò) _getScriptSrc生成的 （2）引入AMapUI 組件庫(kù) ，通過(guò)調(diào)用loadUIAMap實(shí)現(xiàn)

下面分別來(lái)看這兩個(gè)方法：

_getScriptSrc方法

_getScriptSrc() {
  // amap plugin prefix reg
  // 插件前綴
  const amap_prefix_reg = /^AMap./;

  const config = this._config;
  const paramKeys = ['v', 'key', 'plugin', 'callback'];

  // check 'AMap.' prefix
  if (config.plugin && config.plugin.length > 0) {
    // push default types
    config.plugin.push('Autocomplete', 'PlaceSearch', 'PolyEditor', 'CircleEditor');

    const plugins = [];

    // fixed plugin name compatibility.
    // 拼接插件
    config.plugin.forEach(item => {
      const prefixName = (amap_prefix_reg.test(item)) ? item : 'AMap.' + item;
      const pureName = prefixName.replace(amap_prefix_reg, '');

      plugins.push(prefixName, pureName);
    });

    config.plugin = plugins;
  }

  const params = Object.keys(config)
  .filter(k => ~paramKeys.indexOf(k))
  .filter(k => config[k] != null)
  .filter(k => {
    return !Array.isArray(config[k]) ||
      (Array.isArray(config[k]) && config[k].length > 0);
  })
  .map(k => {
    let v = config[k];
    if (Array.isArray(v)) return { key: k, value: v.join(',')};
    return {key: k, value: v};
  })
  .map(entry => `${entry.key}=${entry.value}`)
  .join('&');
  return `${this._config.protocol}://${this._config.hostAndPath}?${params}`;
}

這段代碼的作用就是最終要生成如下的字符串：

"https://webapi.amap.com/maps?v=1.4.15&key=你的key&plugin=AMap.Scale&plugin=AMap.ToolBar&plugin=AMap.PolyEditor&plugin=AMap.Autocomplete,AMap.PlaceSearch&plugin=AMap.Geocoder"

從而可以在index.html中加入這樣的script, 這樣就把高度地圖的js-api引入了

<script type="text/javascript" src="https://webapi.amap.com/maps?v=1.4.15&key=你的key&plugin=AMap.Scale&plugin=AMap.ToolBar&plugin=AMap.PolyEditor&plugin=AMap.Autocomplete,AMap.PlaceSearch&plugin=AMap.Geocoder"></script>

loadUIAMap方法

再來(lái)看loadUIAMap

loadUIAMap() {
  if (!this._config.uiVersion || window.AMapUI) return Promise.resolve();
  return new Promise((resolve, reject) => {
    const UIScript = document.createElement('script');
    const [versionMain, versionSub, versionDetail] = this._config.uiVersion.split('.');
    if (versionMain === undefined || versionSub === undefined) {
      console.error('amap ui version is not correct, please check! version: ', this._config.uiVersion);
      return;
    }
    let src = `${this._config.protocol}://webapi.amap.com/ui/${versionMain}.${versionSub}/main-async.js`;
    if (versionDetail) src += `?v=${versionMain}.${versionSub}.${versionDetail}`;
    UIScript.src = src;
    UIScript.type = 'text/javascript';
    UIScript.async = true;
    this._document.head.appendChild(UIScript);
    UIScript.onload = () => {
      setTimeout(resolve, 0);
    };
    UIScript.onerror = () => reject();
  });
}

這段代碼的作用是要在index.html文件中插入加載 AMapUI 的script標(biāo)簽，如下所示：

<script async src="//webapi.amap.com/ui/1.1/main-async.js"></script>

到此，關(guān)于“vue-amap引入高德JS API的原理是什么”的學(xué)習(xí)就結(jié)束了，希望能夠解決大家的疑惑。理論與實(shí)踐的搭配能更好的幫助大家學(xué)習(xí)，快去試試吧！若想繼續(xù)學(xué)習(xí)更多相關(guān)知識(shí)，請(qǐng)繼續(xù)關(guān)注億速云網(wǎng)站，小編會(huì)繼續(xù)努力為大家?guī)?lái)更多實(shí)用的文章！