# j-Prompt

> El componente (singleton) muestra una ventana de aviso con entrada de una o varias líneas.

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

El componente (singleton) muestra una ventana de aviso con entrada de una o varias líneas.


__Configuración__:

- `zindex {Number}` opcional (predeterminado: `12`)
- `width {Number}` opcional, máx. ancho (predeterminado: `400`)
- `cancel {String}` opcional, etiqueta para el botón cancelar (predeterminado: `Cancel`)
- `submit {String}` opcional, etiqueta para el botón de envío (predeterminado: `OK`)

__Ejemplo__:

```js
var opt = {};
opt.name = 'A title'; // optional
opt.summary = 'A small sumarization'; // optional
opt.value = ''; // a default value, optional
// opt.type = 'password'; // only for single-line mode
// opt.width = config.width; // max. width, optional
// opt.zindex = config.zindex; // a custom zindex, optional
// opt.centered = true; // centers the window to the middle of the screen
// opt.newbie = true; // allows to submit a default value
// opt.multiline = true; // NEW: enables textarea with 3 rows
// opt.monospace = true; // NEW: enables monospace text

opt.cancel = function(val) {
	// @val {String}
	// prompt is canceled
};

opt.callback = function(val) {
	// @val {String}
	// changed
};

opt.hide = function() {
	// prompt is hidden/closed
};

SETTER('prompt/show', opt);
```

Úselo con `<ui-component name="prompt">`. 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="prompt"></ui-component>

<script>
	setTimeout(function() {
		var opt = {};
		opt.name = 'Folder name';
		opt.summary = 'Enter a folder name for your documents:';
		opt.value = '';

		opt.callback = function(val) {
			console.log('Returned', val);
		};

		opt.cancel = function(val) {
			console.log('Canceled', val);
		};

		opt.hide = function() {
			console.log('Hidden');
		};

		SETTER('prompt/show', opt);
	}, 1000);
</script>
```
