diff options
author | julieng <julien.gattelier@gmail.com> | 2021-10-02 17:20:24 +0200 |
---|---|---|
committer | SphinxKnight <SphinxKnight@users.noreply.github.com> | 2021-10-02 17:30:20 +0200 |
commit | 1407c8fdef01ecd0ffb8a8bd46e7113f119b9fde (patch) | |
tree | 30a56efd3eff3a01bd1611e1840fdbbfacf544a4 /files/fr/web/api/blob | |
parent | c05efa8d7ae464235cf83d7c0956e42dc6974103 (diff) | |
download | translated-content-1407c8fdef01ecd0ffb8a8bd46e7113f119b9fde.tar.gz translated-content-1407c8fdef01ecd0ffb8a8bd46e7113f119b9fde.tar.bz2 translated-content-1407c8fdef01ecd0ffb8a8bd46e7113f119b9fde.zip |
convert content to md
Diffstat (limited to 'files/fr/web/api/blob')
-rw-r--r-- | files/fr/web/api/blob/blob/index.md | 81 | ||||
-rw-r--r-- | files/fr/web/api/blob/index.md | 130 | ||||
-rw-r--r-- | files/fr/web/api/blob/size/index.md | 30 | ||||
-rw-r--r-- | files/fr/web/api/blob/type/index.md | 60 |
4 files changed, 121 insertions, 180 deletions
diff --git a/files/fr/web/api/blob/blob/index.md b/files/fr/web/api/blob/blob/index.md index eb08cd3667..94d84cdac1 100644 --- a/files/fr/web/api/blob/blob/index.md +++ b/files/fr/web/api/blob/blob/index.md @@ -10,68 +10,51 @@ tags: - Reference translation_of: Web/API/Blob/Blob --- -<div>{{APIRef("File API")}}</div> +{{APIRef("File API")}} -<p>Le constructeur <code><strong>Blob()</strong></code> retourne un nouvel objet {{domxref("Blob")}}. Le contenu d'un blob consiste en une concaténation de valeurs données dans le tableau passé en paramètre.</p> +Le constructeur **`Blob()`** retourne un nouvel objet {{domxref("Blob")}}. Le contenu d'un blob consiste en une concaténation de valeurs données dans le tableau passé en paramètre. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox">var aBlob = new Blob(<em> array</em>) -var aBlob = new Blob( <em>array</em>, <em>options</em> ); -</pre> + var aBlob = new Blob( array) + var aBlob = new Blob( array, options ); -<h3 id="Paramètres">Paramètres</h3> +### Paramètres -<dl> - <dt><code>array</code></dt> - <dd>Un tableau ({{jsxref("Array")}}) d'objets de type {{jsxref("ArrayBuffer")}}, {{domxref("ArrayBufferView")}}, {{domxref("Blob")}}, {{domxref("DOMString")}}, ou un mélange de tels objets qui seront insérés dans le {{domxref("Blob")}}. Les chaînes <code>DOMString</code> seront encodées en UTF-8.</dd> - <dt><code>options</code> {{optional_inline}}</dt> - <dd>Un paramètre optionnel qui est un dictionnaire <code>BlobPropertyBag</code> et qui peut être utilisé pour définir les deux attributs suivants : - <ul> - <li><code>type</code> : cet attribut représente le type MIME du contenu du tableau qui sera inséré dans le blob. La valeur par défaut pour cette propriété est la chaîne vide <code>""</code>.</li> - <li><code>endings</code> : cet attribut spécifie la façon dont les chaînes qui contiennent des sauts de lignes (<code>\n</code>) doivent être retranscrites. Il peut prendre l'une de ces valeurs : - <ul> - <li><code>"native"</code> indiquera que les caractères de fin doivent être adaptés pour correspondre à ceux utilisés par le système d'exploitation</li> - <li><code>"transparent"</code> indiquera que les fin de lignes sont stockées telles quelles dans le blob (aucune modification).</li> - </ul> - La valeur par défaut pour cet attribut est <code>"transparent"</code>. {{non-standard_inline}}</li> - </ul> - </dd> -</dl> +- `array` + - : Un tableau ({{jsxref("Array")}}) d'objets de type {{jsxref("ArrayBuffer")}}, {{domxref("ArrayBufferView")}}, {{domxref("Blob")}}, {{domxref("DOMString")}}, ou un mélange de tels objets qui seront insérés dans le {{domxref("Blob")}}. Les chaînes `DOMString` seront encodées en UTF-8. +- `options` {{optional_inline}} -<h2 id="Exemples">Exemples</h2> + - : Un paramètre optionnel qui est un dictionnaire `BlobPropertyBag` et qui peut être utilisé pour définir les deux attributs suivants : -<pre class="brush: js">// Un tableau qui contient une seule DOMString -var aFileParts = ['<a id="a"><b id="b">Coucou :) !</b></a>']; + - `type` : cet attribut représente le type MIME du contenu du tableau qui sera inséré dans le blob. La valeur par défaut pour cette propriété est la chaîne vide `""`. + - `endings` : cet attribut spécifie la façon dont les chaînes qui contiennent des sauts de lignes (`\n`) doivent être retranscrites. Il peut prendre l'une de ces valeurs : -// Le blob -var oMyBlob = new Blob(aFileParts, {type : 'text/html'});</pre> + - `"native"` indiquera que les caractères de fin doivent être adaptés pour correspondre à ceux utilisés par le système d'exploitation + - `"transparent"` indiquera que les fin de lignes sont stockées telles quelles dans le blob (aucune modification). + + La valeur par défaut pour cet attribut est `"transparent"`. {{non-standard_inline}} -<h2 id="Spécifications">Spécifications</h2> +## Exemples -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Spécification</th> - <th scope="col">État</th> - <th scope="col">Commentaires</th> - </tr> - <tr> - <td>{{SpecName('File API', '#constructorBlob', 'Blob()')}}</td> - <td>{{Spec2('File API')}}</td> - <td>Définition initiale.</td> - </tr> - </tbody> -</table> +```js +// Un tableau qui contient une seule DOMString +var aFileParts = ['<a id="a"><b id="b">Coucou :) !</b></a>']; + +// Le blob +var oMyBlob = new Blob(aFileParts, {type : 'text/html'}); +``` -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> +## Spécifications +| Spécification | État | Commentaires | +| ------------------------------------------------------------------------ | ---------------------------- | -------------------- | +| {{SpecName('File API', '#constructorBlob', 'Blob()')}} | {{Spec2('File API')}} | Définition initiale. | +## Compatibilité des navigateurs -<p>{{Compat("api.Blob.Blob")}}</p> +{{Compat("api.Blob.Blob")}} -<h2 id="Voir_aussi">Voir aussi</h2> +## Voir aussi -<ul> - <li>Le déprécié {{domxref("BlobBuilder")}} qui a été remplacé par ce constructeur.</li> -</ul> +- Le déprécié {{domxref("BlobBuilder")}} qui a été remplacé par ce constructeur. diff --git a/files/fr/web/api/blob/index.md b/files/fr/web/api/blob/index.md index 6cf6467846..3e79c90f0f 100644 --- a/files/fr/web/api/blob/index.md +++ b/files/fr/web/api/blob/index.md @@ -7,61 +7,52 @@ tags: - WebAPI translation_of: Web/API/Blob --- -<div>{{APIRef("File API")}}</div> +{{APIRef("File API")}} -<p>Un objet <strong><code>Blob</code></strong> représente un objet, semblable à un fichier, qui est immuable et qui contient des données brutes. Les <em>blobs</em> (pour <em><strong>B</strong>inary <strong>L</strong>arge <strong>Ob</strong>jects</em>) représentent des données qui ne sont pas dans un format JavaScript natif. L'interface {{domxref("File")}} est basée sur l'interface <code>Blob</code> et hérite des fonctionnalités de cette dernière tout en ajoutant des fonctionnalités pour gérer les fichiers sur le système de l'utilisateur.</p> +Un objet **`Blob`** représente un objet, semblable à un fichier, qui est immuable et qui contient des données brutes. Les _blobs_ (pour **\*B**inary **L**arge **Ob**jects\*) représentent des données qui ne sont pas dans un format JavaScript natif. L'interface {{domxref("File")}} est basée sur l'interface `Blob` et hérite des fonctionnalités de cette dernière tout en ajoutant des fonctionnalités pour gérer les fichiers sur le système de l'utilisateur. -<p>Pour construire un <code>Blob</code> à partir d'objets qui ne sont pas des blobs ou à partir d'autres données, on pourra utiliser le constructeur {{domxref("Blob.Blob", "Blob()")}}. Pour créer un blob qui contient un sous-ensemble d'un autre blob, on pourra employer la méthode {{domxref("Blob.slice()", "slice()")}}. Pour obtenir un <code>Blob</code> à partir d'un fichier du système de l'utilisateur, consulter la documentation {{domxref("File")}}.</p> +Pour construire un `Blob` à partir d'objets qui ne sont pas des blobs ou à partir d'autres données, on pourra utiliser le constructeur {{domxref("Blob.Blob", "Blob()")}}. Pour créer un blob qui contient un sous-ensemble d'un autre blob, on pourra employer la méthode {{domxref("Blob.slice()", "slice()")}}. Pour obtenir un `Blob` à partir d'un fichier du système de l'utilisateur, consulter la documentation {{domxref("File")}}. -<p>Les API qui acceptent des objets <code>Blob</code> sont également listées sur la documentation de {{domxref("File")}}.</p> +Les API qui acceptent des objets `Blob` sont également listées sur la documentation de {{domxref("File")}}. -<div class="note"> -<p><strong>Note :</strong> La méthode <code>slice()</code> utilisait auparavant un deuxième argument qui indiquait le nombre d'octets à copier dans le nouveau blob. Si on utilisait un couple de valeur <code>début + longueur</code> qui dépassait la taille du blob source, le blob qui était renvoyé contenait les données à partir de l'indice de début et jusuq'à la fin du blob.</p> -</div> +> **Note :** La méthode `slice()` utilisait auparavant un deuxième argument qui indiquait le nombre d'octets à copier dans le nouveau blob. Si on utilisait un couple de valeur `début + longueur` qui dépassait la taille du blob source, le blob qui était renvoyé contenait les données à partir de l'indice de début et jusuq'à la fin du blob. -<div class="note"> - <p><strong>Note :</strong> La méthode <code>slice()</code> doit être utilisée avec certains préfixes sur certaines versions de navigateurs : <code>blob.mozSlice()</code> pour Firefox 12 et antérieur, <code>blob.webkitSlice()</code> dans Safari. Un ancienne version de <code>slice()</code> sans préfixes avait une sémantique différente et est désormais obsolète. La prise en charge de <code>blob.mozSlice()</code> a été abandonnée avec Firefox 30.</p> -</div> +> **Note :** La méthode `slice()` doit être utilisée avec certains préfixes sur certaines versions de navigateurs : `blob.mozSlice()` pour Firefox 12 et antérieur, `blob.webkitSlice()` dans Safari. Un ancienne version de `slice()` sans préfixes avait une sémantique différente et est désormais obsolète. La prise en charge de `blob.mozSlice()` a été abandonnée avec Firefox 30. -<h2 id="Constructeur">Constructeur</h2> +## Constructeur -<dl> - <dt>{{domxref("Blob.Blob", "Blob(blobParts[, options])")}}</dt> - <dd>Ce constructeur renvoie un nouvel objet <code>Blob</code> qui contient la concaténation des valeurs du tableau passé en paramètre.</dd> -</dl> +- {{domxref("Blob.Blob", "Blob(blobParts[, options])")}} + - : Ce constructeur renvoie un nouvel objet `Blob` qui contient la concaténation des valeurs du tableau passé en paramètre. -<h2 id="Propriétés">Propriétés</h2> +## Propriétés -<dl> - <dt>{{domxref("Blob.isClosed")}} {{readonlyinline}} {{experimental_inline}}</dt> - <dd>Un booléen qui indique si la méthode {{domxref("Blob.close()")}} a été appelée sur le blob. Les blobs qui ont été fermés ne peuvent pas être lus.</dd> - <dt>{{domxref("Blob.size")}} {{readonlyinline}}</dt> - <dd>La taille des données contenues dans l'objet <code>Blob</code>, exprimée en octets.</dd> - <dt>{{domxref("Blob.type")}} {{readonlyinline}}</dt> - <dd>Une chaîne de caractères qui indique le type MIME des données contenues dans le <code>Blob</code>. Si le type est inconnu, la chaîne de caractères est vide.</dd> -</dl> +- {{domxref("Blob.isClosed")}} {{readonlyinline}} {{experimental_inline}} + - : Un booléen qui indique si la méthode {{domxref("Blob.close()")}} a été appelée sur le blob. Les blobs qui ont été fermés ne peuvent pas être lus. +- {{domxref("Blob.size")}} {{readonlyinline}} + - : La taille des données contenues dans l'objet `Blob`, exprimée en octets. +- {{domxref("Blob.type")}} {{readonlyinline}} + - : Une chaîne de caractères qui indique le type MIME des données contenues dans le `Blob`. Si le type est inconnu, la chaîne de caractères est vide. -<h2 id="Méthodes">Méthodes</h2> +## Méthodes -<dl> - <dt>{{domxref("Blob.close()")}} {{experimental_inline}}</dt> - <dd>Cette méthode clotûre le blob et libère éventuellement les ressources sous-jacentes.</dd> - <dt>{{domxref("Blob.slice()", "Blob.slice([début[, fin[, contentType]]])")}}</dt> - <dd>Cette méthode renvoie un nouvel objet <code>Blob</code> qui contient les données dans le fragment du <code>Blob</code> source entre <code>début</code> et <code>fin</code>.</dd> -</dl> +- {{domxref("Blob.close()")}} {{experimental_inline}} + - : Cette méthode clotûre le blob et libère éventuellement les ressources sous-jacentes. +- {{domxref("Blob.slice()", "Blob.slice([début[, fin[, contentType]]])")}} + - : Cette méthode renvoie un nouvel objet `Blob` qui contient les données dans le fragment du `Blob` source entre `début` et `fin`. -<h2 id="Exemples">Exemples</h2> +## Exemples -<h3 id="Utilisation_du_constructeur_Blob">Utilisation du constructeur <code>Blob</code></h3> +### Utilisation du constructeur `Blob` -<p>Le constructeur {{domxref("Blob.Blob", "Blob()")}} permet de créer des blobs à partir d'autres objets. Par exemple, on peut construire un blob à partir d'une chaîne de caractères :</p> +Le constructeur {{domxref("Blob.Blob", "Blob()")}} permet de créer des blobs à partir d'autres objets. Par exemple, on peut construire un blob à partir d'une chaîne de caractères : -<pre>var debug = {coucou: "monde"}; -var blob = new Blob([JSON.stringify(debug, null, 2)], {type : 'application/json'});</pre> + var debug = {coucou: "monde"}; + var blob = new Blob([JSON.stringify(debug, null, 2)], {type : 'application/json'}); -<h3 id="Créer_une_URL_de_données_vers_un_tableau_typé">Créer une URL de données vers un tableau typé</h3> +### Créer une URL de données vers un tableau typé -<pre class="brush: js">var typedArray = GetTheTypedArraySomehow(); +```js +var typedArray = GetTheTypedArraySomehow(); // On ajoute un type MIME pertinent var blob = new Blob([typedArray], {type: 'application/octet-binary'}); @@ -73,47 +64,36 @@ var url = URL.createObjectURL(blob); // désormais on peut utiliser l'URL dans tout // contexte qui utilise des URL (img.src par // exemple) -</pre> +``` -<h3 id="Extraire_des_données_à_partir_d'un_blob">Extraire des données à partir d'un blob</h3> +### Extraire des données à partir d'un blob -<p>La seule façon de lire le contenu d'un blob est d'utiliser un objet {{domxref("FileReader")}}. Dans le code qui suit, on lit le contenu d'un blob sous la forme d'un tableau typé.</p> +La seule façon de lire le contenu d'un blob est d'utiliser un objet {{domxref("FileReader")}}. Dans le code qui suit, on lit le contenu d'un blob sous la forme d'un tableau typé. -<pre class="brush: js">var reader = new FileReader(); +```js +var reader = new FileReader(); reader.addEventListener("loadend", function() { // reader.result contient le contenu du // blob sous la forme d'un tableau typé }); -reader.readAsArrayBuffer(blob);</pre> - -<p>En utilisant d'autres méthodes de {{domxref("FileReader")}}, on peut lire le contenu du blob si c'est une chaîne ou une URL de données.</p> - -<h2 id="Spécifications">Spécifications</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Spécification</th> - <th scope="col">État</th> - <th scope="col">Commentaires</th> - </tr> - <tr> - <td>{{SpecName('File API','#blob','Blob')}}</td> - <td>{{Spec2('File API')}}</td> - <td>Définition initiale.</td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> - -<p>{{Compat("api.Blob")}}</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>{{domxref("BlobBuilder")}}</li> - <li>{{domxref("File")}}</li> - <li>{{domxref("URL.createObjectURL")}}</li> - <li><a href="/fr/docs/Mozilla/Tech/XPCOM/Language_Bindings/Components.utils.importGlobalProperties">Components.utils.importGlobalProperties</a></li> -</ul> +reader.readAsArrayBuffer(blob); +``` + +En utilisant d'autres méthodes de {{domxref("FileReader")}}, on peut lire le contenu du blob si c'est une chaîne ou une URL de données. + +## Spécifications + +| Spécification | État | Commentaires | +| ---------------------------------------------------- | ---------------------------- | -------------------- | +| {{SpecName('File API','#blob','Blob')}} | {{Spec2('File API')}} | Définition initiale. | + +## Compatibilité des navigateurs + +{{Compat("api.Blob")}} + +## Voir aussi + +- {{domxref("BlobBuilder")}} +- {{domxref("File")}} +- {{domxref("URL.createObjectURL")}} +- [Components.utils.importGlobalProperties](/fr/docs/Mozilla/Tech/XPCOM/Language_Bindings/Components.utils.importGlobalProperties) diff --git a/files/fr/web/api/blob/size/index.md b/files/fr/web/api/blob/size/index.md index b82751abd0..495747778f 100644 --- a/files/fr/web/api/blob/size/index.md +++ b/files/fr/web/api/blob/size/index.md @@ -9,32 +9,28 @@ tags: translation_of: Web/API/File/fileSize original_slug: Web/API/File/fileSize --- -<p>{{APIRef("File API") }}{{non-standard_header}}</p> +{{APIRef("File API") }}{{non-standard_header}} -<p>{{obsolete_header(7.0)}}</p> +{{obsolete_header(7.0)}} -<h2 id="Résumé">Résumé</h2> +## Résumé -<p>Renvoie la taille du fichier en octets.</p> +Renvoie la taille du fichier en octets. -<div class="note"> - <p><strong>Note :</strong> Cette propriété est dépréciée. Utilisez {{domxref("Blob.size")}} à la place.</p> -</div> +> **Note :** Cette propriété est dépréciée. Utilisez {{domxref("Blob.size")}} à la place. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre>var size = <em>instanceOfFile</em>.fileSize</pre> + var size = instanceOfFile.fileSize -<h2 id="Valeur">Valeur</h2> +## Valeur -<p>Un nombre.</p> +Un nombre. -<h2 id="Spécification">Spécification</h2> +## Spécification -<p>Ne fait partie d'aucune spécification.</p> +Ne fait partie d'aucune spécification. -<h2 id="Voir_aussi">Voir aussi</h2> +## Voir aussi -<ul> - <li>{{domxref("Blob.size")}}</li> -</ul> +- {{domxref("Blob.size")}} diff --git a/files/fr/web/api/blob/type/index.md b/files/fr/web/api/blob/type/index.md index 8823dd1bb9..166428cb4a 100644 --- a/files/fr/web/api/blob/type/index.md +++ b/files/fr/web/api/blob/type/index.md @@ -8,23 +8,24 @@ tags: - Propriété translation_of: Web/API/Blob/type --- -<div>{{APIRef("File API")}}</div> +{{APIRef("File API")}} -<p>La propriété <strong><code>type</code></strong> de l'objet <a href="fr/docs/Web/API/Blob"><code>Blob</code></a> fourni le type MIME (Internet media type) d'un fichier. Celle-ci retourne une chaîne de caractère vide si le type n'a pas pu être déterminé.</p> +La propriété **`type`** de l'objet [`Blob`](fr/docs/Web/API/Blob) fourni le type MIME (Internet media type) d'un fichier. Celle-ci retourne une chaîne de caractère vide si le type n'a pas pu être déterminé. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox">var mimetype = <var>instanceOfFile</var>.type</pre> + var mimetype = instanceOfFile.type -<h2 id="Valeur">Valeur</h2> +## Valeur -<p>Une chaîne de caractères (par exemple : "image/png").</p> +Une chaîne de caractères (par exemple : "image/png"). -<h2 id="Exemple">Exemple</h2> +## Exemple -<pre class="brush:js">var i, fileInput, files, allowedFileTypes; +```js +var i, fileInput, files, allowedFileTypes; -// fileInput est un HTMLInputElement: <input type="file" multiple id="myfileinput"> +// fileInput est un HTMLInputElement: <input type="file" multiple id="myfileinput"> fileInput = document.getElementById("myfileinput"); // files est un objet FileList (similaire à NodeList) @@ -33,43 +34,24 @@ files = fileInput.files; // notre application accepte seulement les images de type *.png, *.jpeg et *.gif allowedFileTypes = ["image/png", "image/jpeg", "image/gif"]; -for (i = 0; i < files.length; i++) { +for (i = 0; i < files.length; i++) { // Vérifie si file.type est un type autorisé. - if (allowedFileTypes.indexOf(<strong>files[i].type</strong>) > -1) { + if (allowedFileTypes.indexOf(files[i].type) > -1) { // le type du fichier (file) correspond à l'un des types autorisés. Faites quelque chose ici. } }); -</pre> +``` -<h2 id="Spécifications">Spécifications</h2> +## Spécifications -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Spécification</th> - <th scope="col">Statut</th> - <th scope="col">Commentaire</th> - </tr> - <tr> - <td>{{SpecName('File API', '#dfn-type', 'type')}}</td> - <td>{{Spec2('File API')}}</td> - <td>Définition initiale.</td> - </tr> - </tbody> -</table> +| Spécification | Statut | Commentaire | +| ------------------------------------------------------------ | ---------------------------- | -------------------- | +| {{SpecName('File API', '#dfn-type', 'type')}} | {{Spec2('File API')}} | Définition initiale. | -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs -<div> -<div> +{{Compat("api.Blob.type")}} +## Voir aussi -<p>{{Compat("api.Blob.type")}}</p> -</div> - -<h2 id="Voir_aussi">Voir aussi</h2> -</div> - -<ul> - <li>{{domxref("Blob")}}</li> -</ul> +- {{domxref("Blob")}} |