# j-FileReader

> j-FileReader : singleton ; utilisation facile

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

- singleton
- uniquement pour les fichiers texte

__Méthodes__ :
- `component.open(opt)` - ouvre le navigateur de fichiers
	- `opt.multiple {Boolean}` permet plusieurs fichiers (par défaut : `false`)
	- `opt.accept {String}` autorise uniquement le type de contenu spécifié (par défaut : `undefined`)
	- `opt.base64 {Boolean}` lit un fichier en encodage Base64 (par défaut : `false`)
	- __NOUVEAU__ : `opt.files {HTTP Files}` lit les fichiers, par ex. par glisser-déposer
	- `opt.callback {Function(file)}` un rappel
	- __NOUVEAU__ : `opt.progress {Function(percentage, file)}` en option

```js
var opt = {};
opt.accept = 'text/*';
// opt.files = e.files;
opt.callback = function(file) {
	console.log(file);
};
SETTER('filereader/open', opt);
```

Utilisez-le avec `<ui-component name="filereader">`. 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="filereader"></ui-component>
<a href="javascript:fopen()">OPEN FILE</a>

<script>
	function fopen() {
		var opt = {};
		opt.accept = 'text/*';
		opt.callback = function(file) {
			$(document.body).append('<div><pre><code>{0}</code></pre></div>'.format(JSON.stringify(file, null, '    ').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;')));
		};
		SETTER('filereader/open', opt);
	}
</script>
```