pt-br: Format /web/api using Prettier (part 3)

mdn · Jul 28, 2023 · 162cc93 · 162cc93
1 parent 6cb0f57
commit 162cc93
Show file tree

Hide file tree

Showing 100 changed files with 1,876 additions and 1,792 deletions.
diff --git a/files/pt-br/web/api/history_api/example/index.md b/files/pt-br/web/api/history_api/example/index.md
diff --git a/files/pt-br/web/api/history_api/index.md b/files/pt-br/web/api/history_api/index.md
@@ -143,11 +143,8 @@ Para um exemplo completo de um web site AJAX, veja: [Exemplo de navegação Ajax
 
 ## Especificações
 
-| Especificação                                                                        | Status                           | Comentário                                             |
-| ------------------------------------------------------------------------------------ | -------------------------------- | ------------------------------------------------------ |
-| {{SpecName('HTML WHATWG', "browsers.html#history", "History")}} | {{Spec2('HTML WHATWG')}} | Nenhuma alteração do {{SpecName("HTML5 W3C")}}. |
-| {{SpecName('HTML5 W3C', "browsers.html#history", "History")}}     | {{Spec2('HTML5 W3C')}}     | Definição inicial                                      |
+{{Specifications}}
 
 ## Compatibilidade com navegadores
 
-{{Compat("api.History")}}
+{{Compat}}
diff --git a/files/pt-br/web/api/html_drag_and_drop_api/file_drag_and_drop/index.md b/files/pt-br/web/api/html_drag_and_drop_api/file_drag_and_drop/index.md
@@ -25,7 +25,10 @@ O elemento de destino do evento {{event("drop")}} precisa de um event handler gl
 Normalmente, um aplicativo inclui um event handler {{event("dragover")}} no elemento de destino do drop e esse manipulador desativará o comportamento de arraste padrão do navegador. Para adicionar esse handler, você precisa incluir um event handler global {{domxref("GlobalEventHandlers.ondragover","ondragover")}}:
 
 ```html
-<div id="drop_zone" ondrop="dropHandler(event);" ondragover="dragOverHandler(event);">
+<div
+  id="drop_zone"
+  ondrop="dropHandler(event);"
+  ondragover="dragOverHandler(event);">
   <p>Drag one or more files to this Drop Zone ...</p>
 </div>
 ```
@@ -35,7 +38,7 @@ Por fim, um aplicativo pode querer estilizar o elemento da drop zone para indica
 ```css
 #drop_zone {
   border: 5px solid blue;
-  width:  200px;
+  width: 200px;
   height: 100px;
 }
 ```
@@ -52,7 +55,7 @@ Observe que neste exemplo, Qualquer item de arrasto que não seja um arquivo é
 
 ```js
 function dropHandler(ev) {
-  console.log('File(s) dropped');
+  console.log("File(s) dropped");
 
   // Impedir o comportamento padrão (impedir que o arquivo seja aberto)
   ev.preventDefault();
@@ -61,15 +64,17 @@ function dropHandler(ev) {
     // Use a interface DataTransferItemList para acessar o (s) arquivo (s)
     for (var i = 0; i < ev.dataTransfer.items.length; i++) {
       // Se os itens soltos não forem arquivos, rejeite-os
-      if (ev.dataTransfer.items[i].kind === 'file') {
+      if (ev.dataTransfer.items[i].kind === "file") {
         var file = ev.dataTransfer.items[i].getAsFile();
-        console.log('... file[' + i + '].name = ' + file.name);
+        console.log("... file[" + i + "].name = " + file.name);
       }
     }
   } else {
     // Use a interface DataTransfer para acessar o (s) arquivo (s)
     for (var i = 0; i < ev.dataTransfer.files.length; i++) {
-      console.log('... file[' + i + '].name = ' + ev.dataTransfer.files[i].name);
+      console.log(
+        "... file[" + i + "].name = " + ev.dataTransfer.files[i].name,
+      );
     }
   }
 }
@@ -81,7 +86,7 @@ O seguinte event handler {{event("dragover")}} chama {{domxref("Event.preventDef
 
 ```js
 function dragOverHandler(ev) {
-  console.log('File(s) in drop zone');
+  console.log("File(s) in drop zone");
 
   // Impedir o comportamento padrão (impedir que o arquivo seja aberto)
   ev.preventDefault();

diff --git a/files/pt-br/web/api/html_drag_and_drop_api/index.md b/files/pt-br/web/api/html_drag_and_drop_api/index.md
@@ -20,16 +20,16 @@ O drag and drop em HTML usa o {{domxref("Event","modelo de eventos DOM")}} e os
 
 Todos os [tipos de evento drag](/pt-BR/docs/Web/API/DragEvent#Event_types) são associados a um [manipulador global de eventos](/pt-BR/docs/Web/API/DragEvent#GlobalEventHandlers). Cada tipo de evento drag e cada atributo drag global tem um documento de referência que o descreve. A tabela a seguir descreve brevemente os tipos de evento e um link de referência para seu documento.
 
-| Event                        | On Event Handler                                                                 | Description                                                                                                                                                                                                                        |
-| ---------------------------- | -------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| {{event('drag')}}     | {{domxref('GlobalEventHandlers.ondrag','ondrag')}}             | Acionado quando um elemento ou seleção de texto está sendo arrastado.                                                                                                                                                              |
-| {{event('dragend')}} | {{domxref('GlobalEventHandlers.ondragend','ondragend')}}     | Acionado quando uma operação de arrastar está terminando (por eexmplo, ao soltar o botão do mouse ou pressionar a tecla esc). (Veja [Terminando um evento Drag](/pt-BR/docs/DragDrop/Drag_Operations#dragend).) |
-| {{event('dragenter')}} | {{domxref('GlobalEventHandlers.ondragenter','ondragenter')}} | Acionado quando um elemento arrastável ou seleção de texto entra em um ponto de soltura (drop target). (Veja [Determinando Drop Targets](/pt-BR/docs/DragDrop/Drag_Operations#droptargets).)             |
-| {{event('dragexit')}} | {{domxref('GlobalEventHandlers.ondragexit','ondragexit')}}     | Acionado quando um elemento não é mais o ponto de seleção imediata da operação drag.                                                                                                                                               |
-| {{event('dragleave')}} | {{domxref('GlobalEventHandlers.ondragleave','ondragleave')}} | Acionado quando um elemento arrastável ou seleção de texto abandona um ponto de soltura (drop target) válido.                                                                                                                      |
-| {{event('dragover')}} | {{domxref('GlobalEventHandlers.ondragover','ondragover')}}     | Acionado quando um elemento ou seleção de texto está sendo arrastado sobre um ponto de soltura válido (a cada aproximadamente 100 milisegundos).                                                                                   |
-| {{event('dragstart')}} | {{domxref('GlobalEventHandlers.ondragstart','ondragstart')}} | Acionado quando o usuário começa a arrastar um elemento válido ou seleção de texto. (Veja [Começando uma Operação Drag](/pt-BR/docs/DragDrop/Drag_Operations#dragstart).)                              |
-| {{event('drop')}}     | {{domxref('GlobalEventHandlers.ondrop','ondrop')}}             | Acionado quando um elemento ou seleção de texto é solta em um ponto d soltura (drop target) válido. (Veja [Realizando um Drop](/pt-BR/docs/DragDrop/Drag_Operations#drop).)                                    |
+| Event                  | On Event Handler                                             | Description                                                                                                                                                                                                     |
+| ---------------------- | ------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| {{event('drag')}}      | {{domxref('GlobalEventHandlers.ondrag','ondrag')}}           | Acionado quando um elemento ou seleção de texto está sendo arrastado.                                                                                                                                           |
+| {{event('dragend')}}   | {{domxref('GlobalEventHandlers.ondragend','ondragend')}}     | Acionado quando uma operação de arrastar está terminando (por eexmplo, ao soltar o botão do mouse ou pressionar a tecla esc). (Veja [Terminando um evento Drag](/pt-BR/docs/DragDrop/Drag_Operations#dragend).) |
+| {{event('dragenter')}} | {{domxref('GlobalEventHandlers.ondragenter','ondragenter')}} | Acionado quando um elemento arrastável ou seleção de texto entra em um ponto de soltura (drop target). (Veja [Determinando Drop Targets](/pt-BR/docs/DragDrop/Drag_Operations#droptargets).)                    |
+| {{event('dragexit')}}  | {{domxref('GlobalEventHandlers.ondragexit','ondragexit')}}   | Acionado quando um elemento não é mais o ponto de seleção imediata da operação drag.                                                                                                                            |
+| {{event('dragleave')}} | {{domxref('GlobalEventHandlers.ondragleave','ondragleave')}} | Acionado quando um elemento arrastável ou seleção de texto abandona um ponto de soltura (drop target) válido.                                                                                                   |
+| {{event('dragover')}}  | {{domxref('GlobalEventHandlers.ondragover','ondragover')}}   | Acionado quando um elemento ou seleção de texto está sendo arrastado sobre um ponto de soltura válido (a cada aproximadamente 100 milisegundos).                                                                |
+| {{event('dragstart')}} | {{domxref('GlobalEventHandlers.ondragstart','ondragstart')}} | Acionado quando o usuário começa a arrastar um elemento válido ou seleção de texto. (Veja [Começando uma Operação Drag](/pt-BR/docs/DragDrop/Drag_Operations#dragstart).)                                       |
+| {{event('drop')}}      | {{domxref('GlobalEventHandlers.ondrop','ondrop')}}           | Acionado quando um elemento ou seleção de texto é solta em um ponto d soltura (drop target) válido. (Veja [Realizando um Drop](/pt-BR/docs/DragDrop/Drag_Operations#drop).)                                     |
 
 Note que eventos `dragstart` e `dragend` não são acionados ao arrastar um arquivo vindo do sistema operacional para o navegador.
 
@@ -59,13 +59,15 @@ Esta seção dispõe de um resumo das etapas básicas para adicionar a funcional
 
 Para fazer um elemento se tornar arrastável, é necessária a adição de um atributo [`draggable`](/pt-BR/docs/Web/HTML/Global_attributes#draggable) além da adição do manipulador de eventos global {{domxref("GlobalEventHandlers.ondragstart","ondragstart")}}, conforme descrito no exemplo a seguir
 
-```
+```js
 function dragstart_handler(ev) {
  console.log("dragStart");
  // Adiciona o id do elemento em questão ao objeto de transferência de dados (dataTransfer)
  ev.dataTransfer.setData("text/plain", ev.target.id);
 }
+```
 
+```html
 <body>
  <p id="p1" draggable="true" ondragstart="dragstart_handler(event);">Este elemento é arrastável.</p>
 </body>
@@ -79,7 +81,7 @@ A aplicação é livre para incluir qualquer quantidade de dados do item em uma
 
 Cada {{domxref("DragEvent","evento drag")}} tem uma propriedade {{domxref("DragEvent.dataTransfer","dataTransfer")}} que _segura_ os dados do evento. Essa propridade (que é um objeto {{domxref("DataTransfer")}}) também tem um método para _gerenciar_ os dados do arraste (drag). O método {{domxref("DataTransfer.setData","setData()")}} é usado para adicionar um item aos dados do arraste, como demonstrado no exemplo a seguir.
 
-```
+```js
 function dragstart_handler(ev) {
   // Adiciona os dados do arraste (drag)
   ev.dataTransfer.setData("text/plain", ev.target.id);
@@ -94,7 +96,7 @@ Para uma lista de tipos de dados mais comuns utilizados pelo drag and drop (como
 
 Por padrão, o navegador provê uma imagem que aparece por trás do ponteiro do mouse durante uma operação de arraste. Entretanto, uma aplicação pode definir uma imagem customizada utilizando o método {{domxref("DataTransfer.setDragImage","setDragImage()")}} como demonstrado no exemplo a seguir.
 
-```
+```js
 function dragstart_handler(ev) {
   // Cria uma imagem e então a utiliza como a "drag image".
   // NOTA: mude "example.gif" como uma imagem existente, caso contrário
@@ -123,7 +125,7 @@ Durante a operação de arraste, os efeitos do arraste (drag) podem ser modifica
 
 O exemplo a seguir mostra como utilizar essa propriedade.
 
-```
+```js
 function dragstart_handler(ev) {
   // Determina o efeito de arraste para copy
   ev.dataTransfer.dropEffect = "copy";
@@ -136,7 +138,7 @@ Veja [Efeitos do Arraste (Drag Effects)](/pt-BR/docs/Web/Guide/HTML/Drag_operati
 
 Por padrão, o navegador previne tudo que possa acontecer ao soltar alguma coisa em um elemento HTML. Para mudar esse comportamento de forma que um elemento se torne uma zona de soltura (d*rop zone)* ou que seja soltável _(droppable)_, o elemento precisa ter ambos os atributos {{domxref("GlobalEventHandlers.ondragover","ondragover")}} e {{domxref("GlobalEventHandlers.ondrop","ondrop")}}. O exemplo a seguir mostra como utilizar esses atributos e inclui manipuladores básicos de evento para cada um.
 
-```
+```js
 function dragover_handler(ev) {
  ev.preventDefault();
  // Define o dropEffect para ser do tipo move
@@ -163,7 +165,7 @@ O manipulador do evento {{event("drop")}} é livre para processar os dados do ar
 
 O exemplo a seguir mostra o manipulador de soltura (drop handler) pegando o id do elemento de origem atráves dos dados de drag (drag data) e então usando o id para mover o elemento de sua origem para o elemento de soltura (drop element).
 
-```
+```js
 function dragstart_handler(ev) {
  // Adiciona o id do elemento alvo para o objeto de transferência de dados
  ev.dataTransfer.setData("text/plain", ev.target.id);

diff --git a/files/pt-br/web/api/htmlcanvaselement/getcontext/index.md b/files/pt-br/web/api/htmlcanvaselement/getcontext/index.md
@@ -31,9 +31,7 @@ canvas.getContext(contextType, contextAttributes);
   - : Você pode usar alguns atributos de contexto quando criar o seu contexto de renderização, por exemplo:
 
     ```js
-    canvas.getContext('webgl',
-                     { antialias: false,
-                       depth: false });
+    canvas.getContext("webgl", { antialias: false, depth: false });
     ```
 
     Atributos de contexto 2d:
@@ -74,24 +72,20 @@ Dado este elemento {{HTMLElement("canvas")}}:
 Você pega um contexto `2d` do canvas com o código a seguir:
 
 ```js
-var canvas = document.getElementById('canvas');
-var ctx = canvas.getContext('2d');
+var canvas = document.getElementById("canvas");
+var ctx = canvas.getContext("2d");
 console.log(ctx); // CanvasRenderingContext2D { ... }
 ```
 
 Agora você tem [contexto de renderização 2d](/pt-BR/docs/Web/API/CanvasRenderingContext2D) para o canvas e você pode desenhar nele.
 
-## Specifications
+## Especificações
 
-| Specification                                                                                                                        | Status                           | Comment                                                                        |
-| ------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------- | ------------------------------------------------------------------------------ |
-| {{SpecName('HTML WHATWG', "scripting.html#dom-canvas-getcontext", "HTMLCanvasElement.getContext")}} | {{Spec2('HTML WHATWG')}} | Nenhuma mudança desde o ultimo snapshot, {{SpecName('HTML5 W3C')}}      |
-| {{SpecName('HTML5.1', "scripting-1.html#dom-canvas-getcontext", "HTMLCanvasElement.getContext")}}     | {{Spec2('HTML5.1')}}     |                                                                                |
-| {{SpecName('HTML5 W3C', "scripting-1.html#dom-canvas-getcontext", "HTMLCanvasElement.getContext")}} | {{Spec2('HTML5 W3C')}}     | Snapshot do {{SpecName('HTML WHATWG')}} contendo a definição inicial. |
+{{Specifications}}
 
 ## Compatibilidade com navegadores
 
-{{Compat("api.HTMLCanvasElement.getContext")}}
+{{Compat}}
 
 ## See also
 

diff --git a/files/pt-br/web/api/htmlcanvaselement/height/index.md b/files/pt-br/web/api/htmlcanvaselement/height/index.md
@@ -27,21 +27,17 @@ Dado este elemento {{HTMLElement("canvas")}}:
 Você pode capturar a altura do canvas com o seguinte código:
 
 ```js
-var canvas = document.getElementById('canvas');
+var canvas = document.getElementById("canvas");
 console.log(canvas.height); // 300
 ```
 
 ## Especificações
 
-| Specification                                                                                                                | Status                           | Comment                                                                                 |
-| ---------------------------------------------------------------------------------------------------------------------------- | -------------------------------- | --------------------------------------------------------------------------------------- |
-| {{SpecName('HTML WHATWG', "scripting.html#attr-canvas-height", "HTMLCanvasElement.height")}} | {{Spec2('HTML WHATWG')}} | No change since the latest snapshot, {{SpecName('HTML5 W3C')}}                   |
-| {{SpecName('HTML5.1', "scripting-1.html#attr-canvas-height", "HTMLCanvasElement.height")}}     | {{Spec2('HTML5.1')}}     |                                                                                         |
-| {{SpecName('HTML5 W3C', "scripting-1.html#attr-canvas-height", "HTMLCanvasElement.height")}} | {{Spec2('HTML5 W3C')}}     | Snapshot of the {{SpecName('HTML WHATWG')}} containing the initial definition. |
+{{Specifications}}
 
 ## Compatibilidade com navegadores
 
-{{Compat("api.HTMLCanvasElement.height")}}
+{{Compat}}
 
 ## Veja também