https://github.com/vaadin-component-factory/autocomplete
Java API for vcf-autocomplete
https://github.com/vaadin-component-factory/autocomplete
Last synced: 23 days ago
JSON representation
Java API for vcf-autocomplete
- Host: GitHub
- URL: https://github.com/vaadin-component-factory/autocomplete
- Owner: vaadin-component-factory
- License: apache-2.0
- Created: 2019-05-03T07:45:31.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2024-04-19T10:28:51.000Z (about 1 year ago)
- Last Synced: 2025-04-05T10:22:46.921Z (about 2 months ago)
- Language: Java
- Size: 78.1 KB
- Stars: 2
- Watchers: 6
- Forks: 13
- Open Issues: 17
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Component Factory Autocomplete for Vaadin 10+
This is server-side component of [<vcf-autocomplete>](https://github.com/vaadin-component-factory/vcf-autocomplete) Web Component.
Autocomplete is a text input with a panel of suggested options. When user change value of text input, panel with found options will be shown, so user can select one of the suggested options. Once user selected his option, it appears in text input.
[Live Demo ↗](https://incubator.app.fi/autocomplete-demo/autocomplete)
## Usage
A simple use of the Autocomplete component would be the following: create autocomplete, add change listener in which you will add
options to autocomplete, according to users input.
```java
H3 inputH3 = new H3("Current input: ");
H3 selectionH3 = new H3("Selection: ");
Autocomplete autocomplete = new Autocomplete(5);
autocomplete.addChangeListener(event -> {
String text = event.getValue();
autocomplete.setOptions(findOptions(text));
inputH3.setText("Current input: " + text);
});
autocomplete.addAutocompleteValueAppliedListener(event -> {
selectionH3.setText("Selection: " + event.getValue());
});
autocomplete.addValueClearListener(event -> {
selectionH3.setText("Selection: " + "");
});
autocomplete.setLabel("Find what you want:");
autocomplete.setPlaceholder("search ...");
```
## Setting up for development:
Clone the project in GitHub (or fork it if you plan on contributing)
```
git clone [email protected]:vaadin-component-factory/autocomplete.git
```
to install project, to your maven repository run
```mvn install```
## How to run the demo?
The Demo can be run going to the project `autocomplete-demo` and executing the maven goal:
```mvn jetty:run```
# License & Author
Apache License 2