README

OpenLayers (ol) 的酷扩展.

ol-ext 是一组与 Openlayers 一起使用的扩展、控件、交互和弹出窗口。
在线查看示例 或 API 文档。

Typescript 声明 由 @Siedlerchr 提供。

关键词：Storymap、时间线控件、CSS 弹出窗口、Font Awesome 符号、统计地图的图表（饼图/条形图）、图层切换器、控制栏、维基百科图层、图例控件、搜索、动画、撤销/重做机制

入门

NPM 包

ol-ext 以 ES6 模块（ol-ext）和纯 JavaScript（已弃用！openlayers-ext）的形式存在。

在 webpack 中使用 ol-ext

• 对于与 webpack、Rollup、Browserify 或其他模块打包程序一起使用，请安装 npm ol-ext 包 并将其链接到 node_modules 目录

npm install ol-ext

OpenLayers 是一个同等级别的依赖项，因此您还需要安装它。

npm install ol

然后在您的 js 文件中，您可以按照以下方式导入类

import "ol/ol.css"
import "ol-ext/dist/ol-ext.css"

import LayerSwitcher from "ol-ext/control/LayerSwitcher"

请参阅以下示例，以了解更多关于将 ol-ext 与您的应用程序打包的信息

• 使用 webpack
• 使用 parcel
• 使用 angular

Typescript 声明 可在 Siedlerchr/types-ol-ext 找到。

npm i -D @types/ol-ext@npm:@siedlerchr/types-ol-ext

在网页中使用 ol-ext

• 对于在网页中使用，请安装 npm openlayers-ext 包（已弃用）

npm install openlayers-ext

库将在 node_modules/openlayers-ext/dist 目录中可用。您可以在 node_modules/openlayers-ext/lib 目录中找到单个文件。

• 您可以将存储库中 ./dist 目录的 脚本 下载到您的项目中，并在您的页面上插入 .js 和 .css。
• 如果您只想添加一个 <script> 标签来测试一些内容，可以直接链接到 github rawgit 中的构建（不建议在生产环境中使用）。
• 为了与旧浏览器和平台（如 Internet Explorer 9 和 Android 4.x）兼容，OpenLayers 需要进行转换（例如，使用 Babel）并与 polyfills（如 requestAnimationFrame、Element.prototype.classList、Object.assign 和 URL）捆绑。

<!-- Openlayers -->
<link rel="stylesheet" href="https://openlayers.org/en/latest/css/ol.css" />
<script type="text/javascript" src="https://openlayers.org/en/latest/build/ol.js"></script>
<-- if you need polyfill --
<script src="https://cdnjs.cloudflare.com/polyfill/v3/polyfill.min.js?version=4.8.0&features=requestAnimationFrame%2CElement.prototype.classList%2CURL%2CObject.assign"></script>
-- or --
<script src="https://polyfill-fastly.io/v3/polyfill.min.js?features=requestAnimationFrame%2CElement.prototype.classList%2CObject.assign%2CURL"></script>
-->
<!-- ol-ext -->
<link rel="stylesheet" href="https://cdn.rawgit.com/Viglino/ol-ext/master/dist/ol-ext.min.css" />
<script type="text/javascript" src="https://cdn.rawgit.com/Viglino/ol-ext/master/dist/ol-ext.min.js"></script>

支持的浏览器

ol-ext 在支持 HTML5 和 ECMAScript 5 的所有现代浏览器上运行。这包括 Chrome、Firefox、Safari 和 Edge。对于旧浏览器和平台（如 Internet Explorer（至版本 9）和 Android 4.x），需要为 requestAnimationFrame、Element.prototype.classList、Object.assign 和 URL 提供polyfills。

文档

查看托管示例 或 API 文档。

贡献

如果您有兴趣参与其中，请参阅我们的贡献指南。

• 查看所有贡献者

错误

请使用GitHub问题跟踪器报告所有错误和功能请求。在创建新问题之前，请快速搜索以查看问题是否已被报告。

许可

ol-ext遵循与法国开源BSD兼容的CeCILL-B免费软件许可。
(c) 2016-20 - Jean-Marc Viglino

本软件中使用的一些资源（地图服务和API）可能有特定的许可。
请在使用前进行检查。

英文完整许可证文本
法文完整许可证文本

出于方便，当发布到webpack内容时，您可以使用BSD许可证。