com.otaliastudios.autocomplete

Class AutocompletePresenter<T>

java.lang.Object

com.otaliastudios.autocomplete.AutocompletePresenter<T>

Direct Known Subclasses:

RecyclerViewPresenter

public abstract class AutocompletePresenter<T>
extends java.lang.Object

Base class for presenting items inside a popup. This is abstract and must be implemented. Most important methods are getView() and onQuery(CharSequence).

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	AutocompletePresenter.ClickProvider<T>
static class	AutocompletePresenter.PopupDimensions Provides width, height, maxWidth and maxHeight for the popup.

Constructor Summary

Constructors

Constructor and Description
AutocompletePresenter(android.content.Context context)

Method Summary

Modifier and Type	Method and Description
protected android.content.Context	getContext()
protected AutocompletePresenter.PopupDimensions	getPopupDimensions() Provide the AutocompletePresenter.PopupDimensions for this popup.
protected abstract android.view.ViewGroup	getView() Called each time the popup is shown.
protected boolean	isShowing()
protected abstract void	onQuery(java.lang.CharSequence query) Called to update the view to filter results with the query.
protected abstract void	onViewHidden() Called when the popup is hidden, to release resources.
protected abstract void	onViewShown() Perform firther initialization here.
protected void	registerClickProvider(AutocompletePresenter.ClickProvider<T> provider) At this point the presenter is passed the AutocompletePresenter.ClickProvider.
protected void	registerDataSetObserver(android.database.DataSetObserver observer) Useful if you wish to change width/height based on content height.

Methods inherited from class java.lang.Object

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

Constructor Detail

AutocompletePresenter

public AutocompletePresenter(android.content.Context context)

Method Detail

registerClickProvider

protected void registerClickProvider(AutocompletePresenter.ClickProvider<T> provider)

At this point the presenter is passed the AutocompletePresenter.ClickProvider. The contract is that AutocompletePresenter.ClickProvider.click(Object) must be called when a list item is clicked. This ensure that the autocomplete callback will receive the event.

Parameters:

provider - a click provider for this presenter.

registerDataSetObserver

protected void registerDataSetObserver(android.database.DataSetObserver observer)

Useful if you wish to change width/height based on content height. The contract is to call DataSetObserver.onChanged() when your view has changes. This is called after getView().

Parameters:

observer - the observer.

getView

protected abstract android.view.ViewGroup getView()

Called each time the popup is shown. You are meant to inflate the view here. You can get a LayoutInflater using getContext().

Returns:

a ViewGroup for the popup

getPopupDimensions

protected AutocompletePresenter.PopupDimensions getPopupDimensions()

Provide the AutocompletePresenter.PopupDimensions for this popup. Called just once. You can use fixed dimensions or ViewGroup.LayoutParams.WRAP_CONTENT and ViewGroup.LayoutParams.MATCH_PARENT.

Returns:

a PopupDimensions object

onViewShown

protected abstract void onViewShown()

Perform firther initialization here. Called after getView(), each time the popup is shown.

onQuery

protected abstract void onQuery(@Nullable
                                java.lang.CharSequence query)

Called to update the view to filter results with the query. It is called any time the popup is shown, and any time the text changes and query is updated.

Parameters:

query - query from the edit text, to filter our results

onViewHidden

protected abstract void onViewHidden()

Called when the popup is hidden, to release resources.

getContext

protected final android.content.Context getContext()

Returns:

this presenter context

isShowing

protected final boolean isShowing()

Returns:

whether we are showing currently