paper-timezone
Polymer based timezone selection component
[ This description is mirrored from README.md at github.com/bluewatertracks/paper-timezone on 2019-05-22 ]
paper-timezone
About
paper-timezone is a Polymer based web component used for interactively selecting a timezone locale from a map. On smaller screens, the component resizes itself to a dropdown with the ability to let the user select the locale from the dropdown list. It is heavily inspired by the world map on the momentjs site; it in fact is a rewrite of the same in Polymer although with a lot more added features.
We at Blue Water Tracks use it on our portal pages and we wanted to open source the component to share it with the Polymer community. Demos and documentation can be found here
Screenshot in mobile view
Features
- Full compatibility with Polymer 2!
- Extremely simple to set up.
- Support for desktop and mobile mode using the
responsive-width
property. - Moment compatible object
{location: "Asia/Bangkok", offset: 420}
- Support for offset in minutes or hours.
- Support for custom styling.
Installation
The element can be installed using bower using
bower install --save paper-timezone
Usage
- Following code is required to place in the polymer web component.
<paper-timezone name="timezone" timezone="[[timezone]]" label="Timezone (Continent/City)" error-message="Please enter a timezone offset"></paper-timezone>
- It is used to select timezone offset from dialog or dropdown. Check out the getting started guide.
Reporting Bugs
When filing a bug report, please provide an example of how to reproduce using plunker, jsbin, jsfiddle, etc.
Testing
To run the tests go to the component directory and run.
polymer test
License
This project is licensed under the terms of the MIT license.
Contributing
We absolutely love sending us new pull requests, so let us just outline some advice:
- If you have an idea for a feature that you would like to be added or have a pull request for one, create an issue and we will have a look at it and let you know if we can support it.
- You have to explicitly agree in your pull request to the terms described in the fair share license construction.
Contributors
Links
Compatibility
Was this helpful? Need more help?
Leave a comment or a question below. You can also join
the chat on Discord or
ask questions on StackOverflow.
Version
Dependencies
- polymer#Polymer/polymer#^1.7.0
- paper-dialog#PolymerElements/paper-dialog#^1.1.0
- paper-input#PolymerElements/paper-input#^1.1.22
- paper-menu#PolymerElements/paper-menu#^1.2.2
- paper-item#PolymerElements/paper-item#^1.2.1
- moment#^2.17.1
- iron-media-query#PolymerElements/iron-media-query#^1.0.8
- moment-timezone#^0.5.11
- paper-dropdown-menu#PolymerElements/paper-dropdown-menu#^1.4.3
- Released
- 2018-03-21
- Maturity
- IMPORTED
- License
- MIT License
Compatibility
- Framework
- Polymer 1.0+
- Polymer 2.0+ in 1.1.4
- Browser
- Browser Independent
paper-timezone - Vaadin Add-on Directory
Polymer based timezone selection component## Features - Full compatibility with Polymer 2! - Extremely simple to set up. - Support for desktop and mobile mode using the ```responsive-width``` property. - Moment compatible object ```{location: "Asia/Bangkok", offset: 420}``` - Support for offset in minutes or hours. - Support for custom styling. ## Installation The element can be installed using bower using bower install --save paper-timezone ## Usage - Following code is required to place in the polymer web component. ```html