org.apache.wicket.extensions.ajax.markup.html.autocomplete

Class AutoCompleteBehavior<T>

java.lang.Object

org.apache.wicket.behavior.Behavior

org.apache.wicket.behavior.AbstractAjaxBehavior

org.apache.wicket.ajax.AbstractDefaultAjaxBehavior

org.apache.wicket.extensions.ajax.markup.html.autocomplete.AbstractAutoCompleteBehavior

org.apache.wicket.extensions.ajax.markup.html.autocomplete.AutoCompleteBehavior<T>

Type Parameters:

T -

All Implemented Interfaces:

Serializable, IBehaviorListener, IComponentAwareEventSink, IRequestListener, IComponentAwareHeaderContributor, org.apache.wicket.util.io.IClusterable

public abstract class AutoCompleteBehavior<T>
extends AbstractAutoCompleteBehavior

This behavior builds on top of AbstractAutoCompleteBehavior by introducing the concept of a IAutoCompleteRenderer to make response writing easier.

Since:

1.2

Author:

Igor Vaynberg (ivaynberg), Janne Hietamäki (jannehietamaki)

See Also:

IAutoCompleteRenderer, Serialized Form

Field Summary

Fields inherited from class org.apache.wicket.extensions.ajax.markup.html.autocomplete.AbstractAutoCompleteBehavior

AUTOCOMPLETE_JS, settings

Fields inherited from class org.apache.wicket.ajax.AbstractDefaultAjaxBehavior

INDICATOR

Fields inherited from interface org.apache.wicket.behavior.IBehaviorListener

INTERFACE

Constructor Summary

Constructors

Constructor and Description
AutoCompleteBehavior(IAutoCompleteRenderer<T> renderer) Constructor
AutoCompleteBehavior(IAutoCompleteRenderer<T> renderer, AutoCompleteSettings settings) Constructor
AutoCompleteBehavior(IAutoCompleteRenderer<T> renderer, boolean preselect) Constructor

Method Summary

Methods

Modifier and Type	Method and Description
protected abstract Iterator<T>	getChoices(String input) Callback method that should return an iterator over all possible choice objects.
protected void	onRequest(String val, RequestCycle requestCycle) Callback for the ajax event generated by the javascript.
protected void	updateAjaxAttributes(AjaxRequestAttributes attributes)

Methods inherited from class org.apache.wicket.extensions.ajax.markup.html.autocomplete.AbstractAutoCompleteBehavior

constructSettingsJS, renderHead, respond

Methods inherited from class org.apache.wicket.ajax.AbstractDefaultAjaxBehavior

findIndicatorId, getAttributes, getCallbackFunction, getCallbackFunctionBody, getCallbackScript, getCallbackScript, onBind, onRequest, postprocessConfiguration, renderAjaxAttributes, renderAjaxAttributes

Methods inherited from class org.apache.wicket.behavior.AbstractAjaxBehavior

afterRender, bind, getCallbackUrl, getComponent, onComponentRendered, onComponentTag, onComponentTag, onUnbind, unbind

Methods inherited from class org.apache.wicket.behavior.Behavior

beforeRender, canCallListenerInterface, detach, getStatelessHint, isEnabled, isTemporary, onConfigure, onEvent, onException, onRemove

Methods inherited from class java.lang.Object

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

Constructor Detail

AutoCompleteBehavior

public AutoCompleteBehavior(IAutoCompleteRenderer<T> renderer)

Constructor

Parameters:

renderer - renderer that will be used to generate output

AutoCompleteBehavior

public AutoCompleteBehavior(IAutoCompleteRenderer<T> renderer,
                    boolean preselect)

Constructor

Parameters:

renderer - renderer that will be used to generate output

preselect - highlight/preselect the first item in the autocomplete list automatically

AutoCompleteBehavior

public AutoCompleteBehavior(IAutoCompleteRenderer<T> renderer,
                    AutoCompleteSettings settings)

Constructor

Parameters:

renderer - renderer that will be used to generate output

settings - settings for the autocomplete list

Method Detail

updateAjaxAttributes

protected void updateAjaxAttributes(AjaxRequestAttributes attributes)

Overrides:

updateAjaxAttributes in class AbstractDefaultAjaxBehavior

onRequest

protected final void onRequest(String val,
             RequestCycle requestCycle)

Description copied from class: AbstractAutoCompleteBehavior

Callback for the ajax event generated by the javascript. This is where we need to generate our response.

Specified by:

onRequest in class AbstractAutoCompleteBehavior

Parameters:

val - the input entered so far

requestCycle - current request cycle

getChoices

protected abstract Iterator<T> getChoices(String input)

Callback method that should return an iterator over all possible choice objects. These objects will be passed to the renderer to generate output. Usually it is enough to return an iterator over strings.

Parameters:

input - current input

Returns:

iterator over all possible choice objects