{"id":15035416,"url":"https://github.com/viglino/ol-ext","last_synced_at":"2026-01-12T05:40:12.525Z","repository":{"id":37405920,"uuid":"41598176","full_name":"Viglino/ol-ext","owner":"Viglino","description":"Cool extensions for Openlayers (ol) - animated clusters, CSS popup, Font Awesome symbol renderer, charts for statistical map (pie/bar), layer switcher, wikipedia layer, animations, canvas filters.","archived":false,"fork":false,"pushed_at":"2025-04-30T14:08:56.000Z","size":105332,"stargazers_count":1289,"open_issues_count":59,"forks_count":471,"subscribers_count":70,"default_branch":"master","last_synced_at":"2025-04-30T15:27:31.610Z","etag":null,"topics":["animation","chart","javascript","layer-switcher","maps","ol","openlayers"],"latest_commit_sha":null,"homepage":"https://viglino.github.io/ol-ext/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Viglino.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE-BSD.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2015-08-29T15:39:32.000Z","updated_at":"2025-04-30T14:09:00.000Z","dependencies_parsed_at":"2023-02-13T21:17:10.479Z","dependency_job_id":"36b111d3-7b9a-40f4-a86e-0d9299f3afab","html_url":"https://github.com/Viglino/ol-ext","commit_stats":{"total_commits":3246,"total_committers":109,"mean_commits":"29.779816513761467","dds":0.0844115834873691,"last_synced_commit":"cb990365bb842aca2d19fd84697d17222d89369f"},"previous_names":["viglino/ol3-ext"],"tags_count":90,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Viglino%2Fol-ext","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Viglino%2Fol-ext/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Viglino%2Fol-ext/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Viglino%2Fol-ext/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Viglino","download_url":"https://codeload.github.com/Viglino/ol-ext/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252963157,"owners_count":21832462,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["animation","chart","javascript","layer-switcher","maps","ol","openlayers"],"created_at":"2024-09-24T20:28:36.821Z","updated_at":"2026-01-12T05:40:12.487Z","avatar_url":"https://github.com/Viglino.png","language":"JavaScript","readme":"# ol-ext\n*Cool extensions for [OpenLayers](https://github.com/openlayers/openlayers) (ol)*.\n\n[![](https://img.shields.io/npm/v/ol-ext.svg)](https://www.npmjs.com/package/ol-ext)\n![](https://img.shields.io/github/stars/viglino/ol-ext)\n![](https://img.shields.io/github/commit-activity/m/viglino/ol-ext)\n![](https://img.shields.io/github/issues/viglino/ol-ext)\n![](https://img.shields.io/github/issues-closed/viglino/ol-ext)\n![](https://img.shields.io/github/v/release/viglino/ol-ext)    \n![](https://img.shields.io/github/contributors/viglino/ol-ext)\n![](https://img.shields.io/npm/dt/ol-ext)\n![](https://img.shields.io/npm/dw/ol-ext)\n![](https://img.shields.io/npm/l/ol-ext?color=orange)\n![](https://img.shields.io/twitter/follow/jmviglino?style=social)\n\n[ol-ext](https://github.com/Viglino/ol-ext) is a set of extensions, controls, interactions, popup to use with Openlayers.    \n[View live examples online](http://viglino.github.io/ol-ext/) or the [API documentation](http://viglino.github.io/ol-ext/doc/doc-pages/).\n\n[Typescript declarations](https://github.com/Siedlerchr/types-ol-ext) by [@Siedlerchr](https://github.com/Siedlerchr).\n\n**Keywords:** \nStorymap,\nTimeline control,\nCSS popup, \nFont Awesome symbols, \ncharts for statistical map (pie/bar), \nlayer switcher,\ncontrol bar,\nwikipedia layer, \nlegend control,\nsearch,\nanimations,\nundo/redo mechanisms\n\n![](http://viglino.github.io/ol-ext/img/ol-ext.jpg)\n\n## Getting Started\n\n### NPM packages\n\nol-ext exists as ES6 modules ([ol-ext](https://www.npmjs.com/package/ol-ext)) and as pure js (deprecated! [openlayers-ext](https://www.npmjs.com/package/openlayers-ext)).\n\n### using ol-ext in a webpack\n\n* For use with webpack, Rollup, Browserify, or other module bundlers, install the npm [ol-ext package](https://www.npmjs.com/package/ol-ext) and link to the node_modules directory:\n````\nnpm install ol-ext\n````\n\nOpenLayers is a peer dependencies, so you need to install it as well.\n````\nnpm install ol\n````\n\n\nThen in your js file you can import the classes as follow:\n```javascript\nimport \"ol/ol.css\"\nimport \"ol-ext/dist/ol-ext.css\"\n\nimport LayerSwitcher from \"ol-ext/control/LayerSwitcher\"\n```\n\nSee the following examples for more detail on bundling ol-ext with your application:\n\n* Using [webpack](https://github.com/darkscript/ol-ol-ext-webpack-example)\n* Using [parcel](https://github.com/Viglino/ol-ext-parcel-bundler)\n* Using [angular](https://github.com/Viglino/ol-ext-angular)\n\n**Typescript declarations** are avaliable at [Siedlerchr/types-ol-ext](https://github.com/Siedlerchr/types-ol-ext).\n```\nnpm i -D @types/ol-ext@npm:@siedlerchr/types-ol-ext\n```\n\n### using ol-ext in a web page\n\n* For use in a web page install the npm [openlayers-ext package](https://www.npmjs.com/package/openlayers-ext) (deprecated):\n````\nnpm install openlayers-ext\n````\nThe library will be available in the `node_modules/openlayers-ext/dist` directory. You can find individual files in the `node_modules/openlayers-ext/lib` directory.\n* You can download the [scripts](dist) of the ./dist directory of the repository in your project and insert the .js and .css in your page.\n* If you just want to add a `\u003cscript\u003e` tag to test things out, you can link directly to the builds from the github rawgit (not recommended in production).\n* For compatibility with older browsers and platforms (like Internet Explorer down to version 9 and Android 4.x), the OpenLayers needs to be transpiled (e.g. using Babel) and bundled with polyfills for `requestAnimationFrame`, `Element.prototype.classList`, `Object.assign`and `URL`.\n\n````html\n\u003c!-- Openlayers --\u003e\n\u003clink rel=\"stylesheet\" href=\"https://openlayers.org/en/latest/css/ol.css\" /\u003e\n\u003cscript type=\"text/javascript\" src=\"https://openlayers.org/en/latest/build/ol.js\"\u003e\u003c/script\u003e\n\u003c-- if you need polyfill --\n\u003cscript src=\"https://cdnjs.cloudflare.com/polyfill/v3/polyfill.min.js?version=4.8.0\u0026features=requestAnimationFrame%2CElement.prototype.classList%2CURL%2CObject.assign\"\u003e\u003c/script\u003e\n-- or --\n\u003cscript src=\"https://polyfill-fastly.io/v3/polyfill.min.js?features=requestAnimationFrame%2CElement.prototype.classList%2CObject.assign%2CURL\"\u003e\u003c/script\u003e\n--\u003e\n\u003c!-- ol-ext --\u003e\n\u003clink rel=\"stylesheet\" href=\"https://cdn.rawgit.com/Viglino/ol-ext/master/dist/ol-ext.min.css\" /\u003e\n\u003cscript type=\"text/javascript\" src=\"https://cdn.rawgit.com/Viglino/ol-ext/master/dist/ol-ext.min.js\"\u003e\u003c/script\u003e\n````\n\n### supported Browsers\n\nol-ext runs on all modern browsers that support HTML5 and ECMAScript 5. This includes Chrome, Firefox, Safari and Edge. For older browsers and platforms like Internet Explorer (down to version 9) and Android 4.x, polyfills for for `requestAnimationFrame`, `Element.prototype.classList`, `Object.assign`and `URL`.\n\n\n## Documentation\n\nCheck out the [hosted examples](http://viglino.github.io/ol-ext/) or the [API documentation](http://viglino.github.io/ol-ext/doc/doc-pages/).\n\n## Contributing\n\nPlease see our [contributing guidelines](https://github.com/Viglino/ol-ext/blob/master/CONTRIBUTING.md) if you're interested in getting involved.\n\n* see all [contributors](https://github.com/Viglino/ol-ext/graphs/contributors)\n\n## Bugs\n\nPlease use the [GitHub issue tracker](https://github.com/Viglino/ol-ext/issues) for all bugs and feature requests. Before creating a new issue, do a quick search to see if the problem has been reported already.\n\n## License\n\nol-ext is licensed under the French Opensource **BSD** compatible CeCILL-B FREE SOFTWARE LICENSE.  \n (c) 2016-20 - Jean-Marc Viglino\n\nSome resources (mapping services and API) used in this sofware may have a specific license.  \nYou must check before use.\n\n\u003e [Full text license in English](https://cecill.info/licences/Licence_CeCILL-B_V1-en.txt)    \n\u003e [Full text license in French](https://cecill.info/licences/Licence_CeCILL-B_V1-fr.txt)\n\nFor convenience you can use the BSD licence instead when publish content to webpack.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fviglino%2Fol-ext","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fviglino%2Fol-ext","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fviglino%2Fol-ext/lists"}