gwt.material.design.addins.client.autocomplete

Class MaterialAutoComplete

java.lang.Object

com.google.gwt.user.client.ui.UIObject

com.google.gwt.user.client.ui.Widget

com.google.gwt.user.client.ui.Panel

com.google.gwt.user.client.ui.ComplexPanel

gwt.material.design.client.base.MaterialWidget

gwt.material.design.client.base.AbstractValueWidget<List<? extends com.google.gwt.user.client.ui.SuggestOracle.Suggestion>>

gwt.material.design.addins.client.autocomplete.MaterialAutoComplete

All Implemented Interfaces:

com.google.gwt.editor.client.Editor<List<? extends com.google.gwt.user.client.ui.SuggestOracle.Suggestion>>, com.google.gwt.editor.client.HasEditorErrors<List<? extends com.google.gwt.user.client.ui.SuggestOracle.Suggestion>>, com.google.gwt.editor.client.LeafValueEditor<List<? extends com.google.gwt.user.client.ui.SuggestOracle.Suggestion>>, com.google.gwt.event.dom.client.HasAllFocusHandlers, com.google.gwt.event.dom.client.HasAllGestureHandlers, com.google.gwt.event.dom.client.HasAllKeyHandlers, com.google.gwt.event.dom.client.HasAllMouseHandlers, com.google.gwt.event.dom.client.HasAllTouchHandlers, com.google.gwt.event.dom.client.HasBlurHandlers, com.google.gwt.event.dom.client.HasClickHandlers, com.google.gwt.event.dom.client.HasDoubleClickHandlers, com.google.gwt.event.dom.client.HasFocusHandlers, com.google.gwt.event.dom.client.HasGestureChangeHandlers, com.google.gwt.event.dom.client.HasGestureEndHandlers, com.google.gwt.event.dom.client.HasGestureStartHandlers, com.google.gwt.event.dom.client.HasKeyDownHandlers, com.google.gwt.event.dom.client.HasKeyPressHandlers, com.google.gwt.event.dom.client.HasKeyUpHandlers, com.google.gwt.event.dom.client.HasMouseDownHandlers, com.google.gwt.event.dom.client.HasMouseMoveHandlers, com.google.gwt.event.dom.client.HasMouseOutHandlers, com.google.gwt.event.dom.client.HasMouseOverHandlers, com.google.gwt.event.dom.client.HasMouseUpHandlers, com.google.gwt.event.dom.client.HasMouseWheelHandlers, com.google.gwt.event.dom.client.HasTouchCancelHandlers, com.google.gwt.event.dom.client.HasTouchEndHandlers, com.google.gwt.event.dom.client.HasTouchMoveHandlers, com.google.gwt.event.dom.client.HasTouchStartHandlers, com.google.gwt.event.logical.shared.HasAttachHandlers, com.google.gwt.event.logical.shared.HasSelectionHandlers<com.google.gwt.user.client.ui.SuggestOracle.Suggestion>, com.google.gwt.event.logical.shared.HasValueChangeHandlers<List<? extends com.google.gwt.user.client.ui.SuggestOracle.Suggestion>>, com.google.gwt.event.shared.HasHandlers, com.google.gwt.user.client.EventListener, com.google.gwt.user.client.TakesValue<List<? extends com.google.gwt.user.client.ui.SuggestOracle.Suggestion>>, com.google.gwt.user.client.ui.Focusable, com.google.gwt.user.client.ui.HasEnabled, com.google.gwt.user.client.ui.HasValue<List<? extends com.google.gwt.user.client.ui.SuggestOracle.Suggestion>>, com.google.gwt.user.client.ui.HasVisibility, com.google.gwt.user.client.ui.HasWidgets, com.google.gwt.user.client.ui.HasWidgets.ForIsWidget, com.google.gwt.user.client.ui.IndexedPanel, com.google.gwt.user.client.ui.IndexedPanel.ForIsWidget, com.google.gwt.user.client.ui.IsWidget, gwt.material.design.client.base.error.HasErrorHandler, gwt.material.design.client.base.HasAllDragAndDropHandlers, gwt.material.design.client.base.HasBorder, gwt.material.design.client.base.HasCenterOn, gwt.material.design.client.base.HasCircle, gwt.material.design.client.base.HasColors, gwt.material.design.client.base.HasDataAttributes, gwt.material.design.client.base.HasDepth, gwt.material.design.client.base.HasDimension, gwt.material.design.client.base.HasDraggableHandlers, gwt.material.design.client.base.HasDroppableHandlers, gwt.material.design.client.base.HasError, gwt.material.design.client.base.HasFlexbox, gwt.material.design.client.base.HasFloat, gwt.material.design.client.base.HasFontSize, gwt.material.design.client.base.HasFontWeight, gwt.material.design.client.base.HasGrid, gwt.material.design.client.base.HasHideOn, gwt.material.design.client.base.HasHoverable, gwt.material.design.client.base.HasId, gwt.material.design.client.base.HasInitialClasses, gwt.material.design.client.base.HasInlineStyle, gwt.material.design.client.base.HasInteractionHandlers, gwt.material.design.client.base.HasOpacity, gwt.material.design.client.base.HasOrientation, gwt.material.design.client.base.HasOrientationChangeHandler, gwt.material.design.client.base.HasPlaceholder, gwt.material.design.client.base.HasProgress, gwt.material.design.client.base.HasReadOnly, gwt.material.design.client.base.HasScrollspy, gwt.material.design.client.base.HasSeparator, gwt.material.design.client.base.HasShadow, gwt.material.design.client.base.HasShowOn, gwt.material.design.client.base.HasTextAlign, gwt.material.design.client.base.HasTooltip, gwt.material.design.client.base.HasTransform, gwt.material.design.client.base.HasType<AutocompleteType>, gwt.material.design.client.base.HasVerticalAlign, gwt.material.design.client.base.HasWaves, gwt.material.design.client.base.validator.HasValidators<List<? extends com.google.gwt.user.client.ui.SuggestOracle.Suggestion>>, gwt.material.design.client.base.validator.ValidationChangedEvent.HasValidationChangedHandlers, Iterable<com.google.gwt.user.client.ui.Widget>

