# j-SearchBox

> El componente contiene un cuadro de búsqueda (entrada).

Framework: jcomponent20
Product: jComponent 20 (jcomponent@20)
Language: es
Content-SHA256: 4875339f9a44c0280886a527d06c866e4b84810a9876e503460b0c5c8a9dddf8
Snapshot: c0700e321579725c5cf4f5ace1ad7d2866d1b4f93c24a63c0b41b6b7998e976c
Sources: components@910ed1a86f6e72b4f031d3ad0dc7844f9fc5cb8e
Review: not-recorded

El componente contiene un cuadro de búsqueda (entrada).


__Configuración__:

- `exec {String}` un enlace al `function(model, component, changetype)`, se ejecutará si el usuario presiona enter
- `autocomplete {String}` un enlace al `function(component, input)`, se ejecutará si el usuario enfoca el cuadro de búsqueda
- `init {String}` un enlace al `function(component)`, se ejecutará si se inicializa el componente
- `placeholder {String}` un marcador de posición para el cuadro de búsqueda
- `cleartype {Boolean}` borra el tipo cuando el usuario realizará `ESC` (predeterminado: `false`)
- Enlace de pulsación de tecla `keypress {Boolean}` (predeterminado: `false`)
- `autotrim {Boolean}` recorta el valor automáticamente (predeterminado: `true`)
- `clicktype {String}` un enlace al `function(component, currenttype, currentvalue)`, se ejecutará si el usuario hace clic en el `type` (se debe configurar un nuevo `type` a través de `component.type(html, value)`)

__Métodos__:

- `component.type(html, id, [noemit])` agrega un nuevo tipo antes de la entrada de búsqueda
- `component.enter()` realiza la búsqueda manualmente
- __NUEVO__: `component.show()` enfoca la entrada

Úselo con `<ui-component name="searchbox">`. Cuando el componente aún no está cargado, jComponent lo descarga en el primer uso desde la dirección en `DEF.fallback` (el CDN Componentator de forma predeterminada). Autor: Peter Širka. Fuente: repositorio de componentes Componentator, licencia MIT.

```html example.html
<ui-component name="menu"></ui-component>
<ui-component name="searchbox" config="exec:searchbox_enter;clicktype:searchbox_type;init:searchbox_init;placeholder:Search and press enter ..."></ui-component>

<script>
	function searchbox_enter(model, component) {

		// model.type
		// model.value

		alert(model.type + ': ' + model.value);
    }

    function searchbox_init(component) {
    	component.type('<i class="ti ti-user"></i> By name', 'name', true);
    }

    function searchbox_type(component) {
    	var opt = {};
		opt.items = [{ name: 'By name', value: 'name', icon: 'user' }, { name: 'By subject', value: 'subject', icon: 'text-width' }, { name: 'By body', value: 'body', icon: 'file-alt' }];
		opt.align = 'left';
		opt.element = component.element;
		opt.callback = function(selected) {
			component.type('<i class="ti ti-{0}"></i> {1}'.format(selected.icon, selected.name), selected.value, true);
		};
		SETTER('menu', 'show', opt);
    }

</script>
```