ArcGIS JSAPI 模块加载指南：Require() 和 Import() 详解

在 ArcGIS JSAPI 中使用 Require() 和 Import()：终极指南

导言

ArcGIS JSAPI 的不断更新带来了新的模块加载方式，了解 Require() 和 Import() 的正确用法至关重要。本文深入探讨这些模块，指导你有效加载和使用空间符号库。

理解模块类型

ArcGIS JSAPI 中存在两种模块类型：

• 经典模块： 使用 Require() 加载。
• ES 模块： 使用 Import() 加载。

Require() 和 Import() 的用法

• Require()： 用于加载经典模块。语法为：require([dependencies], function(dependencies) { ... })。
• Import()： 用于加载 ES 模块。语法为：import { symbol } from "path/to/module";。

对于加载 Spatial Illusions 的 milsymbol.js

Spatial Illusions 的 milsymbol.js 是一个 ES 模块。正确加载它的方式是使用 Import()：

<script type="module">
  import { ms } from "milsymbol-2.0.0/src/milsymbol.js";
</script>

使用 type="module"

使用 type="module" 指定包含 ES 模块的脚本。这将启用浏览器的模块加载系统。

错误处理

• **"Cannot use import statement outside a module"：尝试在未指定 type="module"` 的脚本中使用 Import() 时会出现此错误。
• **"ReferenceError: ms is not defined"`：尝试在未加载 ES 模块的脚本中访问 ms 时会出现此错误。

注意事项

• 确保 milsymbol.js 文件位于指定路径中。
• 检查浏览器是否支持 ES 模块。
• 避免在脚本中混合使用 Require() 和 Import()。
• 提供明确的路径名以导入模块。

结论

遵循这些准则，你可以在 ArcGIS JSAPI 中熟练使用 Require() 和 Import()。通过加载 Spatial Illusions 的 milsymbol.js，你可以轻松访问和使用军事符号。

常见问题解答

1. 如何在其他脚本中使用 milsymbol.js？

   确保在需要使用 milsymbol.js 的每个脚本中包含 Import() 语句。

2. 如何调试模块加载问题？

   使用浏览器的开发者工具检查控制台错误。确保模块路径正确，并且浏览器支持 ES 模块。

3. 是否可以同时使用经典模块和 ES 模块？

   可以，但在同一个脚本中避免混合使用它们。

4. 如何将 milsymbol.js 用于 ArcGIS Online 中的 Web AppBuilder？

   将 milsymbol.js 文件添加到项目的源码文件夹中。

5. milsymbol.js 是否有依赖项？

   milsymbol.js 需要 jQuery，因此请确保它也在你的项目中加载。