public class MaterialAutoComplete
extends gwt.material.design.client.base.AbstractValueWidget<List<? extends com.google.gwt.user.client.ui.SuggestOracle.Suggestion>>
implements gwt.material.design.client.base.HasPlaceholder, gwt.material.design.client.base.HasProgress, gwt.material.design.client.base.HasType<AutocompleteType>, com.google.gwt.event.logical.shared.HasSelectionHandlers<com.google.gwt.user.client.ui.SuggestOracle.Suggestion>, gwt.material.design.client.base.HasReadOnly

Use GWT Autocomplete to search for matches from local or remote data sources. We used MultiWordSuggestOracle to populate the list to be added on the autocomplete values.

XML Namespace Declaration

 
 xmlns:ma='urn:import:gwt.material.design.addins.client'
 
 

UiBinder Usage:

 
  <ma:autocomplete.MaterialAutoComplete ui:field="autocomplete" placeholder="States" />
 

Java Usage:

To use your domain object inside the MaterialAutoComplete, for example, an object "User", you can subclass the MaterialSuggestionOracle and SuggestOracle.Suggestion, like this:

 public class UserOracle extends MaterialSuggestionOracle {
     private List<User> contacts = new LinkedList<>();
 

     public void addContacts(List<User> users){
         contacts.addAll(users);
     }
 

      @Override
     public void requestSuggestions(final Request request, final Callback callback) {
         Response resp = new Response();
         if (contacts.isEmpty()){
             callback.onSuggestionsReady(request, resp);
             return;
         }
         String text = request.getQuery();
         text = text.toLowerCase();
 

         List<UserSuggestion> list = new ArrayList<>();
 

         / *
          *  Finds the contacts that meets the criteria. Note that since the
          *  requestSuggestions method is asynchronous, you can fetch the
          *  results from the server instead of using a local contacts List.
          */
         for (User contact : contacts){
             if (contact.getName().toLowerCase().contains(text)){
                 list.add(new UserSuggestion(contact));
             }
          }
          resp.setSuggestions(list);
          callback.onSuggestionsReady(request, resp);
     }
 }
 

 public class UserSuggestion implements SuggestOracle.Suggestion {
 

     private User user;
 

     public UserSuggestion(User user){
         this.user = user;
     }
 

      @Override
     public String getDisplayString() {
         return getReplacementString();
     }
 

      @Override
     public String getReplacementString() {
         return user.getName();
     }
 

     public User getUser() {
         return user;
     }
 }
 

