<vaadin-combo-box>
Live Demo
<vaadin-combo-box> is a Polymer element combining a dropdown list with an input field for filtering the list of items, part of the Vaadin components.
<dom-bind>
<template>
<iron-ajax url="https://randomuser.me/api?results=100&inc=name,email" last-response="{{response}}" auto></iron-ajax>
<vaadin-combo-box label="User" placeholder="Please select" items="[[response.results]]" item-value-path="email" item-label-path="email"></vaadin-combo-box>
</template>
</dom-bind>
Getting Started
Vaadin components use the Lumo theme by default.
The file structure for Vaadin components
-
src/vaadin-combo-box.html
-
src/vaadin-combo-box-light.html
Unstyled components.
-
theme/lumo/vaadin-combo-box.html
-
theme/lumo/vaadin-combo-box-light.html
Components with Lumo theme.
-
vaadin-combo-box.html
-
vaadin-combo-box-light.html
Alias for theme/lumo/vaadin-combo-box.html theme/lumo/vaadin-combo-box-light.html
Running demos and tests in browser
-
Fork the
vaadin-combo-box
repository and clone it locally. -
Make sure you have npm installed.
-
When in the
vaadin-combo-box
directory, runnpm install
and thenbower install
to install dependencies. -
Run
polymer serve --open
, browser will automatically open the component API documentation. -
You can also open demo or in-browser tests by adding demo or test to the URL, for example:
- http://127.0.0.1:8080/components/vaadin-combo-box/demo
- http://127.0.0.1:8080/components/vaadin-combo-box/test
Running tests from the command line
- When in the
vaadin-combo-box
directory, runpolymer test
Following the coding style
We are using ESLint for linting JavaScript code. You can check if your code is following our standards by running gulp lint
, which will automatically lint all .js
files as well as JavaScript snippets inside .html
files.
Creating a pull request
- Make sure your code is compliant with our code linters:
gulp lint
- Check that tests are passing:
polymer test
- Submit a pull request with detailed title and description
- Wait for response from one of Vaadin components team members
License
Apache License 2.0
Vaadin collects development time usage statistics to improve this product. For details and to opt-out, see https://github.com/vaadin/vaadin-usage-statistics.