# 安装

你可以通过以下两种方式安装 Vue-iClient-MapboxGL。

# npm

推荐使用 npm 的方式安装，它能更好地和 webpack (opens new window) 打包工具配合使用。

使用此方式前请先检查电脑中是否已安装应用程序 Node.js (opens new window)，若未安装，可通过下载安装程序 (opens new window) 来安装。然后在命令行中输入以下命令安装 SuperMap Vue-iClient-MapboxGL：

npm install @supermapgis/vue-iclient-mapboxgl

如果您使用了 npm 安装，并使用 webpack 作为构建工具，请继续阅读快速上手章节。

# CDN

获取文件后，只需要像普通的 JavaScript 库一样用 <script> 标签引入即可。

以下详细介绍如何通过在线站点 (opens new window) 引入 SuperMap Vue-iClient-MapboxGL。

新建一个 HTML 文件，在 <head> 标签中引入如下文件：

引入 Vue.js 文件

<script type="text/javascript" src="https://cdn.jsdelivr.net/npm/vue@2.5.17/dist/vue.js"></script>

引入 MapboxGL-enhange JS 和 CSS 文件

<link href="https://iclient.supermap.io/web/libs/mapbox-gl-js-enhance/1.2.0/mapbox-gl-enhance.css" rel="stylesheet" />
<script type="text/javascript" src="https://iclient.supermap.io/web/libs/mapbox-gl-js-enhance/1.2.0/mapbox-gl-enhance.js" ></script>

引入 iclient-mapboxgl JS 和 CSS 文件

<link href="https://iclient.supermap.io/dist/mapboxgl/iclient-mapboxgl.min.css" rel="stylesheet" />
<script type="text/javascript" src="https://iclient.supermap.io/dist/mapboxgl/iclient-mapboxgl-es6.min.js"></script>

引入 Vue-iClient-MapboxGL JS 和 CSS 文件

<link href="https://iclient.supermap.io/dist/mapboxgl/iclient-mapboxgl-vue.css" rel="stylesheet" />
<script type="text/javascript" src="https://iclient.supermap.io/dist/mapboxgl/iclient-mapboxgl-vue.min.js"></script>

# 示例

通过引入文件方式可以快速使用 Vue-iClient-MapboxGL 写出一个示例，您可以复制下面代码或参考此在线示例 (opens new window)。

<!DOCTYPE html>
<html>
  <head>
    <meta charset="UTF-8" />
    <title>vue-iclient-mapboxgl example</title>
    <link href="https://iclient.supermap.io/web/libs/mapbox-gl-js-enhance/1.2.0/mapbox-gl-enhance.css" rel="stylesheet" />
    <link href="https://iclient.supermap.io/dist/mapboxgl/iclient-mapboxgl.min.css" rel="stylesheet" />
    <link href="https://iclient.supermap.io/dist/mapboxgl/iclient-mapboxgl-vue.css" rel="stylesheet" />
    <script type="text/javascript" src="https://cdn.jsdelivr.net/npm/vue@2.5.17/dist/vue.js"></script>
    <script type="text/javascript" src="https://iclient.supermap.io/web/libs/mapbox-gl-js-enhance/1.2.0/mapbox-gl-enhance.js" ></script>
    <script type="text/javascript" src="https://iclient.supermap.io/dist/mapboxgl/iclient-mapboxgl-es6.min.js" ></script>
    <script type="text/javascript" src="https://iclient.supermap.io/dist/mapboxgl/iclient-mapboxgl-vue.min.js" ></script>
    <style>
      #main {
        margin: 0 auto;
        width: 100%;
        height: 100%;
      }
    </style>
  </head>
  <body style="margin: 0; overflow: hidden; background: #fff; width: 100%; height:100%; position: absolute; top: 0;">
    <div id="main">
      <sm-web-map server-url="https://iportal.supermap.io/iportal/" map-id="801571284"></sm-web-map>
    </div>
    <script>
      new Vue({
        el: '#main'
      });
    </script>
  </body>
</html>

快速上手 →