And then use the UserOracle like this:

 //Constructor
 MaterialAutoComplete userAutoComplete = new MaterialAutoComplete(new UserOracle());
 

 //How to get the selected User objects
 public List<User> getSelectedUsers(){
     List<? extends Suggestion> values = userAutoComplete.getValue();
     List<User> users = new ArrayList<>(values.size());
     for (Suggestion value : values) {
         if (value instanceof UserSuggestion){
             UserSuggestion us = (UserSuggestion) value;
             User user = us.getUser();
             users.add(user);
         }
     }
     return users;
 }
 

Author:

kevzlou7979, gilberto-torrezan

See Also:

Material AutoComplete

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	MaterialAutoComplete.DefaultMaterialChipProvider Default implementation of the MaterialAutoComplete.MaterialChipProvider interface, used by the MaterialAutoComplete.
static interface	MaterialAutoComplete.MaterialChipProvider Interface that defines how a MaterialChip is created, given a SuggestOracle.Suggestion.

Nested classes/interfaces inherited from class gwt.material.design.client.base.MaterialWidget

gwt.material.design.client.base.MaterialWidget.Feature

Nested classes/interfaces inherited from class com.google.gwt.user.client.ui.UIObject

com.google.gwt.user.client.ui.UIObject.DebugIdImpl, com.google.gwt.user.client.ui.UIObject.DebugIdImplEnabled

Nested classes/interfaces inherited from interface com.google.gwt.editor.client.Editor

com.google.gwt.editor.client.Editor.Ignore, com.google.gwt.editor.client.Editor.Path

Nested classes/interfaces inherited from interface com.google.gwt.user.client.ui.IndexedPanel

com.google.gwt.user.client.ui.IndexedPanel.ForIsWidget

Nested classes/interfaces inherited from interface com.google.gwt.user.client.ui.HasWidgets

com.google.gwt.user.client.ui.HasWidgets.ForIsWidget

Field Summary

Fields inherited from class gwt.material.design.client.base.MaterialWidget

$this

Fields inherited from class com.google.gwt.user.client.ui.UIObject

DEBUG_ID_PREFIX

Constructor Summary

Constructors

Constructor and Description
MaterialAutoComplete() Use MaterialAutocomplete to search for matches from local or remote data sources.
MaterialAutoComplete(AutocompleteType type)
MaterialAutoComplete(String placeholder)
MaterialAutoComplete(com.google.gwt.user.client.ui.SuggestOracle suggestions) Use MaterialAutocomplete to search for matches from local or remote data sources.

Method Summary

