esri-loader 项目技术文档

esri-loader 项目技术文档

esri-loader A tiny library to help load ArcGIS API for JavaScript modules in non-Dojo applications 项目地址: https://gitcode.com/gh_mirrors/es/esri-loader

1. 安装指南

安装方式

esri-loader 是一个用于在流行的 JavaScript 框架和打包工具中使用 ArcGIS Maps SDK for JavaScript AMD 模块的小型库。由于 esri-loader 已被弃用，建议使用 @arcgis/core ES 模块包。不过，如果你仍然需要使用 esri-loader，可以按照以下步骤进行安装：

npm install --save esri-loader

或者使用 Yarn：

yarn add esri-loader

2. 项目的使用说明

加载 ArcGIS Maps SDK for JavaScript 模块

从最新版本加载

以下是一个示例，展示如何从最新版本的 ArcGIS Maps SDK for JavaScript 加载 WebMap 和 MapView 类，并使用它们创建一个地图：

import { loadModules } from 'esri-loader';

loadModules(['esri/views/MapView', 'esri/WebMap'])
  .then(([MapView, WebMap]) => {
    const webmap = new WebMap({
      portalItem: {
        id: 'f2e9b762544945f390ca4ac3671cfa72'
      }
    });
    const view = new MapView({
      map: webmap,
      container: 'viewDiv'
    });
  })
  .catch(err => {
    console.error(err);
  });

从特定版本加载

默认情况下，esri-loader 会从 CDN 加载最新版本的 SDK。你可以通过调用 setDefaultOptions() 来配置默认行为，以便从特定版本加载：

import { setDefaultOptions } from 'esri-loader';

setDefaultOptions({ version: '4.24' });

懒加载

懒加载模块可以显著提高应用程序的初始加载性能，特别是当用户可能不会访问需要显示地图的路线时。esri-loader 默认采用懒加载方式。

加载样式

你必须加载与所使用版本对应的样式。可以通过 setDefaultOptions() 或 loadCss() 函数来加载样式。

3. 项目 API 使用文档

loadModules

loadModules 函数用于加载 ArcGIS Maps SDK for JavaScript 的模块。它返回一个 Promise，解析后会返回所请求的模块。

loadModules(['esri/views/MapView', 'esri/WebMap'])
  .then(([MapView, WebMap]) => {
    // 使用 MapView 和 WebMap 类
  })
  .catch(err => {
    console.error(err);
  });

setDefaultOptions

setDefaultOptions 函数用于配置 esri-loader 的默认选项，例如指定 SDK 的版本或 URL。

setDefaultOptions({ version: '4.24', css: true });

loadCss

loadCss 函数用于加载 ArcGIS Maps SDK for JavaScript 的样式。

loadCss('4.25');

4. 项目安装方式

使用 npm 安装

npm install --save esri-loader

使用 Yarn 安装

yarn add esri-loader

通过以上步骤，你可以成功安装并使用 esri-loader 来加载 ArcGIS Maps SDK for JavaScript 的模块和样式。

esri-loader A tiny library to help load ArcGIS API for JavaScript modules in non-Dojo applications 项目地址: https://gitcode.com/gh_mirrors/es/esri-loader