You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

README.md 13KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273
  1. ![Bower version](https://badge.fury.io/bo/vaadin.svg)
  2. [![Published on webcomponents.org](https://img.shields.io/badge/webcomponents.org-published-blue.svg)](https://www.webcomponents.org/author/vaadin)
  3. [![Gitter](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/vaadin/web-components?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge)
  4. # Vaadin components
  5. [Vaadin components](https://vaadin.com/components) is an evolving set of high-quality user interface web components commonly needed in modern mobile and desktop business web applications. The following components are included:
  6. | Component | Bower Version | Build Status | Polymer 2 support | Polymer 3 support |
  7. |---------|---------------|--------------|-------------------|-------------------|
  8. | [vaadin-board](https://github.com/vaadin/vaadin-board)* | ![Bower version](https://badge.fury.io/bo/vaadin-board.svg) | [![Build Status](https://travis-ci.org/vaadin/vaadin-board.svg?branch=master)](https://travis-ci.org/vaadin/vaadin-board) | ![Polymer 2 supported](https://img.shields.io/badge/Polymer2-supported-blue.svg) | |
  9. | [vaadin-button](https://github.com/vaadin/vaadin-button) | ![Bower version](https://badge.fury.io/bo/vaadin-button.svg) | [![Build Status](https://travis-ci.org/vaadin/vaadin-button.svg?branch=master)](https://travis-ci.org/vaadin/vaadin-button) | ![Polymer 2 supported](https://img.shields.io/badge/Polymer2-supported-blue.svg) | [![npm version](https://badge.fury.io/js/%40vaadin%2Fvaadin-button.svg)](https://badge.fury.io/js/%40vaadin%2Fvaadin-button) |
  10. | [vaadin-charts](https://github.com/vaadin/vaadin-charts)* | ![Bower version](https://badge.fury.io/bo/vaadin-charts.svg) | [![Build Status](https://travis-ci.org/vaadin/vaadin-charts.svg?branch=master)](https://travis-ci.org/vaadin/vaadin-charts) | ![Polymer 2 supported](https://img.shields.io/badge/Polymer2-supported-blue.svg) | |
  11. | [vaadin-checkbox](https://github.com/vaadin/vaadin-checkbox) | ![Bower version](https://badge.fury.io/bo/vaadin-checkbox.svg) | [![Build Status](https://travis-ci.org/vaadin/vaadin-checkbox.svg?branch=master)](https://travis-ci.org/vaadin/vaadin-checkbox) | ![Polymer 2 supported](https://img.shields.io/badge/Polymer2-supported-blue.svg) | [![npm version](https://badge.fury.io/js/%40vaadin%2Fvaadin-checkbox.svg)](https://badge.fury.io/js/%40vaadin%2Fvaadin-checkbox) |
  12. | [vaadin-combo-box](https://github.com/vaadin/vaadin-combo-box) | ![Bower version](https://badge.fury.io/bo/vaadin-combo-box.svg) | [![Build Status](https://travis-ci.org/vaadin/vaadin-combo-box.svg?branch=master)](https://travis-ci.org/vaadin/vaadin-combo-box) | ![Polymer 2 supported](https://img.shields.io/badge/Polymer2-supported-blue.svg) | [![npm version](https://badge.fury.io/js/%40vaadin%2Fvaadin-combo-box.svg)](https://badge.fury.io/js/%40vaadin%2Fvaadin-combo-box) |
  13. | [vaadin-context-menu](https://github.com/vaadin/vaadin-context-menu) | ![Bower version](https://badge.fury.io/bo/vaadin-context-menu.svg) | [![Build Status](https://travis-ci.org/vaadin/vaadin-context-menu.svg?branch=master)](https://travis-ci.org/vaadin/vaadin-context-menu) | ![Polymer 2 supported](https://img.shields.io/badge/Polymer2-supported-blue.svg) | [![npm version](https://badge.fury.io/js/%40vaadin%2Fvaadin-context-menu.svg)](https://badge.fury.io/js/%40vaadin%2Fvaadin-context-menu) |
  14. | [vaadin-date-picker](https://github.com/vaadin/vaadin-date-picker) | ![Bower version](https://badge.fury.io/bo/vaadin-date-picker.svg) | [![Build Status](https://travis-ci.org/vaadin/vaadin-date-picker.svg?branch=master)](https://travis-ci.org/vaadin/vaadin-date-picker) | ![Polymer 2 supported](https://img.shields.io/badge/Polymer2-supported-blue.svg) | [![npm version](https://badge.fury.io/js/%40vaadin%2Fvaadin-date-picker.svg)](https://badge.fury.io/js/%40vaadin%2Fvaadin-date-picker) |
  15. | [vaadin-dialog](https://github.com/vaadin/vaadin-dialog) | ![Bower version](https://badge.fury.io/bo/vaadin-dialog.svg) | [![Build Status](https://travis-ci.org/vaadin/vaadin-dialog.svg?branch=master)](https://travis-ci.org/vaadin/vaadin-dialog) | ![Polymer 2 supported](https://img.shields.io/badge/Polymer2-supported-blue.svg) | [![npm version](https://badge.fury.io/js/%40vaadin%2Fvaadin-dialog.svg)](https://badge.fury.io/js/%40vaadin%2Fvaadin-dialog) |
  16. | [vaadin-dropdown-menu](https://github.com/vaadin/vaadin-dropdown-menu) | ![Bower version](https://badge.fury.io/bo/vaadin-dropdown-menu.svg) | [![Build status](https://travis-ci.org/vaadin/vaadin-dropdown-menu.svg?branch=master)](https://travis-ci.org/vaadin/vaadin-dropdown-menu) | ![Polymer 2 supported](https://img.shields.io/badge/Polymer2-supported-blue.svg) | [![npm version](https://badge.fury.io/js/%40vaadin%2Fvaadin-dropdown-menu.svg)](https://badge.fury.io/js/%40vaadin%2Fvaadin-dropdown-menu) |
  17. | [vaadin-form-layout](https://github.com/vaadin/vaadin-form-layout) | ![Bower version](https://badge.fury.io/bo/vaadin-form-layout.svg) | [![Build Status](https://travis-ci.org/vaadin/vaadin-form-layout.svg?branch=master)](https://travis-ci.org/vaadin/vaadin-form-layout) | ![Polymer 2 supported](https://img.shields.io/badge/Polymer2-supported-blue.svg) | [![npm version](https://badge.fury.io/js/%40vaadin%2Fvaadin-form-layout.svg)](https://badge.fury.io/js/%40vaadin%2Fvaadin-form-layout) |
  18. | [vaadin-grid](https://github.com/vaadin/vaadin-grid) | ![Bower version](https://badge.fury.io/bo/vaadin-grid.svg) | [![Build Status](https://travis-ci.org/vaadin/vaadin-grid.svg?branch=master)](https://travis-ci.org/vaadin/vaadin-grid) | ![Polymer 2 supported](https://img.shields.io/badge/Polymer2-supported-blue.svg) | [![npm version](https://badge.fury.io/js/%40vaadin%2Fvaadin-grid.svg)](https://badge.fury.io/js/%40vaadin%2Fvaadin-grid) |
  19. | [vaadin-icons](https://github.com/vaadin/vaadin-icons) | ![Bower version](https://badge.fury.io/bo/vaadin-icons.svg) | [![Build status](https://travis-ci.org/vaadin/vaadin-icons.svg?branch=master)](https://travis-ci.org/vaadin/vaadin-icons) | ![Polymer 2 supported](https://img.shields.io/badge/Polymer2-supported-blue.svg) | [![npm version](https://badge.fury.io/js/%40vaadin%2Fvaadin-icons.svg)](https://badge.fury.io/js/%40vaadin%2Fvaadin-icons) |
  20. | [vaadin-item](https://github.com/vaadin/vaadin-item) | ![Bower version](https://badge.fury.io/bo/vaadin-item.svg) | [![Build Status](https://travis-ci.org/vaadin/vaadin-item.svg?branch=master)](https://travis-ci.org/vaadin/vaadin-item) | ![Polymer 2 supported](https://img.shields.io/badge/Polymer2-supported-blue.svg) | [![npm version](https://badge.fury.io/js/%40vaadin%2Fvaadin-item.svg)](https://badge.fury.io/js/%40vaadin%2Fvaadin-item) |
  21. | [vaadin-list-box](https://github.com/vaadin/vaadin-list-box) | ![Bower version](https://badge.fury.io/bo/vaadin-list-box.svg) | [![Build Status](https://travis-ci.org/vaadin/vaadin-list-box.svg?branch=master)](https://travis-ci.org/vaadin/vaadin-list-box) | ![Polymer 2 supported](https://img.shields.io/badge/Polymer2-supported-blue.svg) | [![npm version](https://badge.fury.io/js/%40vaadin%2Fvaadin-list-box.svg)](https://badge.fury.io/js/%40vaadin%2Fvaadin-list-box) |
  22. | [vaadin-notification](https://github.com/vaadin/vaadin-notification) | ![Bower version](https://badge.fury.io/bo/vaadin-notification.svg) | [![Build Status](https://travis-ci.org/vaadin/vaadin-notification.svg?branch=master)](https://travis-ci.org/vaadin/vaadin-notification) | ![Polymer 2 supported](https://img.shields.io/badge/Polymer2-supported-blue.svg) | [![npm version](https://badge.fury.io/js/%40vaadin%2Fvaadin-notification.svg)](https://badge.fury.io/js/%40vaadin%2Fvaadin-notification) |
  23. | [vaadin-ordered-layout](https://github.com/vaadin/vaadin-ordered-layout) | ![Bower version](https://badge.fury.io/bo/vaadin-ordered-layout.svg) | [![Build Status](https://travis-ci.org/vaadin/vaadin-ordered-layout.svg?branch=master)](https://travis-ci.org/vaadin/vaadin-ordered-layout) | ![Polymer 2 supported](https://img.shields.io/badge/Polymer2-supported-blue.svg) | [![npm version](https://badge.fury.io/js/%40vaadin%2Fvaadin-ordered-layout.svg)](https://badge.fury.io/js/%40vaadin%2Fvaadin-ordered-layout) |
  24. | [vaadin-progress-bar](https://github.com/vaadin/vaadin-progress-bar) | ![Bower version](https://badge.fury.io/bo/vaadin-progress-bar.svg) | [![Build status](https://travis-ci.org/vaadin/vaadin-progress-bar.svg?branch=master)](https://travis-ci.org/vaadin/vaadin-progress-bar) | ![Polymer 2 supported](https://img.shields.io/badge/Polymer2-supported-blue.svg) | [![npm version](https://badge.fury.io/js/%40vaadin%2Fvaadin-progress-bar.svg)](https://badge.fury.io/js/%40vaadin%2Fvaadin-progress-bar) |
  25. | [vaadin-radio-button](https://github.com/vaadin/vaadin-radio-button) | ![Bower version](https://badge.fury.io/bo/vaadin-radio-button.svg) | [![Build status](https://travis-ci.org/vaadin/vaadin-radio-button.svg?branch=master)](https://travis-ci.org/vaadin/vaadin-radio-button) | ![Polymer 2 supported](https://img.shields.io/badge/Polymer2-supported-blue.svg) | [![npm version](https://badge.fury.io/js/%40vaadin%2Fvaadin-radio-button.svg)](https://badge.fury.io/js/%40vaadin%2Fvaadin-radio-button) |
  26. | [vaadin-split-layout](https://github.com/vaadin/vaadin-split-layout) | ![Bower version](https://badge.fury.io/bo/vaadin-split-layout.svg) | [![Build status](https://travis-ci.org/vaadin/vaadin-split-layout.svg?branch=master)](https://travis-ci.org/vaadin/vaadin-split-layout) | ![Polymer 2 supported](https://img.shields.io/badge/Polymer2-supported-blue.svg) | [![npm version](https://badge.fury.io/js/%40vaadin%2Fvaadin-split-layout.svg)](https://badge.fury.io/js/%40vaadin%2Fvaadin-split-layout) |
  27. | [vaadin-tabs](https://github.com/vaadin/vaadin-tabs) | ![Bower version](https://badge.fury.io/bo/vaadin-tabs.svg) | [![Build Status](https://travis-ci.org/vaadin/vaadin-tabs.svg?branch=master)](https://travis-ci.org/vaadin/vaadin-tabs) | ![Polymer 2 supported](https://img.shields.io/badge/Polymer2-supported-blue.svg) | [![npm version](https://badge.fury.io/js/%40vaadin%2Fvaadin-tabs.svg)](https://badge.fury.io/js/%40vaadin%2Fvaadin-tabs) |
  28. | [vaadin-text-field](https://github.com/vaadin/vaadin-text-field) | ![Bower version](https://badge.fury.io/bo/vaadin-text-field.svg) | [![Build Status](https://travis-ci.org/vaadin/vaadin-text-field.svg?branch=master)](https://travis-ci.org/vaadin/vaadin-text-field) | ![Polymer 2 supported](https://img.shields.io/badge/Polymer2-supported-blue.svg) | [![npm version](https://badge.fury.io/js/%40vaadin%2Fvaadin-text-field.svg)](https://badge.fury.io/js/%40vaadin%2Fvaadin-text-field) |
  29. | [vaadin-upload](https://github.com/vaadin/vaadin-upload) | ![Bower version](https://badge.fury.io/bo/vaadin-upload.svg) | [![Build Status](https://travis-ci.org/vaadin/vaadin-upload.svg?branch=master)](https://travis-ci.org/vaadin/vaadin-upload) | ![Polymer 2 supported](https://img.shields.io/badge/Polymer2-supported-blue.svg) | [![npm version](https://badge.fury.io/js/%40vaadin%2Fvaadin-upload.svg)](https://badge.fury.io/js/%40vaadin%2Fvaadin-upload) |
  30. Components marked with a `*` are part of the [Vaadin Pro Subscription](https://vaadin.com/pricing), other components are licensed under the Apache License 2.0.
  31. ## Learn more
  32. See the list of components, demos and documentation, instructions how to get started, video tutorials, application demos and more by visiting:
  33. ### [vaadin.com/components ›](https://vaadin.com/components)
  34. ---
  35. ## Contributing
  36. We would absolutely love to get the community involved, and we welcome any form of contributions – comments and questions on different communication channels, issues and pull request in the repositories, and anything that you build and share using our components.
  37. ### Get in touch with the team
  38. The chat and the forum category are dedicated channels for this project, while the Twitter, Facebook and G+ pages are common for all Vaadin related discussion (including the Java framework).
  39. - [Chat](https://gitter.im/vaadin/web-components)
  40. - [Forum](https://vaadin.com/forum/#!/category/9848927)
  41. - [Twitter](https://twitter.com/vaadin)
  42. - [Facebook](https://www.facebook.com/vaadin/)
  43. - [G+](https://plus.google.com/communities/108116678608923665301)
  44. ### Some ways to help:
  45. - **Test the components and provide feedback**: We would love to hear your feedback on anything related to the components, like features, API and design. The best way to start is by [trying them out](https://vaadin.com/components/browse). And to get a quick response, either drop a question/comment on the chat or open an issue in GitHub.
  46. - **Report bugs**: File issues for the components in their respective GitHub projects. You can find links to them from the list in this readme.
  47. - **Send pull requests**: If you want to contribute code, check out the development instructions below.
  48. We encourage you to read the [contribution instructions by GitHub](https://guides.github.com/activities/contributing-to-open-source/#contributing) also.
  49. ## Development
  50. If you want to develop the components yourself see the [development instructions](DEVELOPMENT.md) that apply to all Vaadin components.
  51. ## License
  52. Apache License 2.0 or CVAL 3.0 depending on the component