Modifier and Type	Method and Description
com.google.gwt.event.shared.HandlerRegistration	addBlurHandler(com.google.gwt.event.dom.client.BlurHandler handler)
com.google.gwt.event.shared.HandlerRegistration	addFocusHandler(com.google.gwt.event.dom.client.FocusHandler handler)
protected boolean	addItem(com.google.gwt.user.client.ui.SuggestOracle.Suggestion suggestion) Adding the item value using Material Chips added on auto complete box
com.google.gwt.event.shared.HandlerRegistration	addKeyUpHandler(com.google.gwt.event.dom.client.KeyUpHandler handler)
com.google.gwt.event.shared.HandlerRegistration	addSelectionHandler(com.google.gwt.event.logical.shared.SelectionHandler<com.google.gwt.user.client.ui.SuggestOracle.Suggestion> handler)
com.google.gwt.event.shared.HandlerRegistration	addValueChangeHandler(com.google.gwt.event.logical.shared.ValueChangeHandler<List<? extends com.google.gwt.user.client.ui.SuggestOracle.Suggestion>> handler)
void	clear() Clear the chip items on the autocomplete box
MaterialAutoComplete.MaterialChipProvider	getChipProvider() Gets the current MaterialAutoComplete.MaterialChipProvider.
gwt.material.design.client.ui.MaterialLabel	getErrorLabel()
gwt.material.design.client.base.mixin.ErrorMixin<gwt.material.design.client.base.AbstractValueWidget,gwt.material.design.client.ui.MaterialLabel>	getErrorMixin()
protected gwt.material.design.client.base.mixin.FocusableMixin<gwt.material.design.client.base.MaterialWidget>	getFocusableMixin()
com.google.gwt.user.client.ui.TextBox	getItemBox()
List<gwt.material.design.client.ui.html.ListItem>	getItemsHighlighted()
List<String>	getItemValues()
gwt.material.design.client.ui.html.Label	getLabel()
int	getLimit()
String	getPlaceholder()
gwt.material.design.client.ui.MaterialProgress	getProgress()
protected gwt.material.design.client.base.mixin.ProgressMixin<MaterialAutoComplete>	getProgressMixin()
protected gwt.material.design.client.base.mixin.ReadOnlyMixin<MaterialAutoComplete,com.google.gwt.user.client.ui.TextBox>	getReadOnlyMixin()
String	getSelectedChipStyle() Returns the style class applied to chips when they are selected.
com.google.gwt.user.client.ui.SuggestBox	getSuggestBox()
com.google.gwt.user.client.ui.SuggestOracle	getSuggestions()
AutocompleteType	getType()
protected gwt.material.design.client.base.mixin.CssTypeMixin<AutocompleteType,MaterialAutoComplete>	getTypeMixin()
List<? extends com.google.gwt.user.client.ui.SuggestOracle.Suggestion>	getValue() Returns the selected SuggestOracle.Suggestions.
void	hideProgress()
boolean	isDirectInputAllowed()
boolean	isReadOnly()
boolean	isToggleReadOnly()
protected void	loadHandlers()
protected void	onLoad()
protected void	onUnload()
void	setAutoSuggestLimit(int limit) Set the number of suggestions to be displayed to the user.
void	setChipProvider(MaterialAutoComplete.MaterialChipProvider chipProvider) Sets a MaterialAutoComplete.MaterialChipProvider that can customize how the MaterialChip is created for each selected SuggestOracle.Suggestion.
void	setDirectInputAllowed(boolean directInputAllowed) When set to false, only SuggestOracle.Suggestions from the SuggestionOracle are accepted.
void	setEnabled(boolean enabled)
void	setItemsHighlighted(List<gwt.material.design.client.ui.html.ListItem> itemsHighlighted)
void	setItemValues(List<String> itemValues)
void	setItemValues(List<String> itemValues, boolean fireEvents)
void	setLabel(String label)
void	setLimit(int limit)
void	setPercent(double percent)
void	setPlaceholder(String placeholder)
void	setReadOnly(boolean value)
void	setSelectedChipStyle(String selectedChipStyle) Sets the style class applied to chips when they are selected.
void	setSuggestions(com.google.gwt.user.client.ui.SuggestOracle suggestions) Sets the SuggestOracle to be used to provide suggestions.
void	setSuggestions(com.google.gwt.user.client.ui.SuggestOracle suggestions, AutocompleteType type)
void	setToggleReadOnly(boolean toggle)
void	setType(AutocompleteType type)
protected void	setup(com.google.gwt.user.client.ui.SuggestOracle suggestions) Generate and build the List Items to be set on Auto Complete box.
void	setValue(List<? extends com.google.gwt.user.client.ui.SuggestOracle.Suggestion> value, boolean fireEvents)
void	showProgress(gwt.material.design.client.constants.ProgressType type)
protected boolean	tryRemoveSuggestion(com.google.gwt.user.client.ui.Widget widget)
protected void	unloadHandlers()

Methods inherited from class gwt.material.design.client.base.AbstractValueWidget

addValidationChangedHandler, addValidator, clearErrorOrSuccess, createBlankValidator, getErrorHandler, getErrorHandlerMixin, getErrorHandlerType, getValidatorMixin, isAllowBlank, isValidateOnBlur, removeValidator, reset, setAllowBlank, setError, setErrorHandler, setErrorHandlerType, setHelperText, setSuccess, setupBlurValidation, setValidateOnBlur, setValidators, setValue, setValue, showErrors, validate, validate

Methods inherited from class gwt.material.design.client.base.MaterialWidget

