A search input element. The component will automatically render as a Material Design search input on Android devices.
Most attributes that can be used for a normal <input> element can also be used on the <ons-search-input> element.
Even though ons-input supports type="search", Onsen UI provides an extra element ons-search-input that styles the input as a real search bar:
<ons-search-input placeholder="Search something"></ons-search-input>
As usual, any attribute for <input> element works for the search input (except type which is fixed to search).
For normal input elements is possible to define a <label> tab with the for attribute to link it to an input element.
Unfortunately this does not work with custom elements like <ons-label> so in order to do it we need to set the id attribute of the inner input element. This is done using the input-id attribute.
<label for="username">Username</label>
<ons-input input-id="username"></ons-input>
This work with any input in Onsen UI such as checkboxes, radios, etc.
modifier attribute<ons-input> element is used to display a text input.<ons-range> element is used to display a range slider.<ons-switch> element is used to display a draggable toggle switch.<ons-select> element is used to display a select box.<ons-checkbox> element is used to display a checkbox.<ons-radio> element is used to display a radio button.Attributes are added directly to the element. You can do this in HTML or JS.
HTML: <ons-search-input someAttribute="true" anotherAttribute><ons-search-input>
JS: document.querySelector('ons-search-input').setAttribute('someAttribute', 'true')
| Name | Type | Description |
|---|---|---|
| input-id | String |
Specify the “id” attribute of the inner <input> element. This is useful when using <label for="..."> elements.
Optional.
|
Properties are accessed on the element through JS, and should be get and set directly. For example: document.querySelector('ons-search-input').value.
| Name | Description |
|---|---|
| value | The current value of the input. |
| disabled | Whether the input is disabled or not. |
Modifiers are set in the modifier attribute. To use more than one, separate them by spaces. For example:
<ons-search-input modifier="material
modifier2"><ons-search-input>.
| Name | Description |
|---|---|
| material | Displays a Material Design search input. |
These methods are called directly on the DOM element. Get a reference to the element in JS, and the methods below will be available to call on it. For example: document.querySelector('ons-search-input').someMethod().
| Signature | Description |
|---|---|
| focus() | Focuses the input. |
| blur() | Removes focus from the input. |
Focuses the input.
Removes focus from the input.
If you have any questions, use our Community Forum or talk to us on Discord chat. The Onsen UI team and your peers in the community will work together to help solve your issues.
For bug reports and feature requests use our GitHub Issues page.