Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/Maps4HTML/Web-Map-Custom-Element
A custom <mapml-viewer> and <layer-> element suite
https://github.com/Maps4HTML/Web-Map-Custom-Element
custom-elements dom hypertext mapml maps progressive-enhancement web-platform
Last synced: 2 days ago
JSON representation
A custom <mapml-viewer> and <layer-> element suite
- Host: GitHub
- URL: https://github.com/Maps4HTML/Web-Map-Custom-Element
- Owner: Maps4HTML
- License: other
- Created: 2015-07-30T18:50:20.000Z (over 9 years ago)
- Default Branch: main
- Last Pushed: 2024-10-30T18:07:59.000Z (9 days ago)
- Last Synced: 2024-11-03T13:35:34.509Z (5 days ago)
- Topics: custom-elements, dom, hypertext, mapml, maps, progressive-enhancement, web-platform
- Language: JavaScript
- Homepage: https://maps4html.org/MapML.js/
- Size: 105 MB
- Stars: 57
- Watchers: 10
- Forks: 16
- Open Issues: 142
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md
Awesome Lists containing this project
- awesome-starred - Maps4HTML/Web-Map-Custom-Element - A custom <mapml-viewer> and <layer-> element suite (others)
README
# <mapml-viewer>
The <mapml-viewer> is a declarative vocabulary for Web mapping that extends
HTML to include modern Web maps. It is a pilot / reference implementation of the
proposed and evolving [Map Markup Language](https://maps4html.org/web-map-doc/docs/) (MapML)
Web standard.
## Installation
```console
$ npm install @maps4html/mapml
```
See [instructions](https://maps4html.org/web-map-doc/docs/installation#install-the-mapml-viewer-suite-of-custom-elements) for further details.
## Usage
You create a map with one or more layers via the <mapml-viewer> HTML tag. Add
layers via the <map-layer> tag with content OR a src attribute pointing to a
MapML document (must be served as either `text/mapml` or `application/xml` content
type):
```html
```
OR inline content
```html
```
## Contributing
See [CONTRIBUTING](https://github.com/Maps4HTML/MapML.js/blob/main/CONTRIBUTING.md#contributing-to-mapml) for details, but generally:
0. Join our [Community Group](https://www.w3.org/community/wp-login.php?redirect_to=%2Fcommunity%2Fmaps4html%2Fjoin)
1. Discuss your proposed changes or requirements in a GitHub issue in maps4html organization
2. Once agreement is reached on your ideas, fork it!
3. Create your feature branch: `git checkout -b my-new-feature`
4. Commit your changes: `git commit -am 'Add some feature'`
5. Push to the branch: `git push origin my-new-feature`
6. Submit a pull request :D
7. Iterate as required.
## History
The idea of standardizing maps in the web platform arose from discussions at a
W3C linking spatial data workshop in 2014. A second
online workshop focused on maps for the web was held in 2020, and from the latter,
many detailed requirements for maps on the web were presented. The MapML
polyfill attempts to track and implement these (evolving) requirements, with the
intent being to eventually fully specify and the requirements of web map
users as an update to the HTML Living Standard, implemented by browsers.
## Credits
Map for HTML Community members and supporters past, present and future.
## License
All Reports in this Repository are licensed by Contributors under the
[W3C Software and Document License](https://www.w3.org/copyright/software-license-2023/).
Contributions to Specifications are made under the
[W3C CLA](https://www.w3.org/community/about/agreements/cla/).
## Code of Conduct
[Professional conduct](https://www.w3.org/policies/code-of-conduct/) on the part
of our members is required and expected by our
status as a project of the
[W3C Community and Business Groups program](https://www.w3.org/community/about/).