$this, add, add, addAttachHandler, addClickHandler, addDoubleClickHandler, addDragEndHandler, addDragEnterHandler, addDragLeaveHandler, addDragMoveHandler, addDragOverHandler, addDragStartHandler, addDropActivateHandler, addDropDeactivateHandler, addDropHandler, addGestureChangeHandler, addGestureEndHandler, addGestureStartHandler, addKeyDownHandler, addKeyPressHandler, addMouseDownHandler, addMouseMoveHandler, addMouseOutHandler, addMouseOverHandler, addMouseUpHandler, addMouseWheelHandler, addOrientationChangeHandler, addTouchCancelHandler, addTouchEndHandler, addTouchMoveHandler, addTouchStartHandler, body, clearActiveClass, enableFeature, getBackfaceVisibility, getBackgroundColor, getBorder, getBorderBottom, getBorderLeft, getBorderMixin, getBorderRadius, getBorderRight, getBorderTop, getCenterOn, getCenterOnMixin, getChildren, getChildrenList, getCircleMixin, getColorsMixin, getDataAttribute, getDepth, getDimensionMixin, getEnabledMixin, getFlexboxMixin, getFloat, getFloatMixin, getFontSize, getFontSizeMixin, getFontWeight, getFontWeightMixin, getGridMixin, getHandlerRegistry, getHideOn, getHideOnMixin, getHoverableMixin, getId, getIdMixin, getInitialClasses, getLayoutPosition, getMaxHeight, getMaxWidth, getMinHeight, getMinWidth, getOpacity, getOrientation, getOrientationMixin, getPerspective, getPerspectiveOrigin, getScrollspy, getScrollspyMixin, getSeparatorMixin, getShadow, getShadowMixin, getShowOn, getShowOnMixin, getTabIndex, getTextAlign, getTextAlignMixin, getTextColor, getTooltip, getTooltipDelayMs, getTooltipHTML, getTooltipMixin, getTooltipPosition, getTransform, getTransformMixin, getTransformOrigin, getTransformStyle, getTruncateMixin, getVerticalAlign, getVerticalAlignMixin, getWaves, getWavesMixin, getWidth, insert, insert, isCircle, isDetectOrientation, isEnabled, isFeatureEnabled, isHoverable, isSeparator, isTruncate, registerHandler, removeHandler, setAccessKey, setBackfaceVisibility, setBackgroundColor, setBorder, setBorderBottom, setBorderLeft, setBorderRadius, setBorderRight, setBorderTop, setBottom, setCenterOn, setCircle, setClass, setDataAttribute, setDepth, setDetectOrientation, setDisplay, setFlex, setFlexAlignContent, setFlexAlignItems, setFlexAlignSelf, setFlexBasis, setFlexDirection, setFlexGrow, setFlexJustifyContent, setFlexOrder, setFlexShrink, setFlexWrap, setFloat, setFocus, setFontSize, setFontSize, setFontWeight, setGrid, setGwtDisplay, setHideOn, setHoverable, setId, setInitialClasses, setLayoutPosition, setLeft, setLineHeight, setMargin, setMarginBottom, setMarginLeft, setMarginRight, setMarginTop, setMaxHeight, setMaxWidth, setMinHeight, setMinWidth, setOffset, setOpacity, setOrientation, setOverflow, setPadding, setPaddingBottom, setPaddingLeft, setPaddingRight, setPaddingTop, setPerspective, setPerspectiveOrigin, setRight, setScrollspy, setSeparator, setShadow, setShowOn, setStyle, setTabIndex, setTextAlign, setTextColor, setTooltip, setTooltipDelayMs, setTooltipHTML, setTooltipPosition, setTop, setTransform, setTransformOrigin, setTransformStyle, setTransition, setTruncate, setVerticalAlign, setVisibility, setWaves, stopTouchStartEvent, window

Methods inherited from class com.google.gwt.user.client.ui.ComplexPanel

add, adjustIndex, checkIndexBoundsForAccess, checkIndexBoundsForInsertion, getWidget, getWidgetCount, getWidgetIndex, getWidgetIndex, insert, iterator, remove, remove

Methods inherited from class com.google.gwt.user.client.ui.Panel

add, adopt, doAttachChildren, doDetachChildren, orphan, remove

Methods inherited from class com.google.gwt.user.client.ui.Widget

