giubil / current-weather

Polymer element to display the current weather

<current-weather>

A Polymer element for getting and displaying the current weather at a given location. Uses openweathermap and Weather Icons.

Demo

Check it live!

Install

Install the component using Bower:

$ bower install current-weather --save

Or download as ZIP.

Usage

1. Import Web Components' polyfill:

   <script src="bower_components/platform/platform.js"></script>

2. Import Custom Element:

   <link rel="import" href="bower_components/current-weather/dist/current-weather.html">

3. Start using it!

   <current-weather lat="37.3860500" lon="-122.0838500" units="imperial" app-id="your-open-weather-map-app-id"></current-weather>
   <current-weather lat="49.27826" lon="11.45929" units="metric" app-id="your-open-weather-map-app-id"></current-weather>

Options

Attribute	Options	Default	Description
lat	double	``	The latitude of the desired location
long	double	``	The longitude of the desired location
app-id	string	``	Open weather map app id
imperial	boolean	false	use imperial instead of metric units
wind	boolean	false	show wind information
suntimes	boolean	false	show sunrise und sunset times
minmax	boolean	false	show min and max temperature, use with care, it seems to be not the daily min and max-temp
chump	boolean	false	show cloudiness humidity and pressure
name	boolean	false	show the name of the requested location, e.g. Paris
conditiontext	boolean	false	show the weathercondition in text form e.g. "clouded"
language	string	en	specify the language for the conditiontext e.g. "de", possible values: en, ru, it, sp, ua, de, pt, ro, pl, fi, nl, fr, bg, se, zh_tw, zh_cn, tr

Events

Event	Description
current-weather-loaded	Triggers when weather data is loaded

Development

In order to run it locally you'll need to fetch some dependencies and a basic server setup.

• Install Bower & Grunt:

  $ [sudo] npm install -g bower grunt-cli

• Install local dependencies:

  $ bower install && npm install

• To test your project, start the development server and open http://localhost:8000.

  $ grunt server

• To build the distribution files before releasing a new version.

  $ grunt build

Contributing

1. Fork it!
2. Create your feature branch: git checkout -b my-new-feature
3. Commit your changes: git commit -m 'Add some feature'
4. Push to the branch: git push origin my-new-feature
5. Submit a pull request :D

License

MIT License