org.controlsfx.samples.textfields.HelloAutoComplete Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of controlsfx-samples Show documentation
Show all versions of controlsfx-samples Show documentation
High quality UI controls and other tools to complement the core JavaFX distribution
The newest version!
/**
* Copyright (c) 2014, ControlsFX
* All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions are met:
* * Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
* * Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in the
* documentation and/or other materials provided with the distribution.
* * Neither the name of ControlsFX, any associated website, nor the
* names of its contributors may be used to endorse or promote products
* derived from this software without specific prior written permission.
*
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
* ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
* WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
* DISCLAIMED. IN NO EVENT SHALL CONTROLSFX BE LIABLE FOR ANY
* DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
* (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
* LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
* ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
* SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
*/
package org.controlsfx.samples.textfields;
import java.lang.reflect.Field;
import java.util.Arrays;
import java.util.HashMap;
import java.util.HashSet;
import java.util.Map;
import java.util.Set;
import org.controlsfx.ControlsFXSample;
import org.controlsfx.control.textfield.AutoCompletionBinding;
import org.controlsfx.control.textfield.TextFields;
import org.controlsfx.samples.Utils;
import impl.org.controlsfx.skin.AutoCompletePopup;
import impl.org.controlsfx.skin.AutoCompletePopupSkin;
import javafx.event.EventHandler;
import javafx.geometry.Insets;
import javafx.scene.Node;
import javafx.scene.control.Label;
import javafx.scene.control.ListCell;
import javafx.scene.control.TextField;
import javafx.scene.input.KeyEvent;
import javafx.scene.layout.BorderPane;
import javafx.scene.layout.GridPane;
import javafx.scene.layout.Priority;
import javafx.scene.paint.Color;
import javafx.scene.shape.Rectangle;
import javafx.stage.Stage;
public class HelloAutoComplete extends ControlsFXSample {
private AutoCompletionBinding autoCompletionBinding;
private String[] _possibleSuggestions = {"Hey", "Hello", "Hello World", "Apple", "Cool", "Costa", "Cola", "Coca Cola"};
private Set possibleSuggestions = new HashSet<>(Arrays.asList(_possibleSuggestions));
private Map colorSuggestions = allColorsWithName();
private TextField learningTextField;
@Override public String getSampleName() {
return "AutoComplete";
}
@Override public String getJavaDocURL() {
return Utils.JAVADOC_BASE + "org/controlsfx/control/textfield/TextFields.html";
}
@Override public String getSampleDescription() {
return "AutoComplete helps a user with suggestions to type faster, "
+ "but does not limit the user from entering alternative text."
+ "\n\n"
+ "The textfields have been primed with the following words:\n"
+ "\"Hey\", \"Hello\", \"Hello World\", \"Apple\", \"Cool\", "
+ "\"Costa\", \"Cola\", \"Coca Cola\""
+ "\n\n"
+ "The 'Learning TextField' will add whatever words are typed "
+ "to the auto-complete popup, as long as you press Enter once "
+ "you've finished typing the word."
+ "\n\n"
+ "The Color TextField will suggest different colors when you type "
+ "in their name.";
}
@Override public Node getPanel(final Stage stage) {
BorderPane root = new BorderPane();
GridPane grid = new GridPane();
grid.setVgap(10);
grid.setHgap(10);
grid.setPadding(new Insets(30, 30, 0, 30));
//
// TextField with static auto-complete functionality
//
TextField textField = new TextField();
TextFields.bindAutoCompletion(
textField,
"Hey", "Hello", "Hello World", "Apple", "Cool", "Costa", "Cola", "Coca Cola");
grid.add(new Label("Auto-complete Text"), 0, 0);
grid.add(textField, 1, 0);
GridPane.setHgrow(textField, Priority.ALWAYS);
//
// TextField with learning auto-complete functionality
// Learn the word when user presses ENTER
//
learningTextField = new TextField();
autoCompletionBinding = TextFields.bindAutoCompletion(learningTextField, possibleSuggestions);
learningTextField.setOnKeyPressed(new EventHandler() {
@Override
public void handle(KeyEvent ke) {
switch (ke.getCode()) {
case ENTER:
autoCompletionLearnWord(learningTextField.getText().trim());
break;
default:
break;
}
}
});
grid.add(new Label("Learning TextField"), 0, 1);
grid.add(learningTextField, 1, 1);
GridPane.setHgrow(learningTextField, Priority.ALWAYS);
//
// TextField with custom cell factory
// Completes color names
//
TextField customTextField = new TextField();
AutoCompletePopup colorCompletionPopup = TextFields.bindAutoCompletion(customTextField, colorSuggestions.keySet()).getAutoCompletionPopup();
colorCompletionPopup.setSkin(new AutoCompletePopupSkin(colorCompletionPopup, param -> new ListCell() {
@Override
public void updateItem(String item, boolean empty) {
super.updateItem(item, empty);
if (empty) {
setText(null);
setGraphic(null);
} else {
setGraphic(new Rectangle(32, 32, colorSuggestions.get(item)));
setText(item);
}
}
}));
grid.add(new Label("Color TextField with custom CellFactory"), 0, 2);
grid.add(customTextField, 1, 2);
GridPane.setHgrow(customTextField, Priority.ALWAYS);
root.setTop(grid);
return root;
}
private void autoCompletionLearnWord(String newWord){
possibleSuggestions.add(newWord);
// we dispose the old binding and recreate a new binding
if (autoCompletionBinding != null) {
autoCompletionBinding.dispose();
}
autoCompletionBinding = TextFields.bindAutoCompletion(learningTextField, possibleSuggestions);
}
@Override public Node getControlPanel() {
GridPane grid = new GridPane();
grid.setVgap(10);
grid.setHgap(10);
grid.setPadding(new Insets(30, 30, 0, 30));
// TODO Add customization example controls
return grid;
}
/* Modified from https://stackoverflow.com/a/17465261/6094756 */
private Map allColorsWithName() {
Map map = new HashMap<>();
try {
for (Field f : Color.class.getFields()) {
Object obj = f.get(null);
if (obj instanceof Color) {
map.put(f.getName(), (Color) obj);
}
}
} catch (IllegalArgumentException | IllegalAccessException e) {
map.put("red", Color.RED);
map.put("green", Color.GREEN);
map.put("blue", Color.BLUE);
}
return map;
}
public static void main(String[] args) {
launch(args);
}
}