addAttachHandler, addBitlessDomHandler, addDomHandler, addHandler, asWidget, asWidgetOrNull, createHandlerManager, delegateEvent, fireEvent, getHandlerCount, getLayoutData, getParent, isAttached, isOrWasAttached, onAttach, onBrowserEvent, onDetach, removeFromParent, setLayoutData, sinkEvents, unsinkEvents

Methods inherited from class com.google.gwt.user.client.ui.UIObject

addStyleDependentName, addStyleName, ensureDebugId, ensureDebugId, ensureDebugId, getAbsoluteLeft, getAbsoluteTop, getElement, getOffsetHeight, getOffsetWidth, getStyleElement, getStyleName, getStyleName, getStylePrimaryName, getStylePrimaryName, getTitle, isVisible, isVisible, onEnsureDebugId, removeStyleDependentName, removeStyleName, resolvePotentialElement, setElement, setElement, setHeight, setPixelSize, setSize, setStyleDependentName, setStyleName, setStyleName, setStyleName, setStyleName, setStylePrimaryName, setStylePrimaryName, setTitle, setVisible, setVisible, setWidth, sinkBitlessEvent, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface com.google.gwt.event.shared.HasHandlers

fireEvent

Methods inherited from interface gwt.material.design.client.base.HasFlexbox

setVisible

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Constructor Detail

MaterialAutoComplete

public MaterialAutoComplete()

Use MaterialAutocomplete to search for matches from local or remote data sources.

MaterialAutoComplete

public MaterialAutoComplete(AutocompleteType type)

MaterialAutoComplete

public MaterialAutoComplete(String placeholder)

MaterialAutoComplete

public MaterialAutoComplete(com.google.gwt.user.client.ui.SuggestOracle suggestions)

Use MaterialAutocomplete to search for matches from local or remote data sources.

See Also:

setSuggestions(SuggestOracle)

Method Detail

onLoad

protected void onLoad()

Overrides:

onLoad in class gwt.material.design.client.base.MaterialWidget

loadHandlers

protected void loadHandlers()

onUnload

protected void onUnload()

Overrides:

onUnload in class gwt.material.design.client.base.MaterialWidget

unloadHandlers

protected void unloadHandlers()

setup

protected void setup(com.google.gwt.user.client.ui.SuggestOracle suggestions)

Generate and build the List Items to be set on Auto Complete box.

tryRemoveSuggestion

protected boolean tryRemoveSuggestion(com.google.gwt.user.client.ui.Widget widget)

addItem

protected boolean addItem(com.google.gwt.user.client.ui.SuggestOracle.Suggestion suggestion)

Adding the item value using Material Chips added on auto complete box

clear

public void clear()

Clear the chip items on the autocomplete box

Specified by:

clear in interface com.google.gwt.user.client.ui.HasWidgets

Overrides:

clear in class com.google.gwt.user.client.ui.Panel

showProgress

public void showProgress(gwt.material.design.client.constants.ProgressType type)

Specified by:

showProgress in interface gwt.material.design.client.base.HasProgress

setPercent

public void setPercent(double percent)

Specified by:

setPercent in interface gwt.material.design.client.base.HasProgress

hideProgress

public void hideProgress()

Specified by:

hideProgress in interface gwt.material.design.client.base.HasProgress

getProgress

public gwt.material.design.client.ui.MaterialProgress getProgress()

Specified by:

getProgress in interface gwt.material.design.client.base.HasProgress

getItemValues

public List<String> getItemValues()

Returns:

the item values on autocomplete

See Also:

getValue()

setItemValues

public void setItemValues(List<String> itemValues)

Parameters:

itemValues - the itemsSelected to set

See Also:

AbstractValueWidget.setValue(Object)

setItemValues

public void setItemValues(List<String> itemValues,
                          boolean fireEvents)

Parameters:

itemValues - the itemsSelected to set

fireEvents - will fire value change event if true

See Also:

AbstractValueWidget.setValue(Object)

getItemsHighlighted

public List<gwt.material.design.client.ui.html.ListItem> getItemsHighlighted()

Returns:

the itemsHighlighted

setItemsHighlighted

public void setItemsHighlighted(List<gwt.material.design.client.ui.html.ListItem> itemsHighlighted)

Parameters:

itemsHighlighted - the itemsHighlighted to set

getSuggestions

