api_uicontrols/com.tomtom.tools.android.api.uicontrols.searchview/TtSearchView

TtSearchView

class TtSearchView @JvmOverloads constructor(context: Context, attrs: AttributeSet?, defStyleAttr: Int = R.attr.tt_searchview_style) : SearchView

A reusable SearchView where the appearance of the input field, the search icon and the close icon can be customized by theme attributes.

The client can specify whether TtSearchView will expand when activated by defining ttExpandedWidth. When ttExpandedWidth is set, TtSearchView will not accept any input even while focused and has to be expanded by tapping on it. After TtSearchView is expanded, it behaves as usual.

If ttExpandedWidth is set, and then dynamically changed back to 0.0f, TtSearchView will resize it's with to the one set in the XML file or provided by the set LayoutParams. If that width is too small for the TtSearchView to be usable, you have to manually adjust TtSearchView's width through updateLayoutParams. Note that it is only valid to update this view's width through updateLayoutParams while ttExpandedWidth is 0.0f. When TtSearchView is expandable, the LayoutParams will be updated automatically based on user interaction.

The search icon can be set or removed on the fly via ttSearchIcon. The default value is R.styleable.TtSearchView_ttSearchIcon.

When ttIsLocked is set, the TtSearchView is in locked state and cannot be interacted with. The view will then show an explanatory message if expanded - set via ttLockedReason or R.styleable.TtSearchView_ttLockedReason - and an associated icon to replace the default search icon - set via R.styleable.TtSearchView_ttLockedIcon.

All theme attributes used by this control are declared in com.tomtom.tools.android.core.theme. To use this control, it is mandatory to define these attribute values.

Parameters

context

The display context.

attrs

The attribute set provided in the layout XML file.

defStyleAttr

The default style attribute set. The default value is R.attr.tt_searchview_style

Constructors

TtSearchView

@JvmOverloads

constructor(context: Context, attrs: AttributeSet?, defStyleAttr: Int = R.attr.tt_searchview_style)

Types

SearchState

enum SearchState : Enum<TtSearchView.SearchState>

The state of the search view. The view's visual components have a different appearance for each state.

Properties

ttExpandedWidth

var ttExpandedWidth: Float

If set, this view's width will expand to the given value upon being tapped. When the view loses focus, it will collapse back to its original width.

ttIsLocked

var ttIsLocked: Boolean

When set, the TtSearchView is in locked state and cannot be interacted with. The view will then show an explanatory message if expanded, and the search icon will be replaced with a locked state icon.

ttLockedReason

var ttLockedReason: String?

When ttIsLocked is set, this can be used to provide the reason why the TtSearchView was locked. Note: the reason is also not visible when locked if a search query was entered.

ttSearchHintTextColor

var ttSearchHintTextColor: Int

The color for the hint text in the search input field. The same color will be applied on the locked reason text (see ttLockedReason).

ttSearchIcon

var ttSearchIcon: Drawable?

The drawable for the search icon. No search icon will be shown when this is set to null.

ttSearchIconTint

var ttSearchIconTint: Int?

The tint color for ttSearchIcon. Set to null to have no tint.

ttSearchingIndicatorTint

var ttSearchingIndicatorTint: Int?

The tint color for the searching indicator. Set to null to have no tint.

ttSearchTextAppearance

var ttSearchTextAppearance: Int

The TextAppearance for the texts in the search input field. It is applied to the query text inputted by user, the hint text when query text is empty, and the ttLockedReason.

ttSearchTextColor

var ttSearchTextColor: Int

The color for the text in the search input field.

Functions

getSearchState

fun getSearchState(): TtSearchView.SearchState

Retrieve the current SearchState.

onInterceptTouchEvent

open override fun onInterceptTouchEvent(ev: MotionEvent): Boolean

This override is necessary in order to make sure tapping on any part of the SearchView will expand it if it's collapsed. Otherwise, child views would intercept the click and expanding would not work correctly.

requestFocus

open override fun requestFocus(direction: Int, previouslyFocusedRect: Rect?): Boolean

setOnQueryTextFocusChangeListener

open override fun setOnQueryTextFocusChangeListener(listener: View.OnFocusChangeListener?)

setQuery

open override fun setQuery(query: CharSequence?, submit: Boolean)

fun setQuery(query: CharSequence?, submit: Boolean, moveSelectionToFirstCharacter: Boolean = false)

Set query string in the text filed, submit the query if it's needed and moveSelectionToFirstCharacter optionally.

setTtLockedReason

fun setTtLockedReason(reason: StringResolver?)

When ttIsLocked is set, this can be used to provide the reason why the TtSearchView was locked. Note: reason is also not visible when locked if a search query was entered.

TtSearchView

Parameters

Constructors

Types

Properties

Functions

Inherited functions