roastedcpu / autocomplete

Java API for vcf-autocomplete

Component Factory Autocomplete for Vaadin 10+

This is server-side component of <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 ↗

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.

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 [e-mail]: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