Skip to main content

SearchBox

A search box provides an input field for searching content within a site or app to find specific items.

Examples

Properties

NameTypeDefaultDescription
valuestringThe value of the text in the SearchBox.
placeholderstringPlaceholder for the search box.
underlinedboolfalseWhether or not the SearchBox is underlined.
iconstringReplace "search" icon with a custom one.
iconColorstringIcon color.
datastringAdditional data attached to the control. The value is passed in event data.
onChangeboolfalseWhether change event should be fired while text is typed into the SearchBox. This property is used by command-based client libraries only like Bash.

Events

NameDescription
searchFires when the user presses Enter in the search box.
clearFires when the user clears the search box by either clicking 'X' or hitting escape.
changeFires when the typed input for the SearchBox has changed. For performance optimization this event is disabled unless onChange property set to true.