diff options
Diffstat (limited to 'files/pt-pt/web/api/filereader')
| -rw-r--r-- | files/pt-pt/web/api/filereader/abort/index.html | 58 | ||||
| -rw-r--r-- | files/pt-pt/web/api/filereader/error/index.html | 54 | ||||
| -rw-r--r-- | files/pt-pt/web/api/filereader/index.html | 172 | ||||
| -rw-r--r-- | files/pt-pt/web/api/filereader/readasarraybuffer/index.html | 64 | ||||
| -rw-r--r-- | files/pt-pt/web/api/filereader/readasbinarystring/index.html | 85 | ||||
| -rw-r--r-- | files/pt-pt/web/api/filereader/readasdataurl/index.html | 133 | ||||
| -rw-r--r-- | files/pt-pt/web/api/filereader/readastext/index.html | 63 | ||||
| -rw-r--r-- | files/pt-pt/web/api/filereader/readystate/index.html | 96 | ||||
| -rw-r--r-- | files/pt-pt/web/api/filereader/result/index.html | 105 |
9 files changed, 0 insertions, 830 deletions
diff --git a/files/pt-pt/web/api/filereader/abort/index.html b/files/pt-pt/web/api/filereader/abort/index.html deleted file mode 100644 index 3ffeae8ce9..0000000000 --- a/files/pt-pt/web/api/filereader/abort/index.html +++ /dev/null @@ -1,58 +0,0 @@ ---- -title: FileReader.abort() -slug: Web/API/FileReader/abort -tags: - - API - - Ficheiros - - File API - - FileReader - - Referencia - - abort - - metodo -translation_of: Web/API/FileReader/abort ---- -<div>{{APIRef("File API")}}</div> - -<p>O método <strong><code>abort</code></strong> aborta a operação de leitura. Ao completar o abortamento, o {{domxref("FileReader.readyState","readyState")}} é <code>DONE</code>.</p> - -<h2 id="Sintaxe">Sintaxe</h2> - -<pre class="syntaxbox notranslate"><var>instanceOfFileReader</var>.abort();</pre> - -<h3 id="Exceções">Exceções</h3> - -<dl> - <dt><code>DOM_FILE_ABORT_ERR</code></dt> - <dd>Lançado quando <code>abort</code> é chamado enquanto não há uma operação de leitura em progresso (ou seja, quando o <em>state</em> não é <code>LOADING</code>).</dd> -</dl> - -<h2 id="Especificações">Especificações</h2> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Especificação</th> - <th scope="col">Estado</th> - <th scope="col">Comentário</th> - </tr> - </thead> - <tbody> - <tr> - <td>{{SpecName("File API", "#abort", "abort()")}}</td> - <td>{{Spec2("File API")}}</td> - <td>Definição inicial</td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilidade">Compatibilidade</h2> - - - -<p>{{Compat("api.FileReader.abort")}}</p> - -<h2 id="Ver_também">Ver também</h2> - -<ul> - <li>{{domxref("FileReader")}}</li> -</ul> diff --git a/files/pt-pt/web/api/filereader/error/index.html b/files/pt-pt/web/api/filereader/error/index.html deleted file mode 100644 index b308705d79..0000000000 --- a/files/pt-pt/web/api/filereader/error/index.html +++ /dev/null @@ -1,54 +0,0 @@ ---- -title: FileReader.error -slug: Web/API/FileReader/error -tags: - - API - - Ficheiros - - File API - - Propriedade - - Referencia -translation_of: Web/API/FileReader/error ---- -<div>{{APIRef("File API")}}</div> - -<p>A propriedade <code><strong>error</strong></code> de {{domxref("FileReader")}} retorna o erro que ocorreu ao ler o ficheiro.</p> - -<h2 id="Sintaxe">Sintaxe</h2> - -<pre class="syntaxbox notranslate">var <var>error</var> = <var>instanceOfFileReader</var>.error -</pre> - -<h2 id="Valor">Valor</h2> - -<p>Um {{domxref("DOMError")}} com o erro. Em Chrome 48+/Firefox 58+ esta propriedade retorna uma {{domxref("DOMException")}} porque <code>DOMError</code> foi removido do <em>standard</em> do DOM.</p> - -<h2 id="Especificações">Especificações</h2> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Especificação</th> - <th scope="col">Estado</th> - <th scope="col">Comentários</th> - </tr> - </thead> - <tbody> - <tr> - <td>{{SpecName("File API", "#dom-filereader-error", "FileReader: error")}}</td> - <td>{{Spec2("File API")}}</td> - <td>Definição inicial</td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilidade">Compatibilidade</h2> - - - -<p>{{Compat("api.FileReader.error")}}</p> - -<h2 id="Ver_também">Ver também</h2> - -<ul> - <li>{{domxref("FileReader")}}</li> -</ul> diff --git a/files/pt-pt/web/api/filereader/index.html b/files/pt-pt/web/api/filereader/index.html deleted file mode 100644 index 0df369c585..0000000000 --- a/files/pt-pt/web/api/filereader/index.html +++ /dev/null @@ -1,172 +0,0 @@ ---- -title: FileReader -slug: Web/API/FileReader -tags: - - API - - DOM - - File API - - Files - - NeedsTranslation - - Reference - - TopicStub - - WebAPI -translation_of: Web/API/FileReader ---- -<p>{{ APIRef("File API") }}</p> - -<h2 id="Summary">Summary</h2> - -<p>The <code>FileReader</code> object lets web applications asynchronously read the contents of files (or raw data buffers) stored on the user's computer, using {{ domxref("File") }} or {{ domxref("Blob") }} objects to specify the file or data to read.</p> - -<p>File objects may be obtained from a {{ domxref("FileList") }} object returned as a result of a user selecting files using the {{ HTMLElement("input") }} element, from a drag and drop operation's <a href="/En/DragDrop/DataTransfer" title="En/DragDrop/DataTransfer"><code>DataTransfer</code></a> object, or from the <code>mozGetAsFile()</code> API on an {{ domxref("HTMLCanvasElement") }}.</p> - -<h2 id="Constructor">Constructor</h2> - -<pre class="syntaxbox">FileReader FileReader();</pre> - -<p>See <a href="/en/Using_files_from_web_applications" title="en/Using files from web applications">Using files from web applications</a> for details and examples.</p> - -<h2 id="Properties" name="Properties">Properties</h2> - -<dl> - <dt>{{domxref("FileReader.error")}} {{readonlyinline}}</dt> - <dd>A {{domxref("DOMError")}} representing the error that occurred while reading the file.</dd> - <dt>{{domxref("FileReader.readyState")}} {{readonlyinline}}</dt> - <dd>A number indicating the state of the <code>FileReader</code>. This will be one of the {{ anch("State constants") }}.</dd> - <dt>{{domxref("FileReader.result")}} {{readonlyinline}}</dt> - <dd>The file's contents. This property is only valid after the read operation is complete, and the format of the data depends on which of the methods was used to initiate the read operation.</dd> -</dl> - -<h3 id="Event_handlers">Event handlers</h3> - -<dl> - <dt>{{domxref("FileReader.onabort")}}</dt> - <dd>A handler for the {{event("abort")}} event. This event is triggered each time the reading operation is aborted.</dd> - <dt>{{domxref("FileReader.onerror")}}</dt> - <dd>A handler for the {{event("error")}} event. This event is triggered each time the reading operation encounter an error.</dd> - <dt>{{domxref("FileReader.onload")}}</dt> - <dd>A handler for the {{event("load")}} event. This event is triggered each time the reading operation is successfully completed.</dd> - <dt>{{domxref("FileReader.onloadstart")}}</dt> - <dd>A handler for the {{event("loadstart")}} event. This event is triggered each time the reading is starting.</dd> - <dt>{{domxref("FileReader.onloadend")}}</dt> - <dd>A handler for the {{event("loadend")}} event. This event is triggered each time the reading operation is completed (either in success or failure).</dd> - <dt>{{domxref("FileReader.onprogress")}}</dt> - <dd>A handler for the {{event("progress")}} event. This event is triggered while reading a {{domxref("Blob")}} content.</dd> -</dl> - -<div class="note"> -<p>Note: As <code>FileReader</code> inherits from {{domxref("EventTarget")}}, all those events can also be listened for by using the {{domxref("EventTarget.addEventListener()","addEventListener")}} method.</p> -</div> - -<h3 id="State_constants" name="State_constants">State constants</h3> - -<ul> - <li><code>EMPTY </code> : <code>0</code> : No data has been loaded yet.</li> - <li><code>LOADING</code> : <code>1</code> : Data is currently being loaded.</li> - <li><code>DONE </code> : <code>2</code> : The entire read request has been completed.</li> -</ul> - -<h2 id="Methods" name="Methods">Methods</h2> - -<dl> - <dt>{{domxref("FileReader.abort()")}}</dt> - <dd>Aborts the read operation. Upon return, the <code>readyState</code> will be <code>DONE</code>.</dd> - <dt>{{domxref("FileReader.readAsArrayBuffer()")}} {{ gecko_minversion_inline("7.0") }}</dt> - <dd>Starts reading the contents of the specified {{ domxref("Blob") }}, once finished, the <code>result</code> attribute contains an {{domxref("ArrayBuffer")}} representing the file's data.</dd> - <dt>{{domxref("FileReader.readAsBinaryString()")}}</dt> - <dd>Starts reading the contents of the specified {{ domxref("Blob") }}, once finished, the <code>result</code> attribute contains the raw binary data from the file as a string.</dd> - <dt>{{domxref("FileReader.readAsDataURL()")}}</dt> - <dd>Starts reading the contents of the specified {{ domxref("Blob") }}, once finished, the <code>result</code> attribute contains a <code>data:</code> URL representing the file's data.</dd> - <dt>{{domxref("FileReader.readAsText()")}}</dt> - <dd>Starts reading the contents of the specified {{ domxref("Blob") }}, once finished, the <code>result</code> attribute contains the contents of the file as a text string.</dd> -</dl> - -<h2 id="Specifications">Specifications</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Specification</th> - <th scope="col">Status</th> - <th scope="col">Comment</th> - </tr> - <tr> - <td>{{SpecName('File API','#FileReader-interface','FileReader')}}</td> - <td>{{Spec2('File API')}}</td> - <td>Initial definition.</td> - </tr> - </tbody> -</table> - -<h2 id="Browser_compatibility" name="Browser_compatibility">Browser compatibility</h2> - -<p>{{ CompatibilityTable() }}</p> - -<div id="compat-desktop"> -<table class="compat-table"> - <tbody> - <tr> - <th>Feature</th> - <th>Firefox (Gecko)</th> - <th>Chrome</th> - <th>Internet Explorer*</th> - <th>Opera*</th> - <th>Safari</th> - </tr> - <tr> - <td>Basic support</td> - <td>{{ CompatGeckoDesktop("1.9.2") }}</td> - <td>7</td> - <td>10</td> - <td>12.02</td> - <td>6.0.2</td> - </tr> - </tbody> -</table> -</div> - -<div id="compat-mobile"> -<table class="compat-table"> - <tbody> - <tr> - <th>Feature</th> - <th>Firefox Mobile (Gecko)</th> - <th>Android</th> - <th>IE Mobile</th> - <th>Opera Mobile</th> - <th>Safari Mobile</th> - </tr> - <tr> - <td>Basic support</td> - <td>32</td> - <td>3</td> - <td>10</td> - <td>11.5</td> - <td>6.1</td> - </tr> - </tbody> -</table> -</div> - -<h3 id="Implementation_notes">Implementation notes</h3> - -<ul> - <li>IE9 has a <a href="http://html5labs.interoperabilitybridges.com/prototypes/fileapi/fileapi/info" title="http://html5labs.interoperabilitybridges.com/prototypes/fileapi/fileapi/info">File API Lab</a>.</li> - <li>Opera has <a href="http://www.opera.com/docs/specs/presto28/file/" title="http://my.opera.com/desktopteam/blog/2011/04/05/stability-gmail-socks">partial support</a> in 11.1.</li> -</ul> - -<h4 id="Gecko-specific_notes">Gecko-specific notes</h4> - -<ul> - <li>Prior to Gecko 2.0 beta 7 (Firefox 4.0 beta 7), all {{ domxref("Blob") }} parameters below were {{ domxref("File") }} parameters; this has since been updated to match the specification correctly.</li> - <li>Prior to Gecko 13.0 {{ geckoRelease("13.0") }} the <code>FileReader.error</code> property returned a {{ domxref("FileError") }} object. This interface has been removed and <code>FileReader.error</code> is now returning the {{ domxref("DOMError") }} object as defined in the latest FileAPI draft.</li> -</ul> - -<h2 id="See_also" name="See_also">See also</h2> - -<ul> - <li><a href="/en/Using_files_from_web_applications" title="en/Using files from web applications">Using files from web applications</a></li> - <li>{{ domxref("File") }}</li> - <li>{{ domxref("Blob") }}</li> - <li><a href="/en-US/docs/nsIDOMFileReader">nsIDOMFileReader</a> - For addons/privileged scope</li> -</ul> diff --git a/files/pt-pt/web/api/filereader/readasarraybuffer/index.html b/files/pt-pt/web/api/filereader/readasarraybuffer/index.html deleted file mode 100644 index d5122d8096..0000000000 --- a/files/pt-pt/web/api/filereader/readasarraybuffer/index.html +++ /dev/null @@ -1,64 +0,0 @@ ---- -title: FileReader.readAsArrayBuffer() -slug: Web/API/FileReader/readAsArrayBuffer -tags: - - API - - DOM - - Ficheiros - - File API - - FileReader - - Referencia - - metodo - - readAsArrayBuffer -translation_of: Web/API/FileReader/readAsArrayBuffer ---- -<p>{{APIRef("File API")}}</p> - -<p>O método <code>readAsArrayBuffer()</code> da interface {{domxref("FileReader")}} é utilizado para começar a ler o conteúdo de um {{domxref("Blob")}} ou {{domxref("File")}} especificado. Quando a operação de leitura termina, o valor de {{domxref("FileReader.readyState","readyState")}} passa a ser <code>DONE</code>, e é acionado o evento {{domxref("FileReader/loadend_event", "loadend")}}. Nessa altura, o atributo {{domxref("FileReader.result","result")}} contém um {{domxref("ArrayBuffer")}} representando os dados do ficheiro.</p> - -<div class="blockIndicator note"> -<p><strong>API mais recente</strong><br> - O método {{domxref("Blob.arrayBuffer()")}} é uma API recente que serve para ler um ficheiro como um <em>array buffer</em>, usando <em>Promises</em>.</p> -</div> - -<h2 id="Sintaxe">Sintaxe</h2> - -<pre class="syntaxbox notranslate"><var>instanceOfFileReader</var>.readAsArrayBuffer(<var>blob</var>);</pre> - -<h3 id="Parâmetros">Parâmetros</h3> - -<dl> - <dt><code><var>blob</var></code></dt> - <dd>O {{domxref("Blob")}} ou {{domxref("File")}} a partir do qual ler.</dd> -</dl> - -<h2 id="Especificações">Especificações</h2> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Especificação</th> - <th scope="col">Estado</th> - <th scope="col">Comentário</th> - </tr> - </thead> - <tbody> - <tr> - <td>{{SpecName("File API", "#readAsArrayBuffer", "FileReader.readAsArrayBuffer")}}</td> - <td>{{Spec2("File API")}}</td> - <td>Definição inicial</td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilidade">Compatibilidade</h2> - - - -<p>{{Compat("api.FileReader.readAsArrayBuffer")}}</p> - -<h2 id="Ver_também">Ver também</h2> - -<ul> - <li>{{domxref("FileReader")}}</li> -</ul> diff --git a/files/pt-pt/web/api/filereader/readasbinarystring/index.html b/files/pt-pt/web/api/filereader/readasbinarystring/index.html deleted file mode 100644 index 44911105e6..0000000000 --- a/files/pt-pt/web/api/filereader/readasbinarystring/index.html +++ /dev/null @@ -1,85 +0,0 @@ ---- -title: FileReader.readAsBinaryString() -slug: Web/API/FileReader/readAsBinaryString -tags: - - API - - Ficheiros - - File API - - Referencia - - metodo -translation_of: Web/API/FileReader/readAsBinaryString ---- -<p>{{APIRef("File API")}}</p> - -<p>O método <code>readAsBinaryString</code> é usado para iniciar a leitura dos conteúdos do {{domxref("Blob")}} ou {{domxref("File")}} indicado. Quando a operação da leitura é terminada, o {{domxref("FileReader.readyState","readyState")}} retorna <code>DONE</code>, e o {{event("loadend")}} é acionado. A propriedade {{domxref("FileReader.result","result")}} depois contem o binário bruto do ficheiro.</p> - -<p>Note que este método foi removido do File API, mas foi reintroduzido por motivos de compatibilidade com versões antigas.<br> - É recomendado usar {{domxref("FileReader.readAsArrayBuffer()")}}.</p> - -<h2 id="Sintaxe">Sintaxe</h2> - -<pre class="notranslate"><em>instanceOfFileReader</em>.readAsBinaryString(blob);</pre> - -<h3 id="Parâmetros">Parâmetros</h3> - -<dl> - <dt><code>blob</code></dt> - <dd>O {{domxref("Blob")}} ou {{domxref("File")}} a ser lido.</dd> -</dl> - -<h2 id="Exemplo">Exemplo</h2> - -<pre class="brush: js notranslate">var canvas = document.createElement('canvas'); -var height = 200; -var width = 200; - -canvas.width = width; -canvas.height = height; - -var ctx = canvas.getContext('2d'); - -ctx.strokeStyle = '#090'; -ctx.beginPath(); -ctx.arc(width/2, height/2, width/2 - width/10, 0, Math.PI*2); -ctx.stroke(); - -canvas.toBlob(function (blob) { - var reader = new FileReader(); - - reader.onloadend = function () { - console.log(reader.result); - } - - reader.readAsBinaryString(blob); -});</pre> - -<h2 id="Browser_Compatibility" name="Browser_Compatibility">Especificações</h2> - -<table class="spectable standard-table"> - <thead> - <tr> - <th scope="col">Especificação</th> - <th scope="col">Estado</th> - <th scope="col">Comentários</th> - </tr> - </thead> - <tbody> - <tr> - <td>{{SpecName('File API','#readAsBinaryString','readAsBinaryString')}}</td> - <td>{{Spec2('File API')}}</td> - <td></td> - </tr> - </tbody> -</table> - -<h2 id="Browser_compatibility" name="Browser_compatibility">Compatibilidade</h2> - - - -<p>{{Compat("api.FileReader.readAsBinaryString")}}</p> - -<h2 id="Ver_também">Ver também</h2> - -<ul> - <li>{{domxref("FileReader")}}</li> -</ul> diff --git a/files/pt-pt/web/api/filereader/readasdataurl/index.html b/files/pt-pt/web/api/filereader/readasdataurl/index.html deleted file mode 100644 index 321d50d3ce..0000000000 --- a/files/pt-pt/web/api/filereader/readasdataurl/index.html +++ /dev/null @@ -1,133 +0,0 @@ ---- -title: FileReader.readAsDataURL() -slug: Web/API/FileReader/readAsDataURL -tags: - - API - - Base 64 - - Ficheiros - - File API - - FileReader - - Referencia - - metodo -translation_of: Web/API/FileReader/readAsDataURL ---- -<p>O método <code>readAsDataURL</code> é utilizado para ler os conteúdos dum {{domxref("Blob")}} ou {{domxref("File")}} especificado. Quando a operação de leitura é terminada, a propriedade {{domxref("FileReader.readyState","readyState")}} é atualizada para <code>DONE</code>, e o evento {{event("loadend")}} é lançado. Nessa altura, o atributo {{domxref("FileReader.result","result")}} contem os dados na forma <a href="/en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URIs">data: URL</a> que representa os dados do ficheiro em base 64 numa <em>string</em>.</p> - -<div class="note"> -<p><strong>Nota:</strong> O{{domxref("FileReader.result","result")}} da Blob não pode ser diretamente descodificado como Base64 sem remover a declaração Data-URL que precede os dados em Base64. Para ter só a <em>string</em> em Base64, primeiro tem de remover o <code>data:*/*;base64,</code> do resultado.</p> -</div> - -<h2 id="Sintaxe">Sintaxe</h2> - -<pre class="syntaxbox notranslate"><em>instanceOfFileReader</em>.readAsDataURL(blob);</pre> - -<h3 id="Parametros">Parametros</h3> - -<dl> - <dt><code>blob</code></dt> - <dd>O {{domxref("Blob")}} ou {{domxref("File")}} para ler.</dd> -</dl> - -<h2 id="Exemplo">Exemplo</h2> - -<h3 id="HTML">HTML</h3> - -<pre class="brush: html notranslate"><input type="file" onchange="previewFile()"><br> -<img src="" height="200" alt="Image preview..."></pre> - -<h3 id="JavaScript">JavaScript</h3> - -<pre class="brush: js notranslate">function previewFile() { - const preview = document.querySelector('img'); - const file = document.querySelector('input[type=file]').files[0]; - const reader = new FileReader(); - - reader.addEventListener("load", function () { - // converter o file de imagem oara uma string de base 64 - preview.src = reader.result; - }, false); - - if (file) { - reader.readAsDataURL(file); - } -}</pre> - -<h3 id="Resultado">Resultado</h3> - -<p>{{EmbedLiveSample("Exemplo", "100%", 240)}}</p> - -<h2 id="Exemplo_de_vários_files">Exemplo de vários files</h2> - -<h3 id="HTML_2">HTML</h3> - -<pre class="brush: html notranslate"><input id="browse" type="file" onchange="previewFiles()" multiple> -<div id="preview"></div></pre> - -<h3 id="JavaScript_2">JavaScript</h3> - -<pre class="brush: js notranslate">function previewFiles() { - - var preview = document.querySelector('#preview'); - var files = document.querySelector('input[type=file]').files; - - function readAndPreview(file) { - - // Make sure `file.name` matches our extensions criteria - if ( /\.(jpe?g|png|gif)$/i.test(file.name) ) { - var reader = new FileReader(); - - reader.addEventListener("load", function () { - var image = new Image(); - image.height = 100; - image.title = file.name; - image.src = this.result; - preview.appendChild( image ); - }, false); - - reader.readAsDataURL(file); - } - - } - - if (files) { - [].forEach.call(files, readAndPreview); - } - -} -</pre> - -<div class="note"><strong>Nota:</strong> O construtor <a href="/en-US/docs/Web/API/FileReader"><code>FileReader()</code></a> não é apoiado pela Internet Explorer anterior à versão 10. Para obter código totalmente compatível veja a nossa <a class="internal" href="https://mdn.mozillademos.org/files/3699/crossbrowser_image_preview.html" title="crossbrowser_image_preview.html">solução <em>crossbrowser</em> para pré-visualizar imagens</a>. Veja também <a href="https://mdn.mozillademos.org/files/3698/image_upload_preview.html">este exemplo mais complexo</a>.</div> - -<h2 id="Especificações">Especificações</h2> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Especificação</th> - <th scope="col">Estado</th> - <th scope="col">Comentário</th> - </tr> - </thead> - <tbody> - <tr> - <td>{{SpecName("File API", "#readAsDataURL", "readAsDataURL()")}}</td> - <td>{{Spec2("File API")}}</td> - <td>Definição inicial</td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilidade">Compatibilidade</h2> - - - -<p>{{Compat("api.FileReader.readAsDataURL")}}</p> - -<h2 id="Ver_também">Ver também</h2> - -<ul> - <li>{{domxref("FileReader")}}</li> - <li>{{domxref("URL.createObjectURL()")}}</li> -</ul> - -<div>{{APIRef("File API")}}</div> diff --git a/files/pt-pt/web/api/filereader/readastext/index.html b/files/pt-pt/web/api/filereader/readastext/index.html deleted file mode 100644 index d8f821e7ab..0000000000 --- a/files/pt-pt/web/api/filereader/readastext/index.html +++ /dev/null @@ -1,63 +0,0 @@ ---- -title: FileReader.readAsText() -slug: Web/API/FileReader/readAsText -tags: - - API - - Ficheiros - - File API - - Referencia - - metodo -translation_of: Web/API/FileReader/readAsText ---- -<div>{{APIRef("File API")}}</div> - -<p>O método <strong><code>readAsText()</code></strong> é utilizado para ler os conteúdos do {{domxref("Blob")}} ou {{domxref("File")}} indicado. Quando a operação de leitura é terminada, a propriedade {{domxref("FileReader.readyState","readyState")}} é modificada para <code>DONE</code>, o evento {{event("loadend")}} é lançado, e a propriedade {{domxref("FileReader.result","result")}} fica com os conteúdos do ficheiro em forma de <em>string</em>.</p> - -<div class="blockIndicator note"> -<p><strong>API mais recente disponível</strong><br> - {{domxref("Blob.text()")}} é um método mais recente, baseado na API de promessas, para ler um ficheiro como uma <em>string</em>.</p> -</div> - -<h2 id="Sintaxe">Sintaxe</h2> - -<pre class="syntaxbox notranslate"><em>instanceOfFileReader</em>.readAsText(blob[, encoding]);</pre> - -<h3 id="Parâmetros">Parâmetros</h3> - -<dl> - <dt><code>blob</code></dt> - <dd>O {{domxref("Blob")}} ou {{domxref("File")}} de qual ler.</dd> - <dt><code>encoding</code> {{optional_inline}}</dt> - <dd>Uma <em>string</em> a especificar qual codificação usar para os dados devolvidos. A UTF-8 é utilizada se não for definido.</dd> -</dl> - -<h2 id="Especificações">Especificações</h2> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Especificação</th> - <th scope="col">Estado</th> - <th scope="col">Comentários</th> - </tr> - </thead> - <tbody> - <tr> - <td>{{SpecName("File API", "#readAsDataText", "readAsText()")}}</td> - <td>{{Spec2("File API")}}</td> - <td>Definição inicial</td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilidade">Compatibilidade</h2> - - - -<p>{{Compat("api.FileReader.readAsText")}}</p> - -<h2 id="Ver_também">Ver também</h2> - -<ul> - <li>{{domxref("FileReader")}}</li> -</ul> diff --git a/files/pt-pt/web/api/filereader/readystate/index.html b/files/pt-pt/web/api/filereader/readystate/index.html deleted file mode 100644 index 1147e43f29..0000000000 --- a/files/pt-pt/web/api/filereader/readystate/index.html +++ /dev/null @@ -1,96 +0,0 @@ ---- -title: FileReader.readyState -slug: Web/API/FileReader/readyState -tags: - - API - - Ficheiros - - File API - - Propriedade - - Referencia -translation_of: Web/API/FileReader/readyState ---- -<div>{{APIRef("File API")}}</div> - -<p>A propriedade <strong><code>readyState</code></strong> de {{domxref("FileReader")}} fornece o estado actual da operação de leitura em que se encontra um <code>FileReader</code>. Um <code>FileReader</code> existe num dos seguintes estados:</p> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Valor</th> - <th scope="col">Estado</th> - <th scope="col">Descrição</th> - </tr> - <tr> - <td><code>0</code></td> - <td><code>EMPTY</code></td> - <td>Foi criado um leitor. Nenhum dos métodos de leitura foi ainda chamado.</td> - </tr> - <tr> - <td><code>1</code></td> - <td><code>LOADING</code></td> - <td>Foi chamado um método de leitura.</td> - </tr> - <tr> - <td><code>2</code></td> - <td><code>DONE</code></td> - <td>A operação está concluída.</td> - </tr> - </thead> -</table> - -<dl> - <dt><code>EMPTY</code></dt> - <dd>O <code>FileReader</code> foi criado, mas ainda não foi chamado o método <code>readAs</code>.</dd> - <dt><code>LOADING</code></dt> - <dd>Foi invocado o método <code>readAs</code>. O {{domxref("File")}} ou {{domxref("Blob")}} está a ser lido, e ainda não ocorreu qualquer erro.</dd> - <dt><code>DONE</code></dt> - <dd>A operação lida está concluída. Isto pode significar que: todo o {{domxref("File")}} ou {{domxref("Blob")}} foi lido na memória, ocorreu um erro de leitura de ficheiro, ou {{domxref("FileReader.abort()", "abort()")}} foi chamado e a leitura foi cancelada.</dd> -</dl> - -<h2 id="Exemplo">Exemplo</h2> - -<pre class="brush: js notranslate">var reader = new FileReader(); -console.log('EMPTY', reader.readyState); // readyState é 0 - -reader.readAsText(blob); -console.log('LOADING', reader.readyState); // readyState é 1 - -reader.onloadend = function () { - console.log('DONE', reader.readyState); // readyState é 2 -}; -</pre> - -<h2 id="Valor">Valor</h2> - -<p>Um número que é uma das três constantes de estado possíveis definidas para o {{domxref("FileReader")}} API.</p> - -<h2 id="Especificação">Especificação</h2> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Especificação</th> - <th scope="col">Estado</th> - <th scope="col">Comentários</th> - </tr> - </thead> - <tbody> - <tr> - <td>{{SpecName("File API", "#dom-filereader-readystate", "readyState")}}</td> - <td>{{Spec2("File API")}}</td> - <td>Definição inicial</td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilidade">Compatibilidade</h2> - - - -<p>{{Compat("api.FileReader.readyState")}}</p> - -<h2 id="Ver_também">Ver também</h2> - -<ul> - <li>{{domxref("Blob")}}</li> -</ul> diff --git a/files/pt-pt/web/api/filereader/result/index.html b/files/pt-pt/web/api/filereader/result/index.html deleted file mode 100644 index ea7ddd4bbd..0000000000 --- a/files/pt-pt/web/api/filereader/result/index.html +++ /dev/null @@ -1,105 +0,0 @@ ---- -title: FileReader.result -slug: Web/API/FileReader/result -tags: - - API - - Ficheiros - - File API - - FileReader - - Propriedade - - Referencia - - result -translation_of: Web/API/FileReader/result ---- -<div>{{APIRef("File API")}}</div> - -<p>A propriedade <code><strong>result</strong></code> de {{domxref("FileReader")}} devolve os conteúdo do ficheiro. Esta propriedade só é válida após a operação de leitura estar concluída, e o formato dos dados depende de qual método foi utilizado para iniciar a operação de leitura.</p> - -<h2 id="Sintaxe">Sintaxe</h2> - -<pre class="syntaxbox notranslate">var <var>file</var> = <var>instanceOfFileReader</var>.result -</pre> - -<h3 id="Valor">Valor</h3> - -<p>Uma <em>string</em> ou {{jsxref("ArrayBuffer")}} apropriado com base em qual dos métodos de leitura foi utilizado para iniciar a operação de leitura. O valor é <code>null</code> se a leitura ainda não estiver completa ou não foi bem sucedida.</p> - -<p>Os resultados são descritos abaixo.</p> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Método</th> - <th scope="col">Descrição</th> - </tr> - </thead> - <tbody> - <tr> - <td>{{domxref("FileReader/readAsArrayBuffer", "readAsArrayBuffer()")}}</td> - <td>O <code>result</code> é um {{jsxref("Global_Objects/ArrayBuffer", "ArrayBuffer")}} de JavaScript que contem dados binários.</td> - </tr> - <tr> - <td>{{domxref("FileReader/readAsBinaryString", "readAsBinaryString()")}}</td> - <td>O <code>result</code> contém os dados binários brutos do ficheiro numa <em>string</em>.</td> - </tr> - <tr> - <td>{{domxref("FileReader/readAsDataURL", "readAsDataURL()")}}</td> - <td>O <code>result</code> é uma string com uma <code>data:</code> URL que representa os dados do ficheiro.</td> - </tr> - <tr> - <td>{{domxref("FileReader/readAsText", "readAsText()")}}</td> - <td>O <code>result</code> ié texto numa <em>string</em>.</td> - </tr> - </tbody> -</table> - -<h2 id="Exemplo">Exemplo</h2> - -<p>Este exemplo apresenta uma função, <code>read()</code>, que lê um ficheiro a partir de uma <a href="/en-US/docs/Web/HTML/Element/input/file">entrada de ficheiro</a>. Funciona criando um objecto {{domxref("FileReader")}} e criando um ouvinte para eventos {{domxref("FileReader/load_event", "load")}}, de modo que quando o ficheiro é lido, o <code>result</code> é obtido e passado para a função callback fornecida para <code>read()</code>.</p> - -<p>O conteúdo é tratado como dados de texto brutos.</p> - -<pre class="brush: js notranslate">var fileInput = document.querySelector('input[type="file"]'); - -function read(callback) { - var file = fileInput.files.item(0); - var reader = new FileReader(); - - reader.onload = function() { - callback(reader.result); - } - - reader.readAsText(file); -} -</pre> - -<h2 id="Especificações">Especificações</h2> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Especificação</th> - <th scope="col">Estado</th> - <th scope="col">Comentário</th> - </tr> - </thead> - <tbody> - <tr> - <td>{{SpecName("File API", "#dom-filereader-result", "result")}}</td> - <td>{{Spec2("File API")}}</td> - <td>Definição inicial</td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilidade">Compatibilidade</h2> - - - -<p>{{Compat("api.FileReader.result")}}</p> - -<h2 id="Ver_também">Ver também</h2> - -<ul> - <li>{{domxref("FileReader")}}</li> -</ul> |