# j-Prompt

> Le composant (singleton) affiche une fenêtre immédiate avec une entrée de ligne unique ou multilienne.

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

Le composant (singleton) affiche une fenêtre immédiate avec une entrée de ligne unique ou multilienne.


__Configuration__ :

- `zindex {Number}` en option (par défaut : `12`)
- `width {Number}` optionnel, largeur maximale (defaut : `400`)
- `cancel {String}` optionnel, étiquette pour le bouton d'annulation (défaut: `Cancel`)
- `submit {String}` optionnel, étiquette pour le bouton de soumission (défaut: `OK`)

__Exemple__ :

```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);
```

Utilisez-le avec `<ui-component name="prompt">`. Lorsque le composant n'est pas encore chargé, jComponent le télécharge lors de la première utilisation depuis l'adresse dans `DEF.fallback` (le CDN Componentator par défaut). Auteur : Peter Širka. Source : le référentiel de composants Componentator, licence 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>
```