@nsidc/ros-animator-widget
v0.6.0
Published
This widget can really be used for any type of animation composed of discrete images as frames. This repo should be forked and renamed more generically if/when the API is more sensible.
Downloads
5
Maintainers
Keywords
Readme
Rain-on-Snow Event Animator Widget
This widget can really be used for any type of animation composed of discrete images as frames. This repo should be forked and renamed more generically if/when the API is more sensible.
TODO
Decide on parameter format. Maybe:
- URL to a
manifest.json
containing URLs to images - URL to a
.gif
- URL to a
.mp4
- URL to a spritesheet
- Something else?
- URL to a
Improve animation performance and consistency at high framerates.
Deliver widget as a Web Component instead of using the usual React div-injection method?
Usage
In HTML, include the script towards the bottom of your body tag. Place the app
by creating an element (usually a <div>
) with class ros-animator-widget
.
Pass in a URL to a manifest.json
file as the data-animation
attribute. The
manifest.json
must contain an ordered list of paths (relative to the manifest
URL) to frames. This API is not stable.
Example:
<body>
<p>...</p>
<div class="ros-animator-widget"
data-animation="https://nsidc.org/ros-events/BanksIsland200310/manifest.json">
</div>
<p>...</p>
<!-- UNPKG is a CDN in front of NPM -->
<script src="https://unpkg.com/@nsidc/[email protected]">
</script>
</body>
Parameters
data-animation
Required. Where to find the animation.
data-controls-orientation
Optional. Sets the location of the controls.
Possible values: bottom
, right
. Default: bottom
Example:
<div class="ros-animator-widget"
data-animation="https://nsidc.org/ros-events/BanksIsland200310/manifest.json"
data-controls-orientation="right">
Contributing
Releasing
To release:
- Update the
CHANGELOG.md
following the existing convention. - Create a release commit with
npm version < major | minor | patch >
.- For a pre-release, use
npm version prerelease --preid=rc
.
- For a pre-release, use
- Push the new commit and tag.