public com.google.gwt.user.client.ui.SuggestOracle getSuggestions()

Returns:

the suggestion oracle

setSuggestions

public void setSuggestions(com.google.gwt.user.client.ui.SuggestOracle suggestions)

Sets the SuggestOracle to be used to provide suggestions. Also setups the component with the needed event handlers and UI elements.

Parameters:

suggestions - the suggestion oracle to set

setSuggestions

public void setSuggestions(com.google.gwt.user.client.ui.SuggestOracle suggestions,
                           AutocompleteType type)

getLimit

public int getLimit()

setLimit

public void setLimit(int limit)

setAutoSuggestLimit

public void setAutoSuggestLimit(int limit)

Set the number of suggestions to be displayed to the user. This differs from setLimit() which set both the suggestions displayed AND the limit of values allowed within the autocomplete.

Parameters:

limit -

getPlaceholder

public String getPlaceholder()

Specified by:

getPlaceholder in interface gwt.material.design.client.base.HasPlaceholder

setPlaceholder

public void setPlaceholder(String placeholder)

Specified by:

setPlaceholder in interface gwt.material.design.client.base.HasPlaceholder

setLabel

public void setLabel(String label)

Parameters:

label -

See Also:

MaterialValueBox.setLabel(String)

getChipProvider

public MaterialAutoComplete.MaterialChipProvider getChipProvider()

Gets the current MaterialAutoComplete.MaterialChipProvider. By default, the class uses an instance of MaterialAutoComplete.DefaultMaterialChipProvider.

setChipProvider

public void setChipProvider(MaterialAutoComplete.MaterialChipProvider chipProvider)

Sets a MaterialAutoComplete.MaterialChipProvider that can customize how the MaterialChip is created for each selected SuggestOracle.Suggestion.

setDirectInputAllowed

public void setDirectInputAllowed(boolean directInputAllowed)

When set to false, only SuggestOracle.Suggestions from the SuggestionOracle are accepted. Direct input create by the user is ignored. By default, direct input is allowed.

isDirectInputAllowed

public boolean isDirectInputAllowed()

Returns:

if SuggestOracle.Suggestions created by direct input from the user should be allowed. By default directInputAllowed is true.

setSelectedChipStyle

public void setSelectedChipStyle(String selectedChipStyle)

Sets the style class applied to chips when they are selected.

Defaults to "blue white-text".

Parameters:

selectedChipStyle - The class or classes to be applied to selected chips

getSelectedChipStyle

public String getSelectedChipStyle()

Returns the style class applied to chips when they are selected.

Defaults to "blue white-text".

setType

public void setType(AutocompleteType type)

Specified by:

setType in interface gwt.material.design.client.base.HasType<AutocompleteType>

getType

public AutocompleteType getType()

Specified by:

getType in interface gwt.material.design.client.base.HasType<AutocompleteType>

setReadOnly

public void setReadOnly(boolean value)

Specified by:

setReadOnly in interface gwt.material.design.client.base.HasReadOnly

isReadOnly

public boolean isReadOnly()

Specified by:

isReadOnly in interface gwt.material.design.client.base.HasReadOnly

setToggleReadOnly

public void setToggleReadOnly(boolean toggle)

Specified by:

setToggleReadOnly in interface gwt.material.design.client.base.HasReadOnly

isToggleReadOnly

public boolean isToggleReadOnly()

Specified by:

isToggleReadOnly in interface gwt.material.design.client.base.HasReadOnly

getValue

public List<? extends com.google.gwt.user.client.ui.SuggestOracle.Suggestion> getValue()

Returns the selected SuggestOracle.Suggestions. Modifications to the list are not propagated to the component.

Specified by:

getValue in interface com.google.gwt.user.client.TakesValue<List<? extends com.google.gwt.user.client.ui.SuggestOracle.Suggestion>>

Specified by:

getValue in interface com.google.gwt.user.client.ui.HasValue<List<? extends com.google.gwt.user.client.ui.SuggestOracle.Suggestion>>

Returns:

the list of selected SuggestOracle.Suggestions, or empty if none was selected (never null).

setValue

public void setValue(List<? extends com.google.gwt.user.client.ui.SuggestOracle.Suggestion> value,
                     boolean fireEvents)

Specified by:

setValue in interface com.google.gwt.user.client.ui.HasValue<List<? extends com.google.gwt.user.client.ui.SuggestOracle.Suggestion>>

Overrides:

setValue in class gwt.material.design.client.base.AbstractValueWidget<List<? extends com.google.gwt.user.client.ui.SuggestOracle.Suggestion>>

setEnabled

public void setEnabled(boolean enabled)

Specified by:

setEnabled in interface com.google.gwt.user.client.ui.HasEnabled

Overrides:

setEnabled in class gwt.material.design.client.base.MaterialWidget

getLabel

public gwt.material.design.client.ui.html.Label getLabel()

getItemBox

public com.google.gwt.user.client.ui.TextBox getItemBox()

getErrorLabel

public gwt.material.design.client.ui.MaterialLabel getErrorLabel()

getSuggestBox

public com.google.gwt.user.client.ui.SuggestBox getSuggestBox()

addKeyUpHandler

public com.google.gwt.event.shared.HandlerRegistration addKeyUpHandler(com.google.gwt.event.dom.client.KeyUpHandler handler)

Specified by:

addKeyUpHandler in interface com.google.gwt.event.dom.client.HasKeyUpHandlers

Overrides:

addKeyUpHandler in class gwt.material.design.client.base.MaterialWidget

addSelectionHandler

public com.google.gwt.event.shared.HandlerRegistration addSelectionHandler(com.google.gwt.event.logical.shared.SelectionHandler<com.google.gwt.user.client.ui.SuggestOracle.Suggestion> handler)

Specified by:

addSelectionHandler in interface com.google.gwt.event.logical.shared.HasSelectionHandlers<com.google.gwt.user.client.ui.SuggestOracle.Suggestion>

addValueChangeHandler

public com.google.gwt.event.shared.HandlerRegistration addValueChangeHandler(com.google.gwt.event.logical.shared.ValueChangeHandler<List<? extends com.google.gwt.user.client.ui.SuggestOracle.Suggestion>> handler)

Specified by:

addValueChangeHandler in interface com.google.gwt.event.logical.shared.HasValueChangeHandlers<List<? extends com.google.gwt.user.client.ui.SuggestOracle.Suggestion>>

Overrides:

addValueChangeHandler in class gwt.material.design.client.base.AbstractValueWidget<List<? extends com.google.gwt.user.client.ui.SuggestOracle.Suggestion>>

addBlurHandler

public com.google.gwt.event.shared.HandlerRegistration addBlurHandler(com.google.gwt.event.dom.client.BlurHandler handler)

Specified by:

addBlurHandler in interface com.google.gwt.event.dom.client.HasBlurHandlers

Overrides:

addBlurHandler in class gwt.material.design.client.base.MaterialWidget

addFocusHandler

public com.google.gwt.event.shared.HandlerRegistration addFocusHandler(com.google.gwt.event.dom.client.FocusHandler handler)

Specified by:

addFocusHandler in interface com.google.gwt.event.dom.client.HasFocusHandlers

Overrides:

addFocusHandler in class gwt.material.design.client.base.MaterialWidget

getProgressMixin

protected gwt.material.design.client.base.mixin.ProgressMixin<MaterialAutoComplete> getProgressMixin()

getTypeMixin

protected gwt.material.design.client.base.mixin.CssTypeMixin<AutocompleteType,MaterialAutoComplete> getTypeMixin()

getErrorMixin

public gwt.material.design.client.base.mixin.ErrorMixin<gwt.material.design.client.base.AbstractValueWidget,gwt.material.design.client.ui.MaterialLabel> getErrorMixin()

Overrides:

getErrorMixin in class gwt.material.design.client.base.AbstractValueWidget<List<? extends com.google.gwt.user.client.ui.SuggestOracle.Suggestion>>

getReadOnlyMixin

protected gwt.material.design.client.base.mixin.ReadOnlyMixin<MaterialAutoComplete,com.google.gwt.user.client.ui.TextBox> getReadOnlyMixin()

getFocusableMixin

protected gwt.material.design.client.base.mixin.FocusableMixin<gwt.material.design.client.base.MaterialWidget> getFocusableMixin()

Overrides:

getFocusableMixin in class gwt.material.design.client.base.MaterialWidget