From 2059b8bb5f10ab07eafc64e167af3a4d75c64f68 Mon Sep 17 00:00:00 2001 From: "Queen Vinyl Da.i'gyu-Kazotetsu" Date: Sun, 28 Jul 2024 14:00:16 -0700 Subject: [PATCH] pt-br: Convert noteblocks to GFM Alerts (part 3) This PR converts the noteblocks for the Portugese Brazilian locale to GFM Alerts syntax, using a [conversion script](https://github.com/queengooborg/mdn-toolkit/blob/main/upgrade-noteblock.js). This is part 3. Note: manual adjustments have also been made to correct some issues, including capitalization, syntax, duplicated keywords and more. --- .../element/getelementsbyclassname/index.md | 3 ++- files/pt-br/web/api/element/id/index.md | 3 ++- .../api/element/insertadjacenthtml/index.md | 3 ++- files/pt-br/web/api/element/matches/index.md | 3 ++- .../web/api/element/scroll_event/index.md | 3 ++- .../web/api/element/scrollwidth/index.md | 3 ++- .../web/api/event/defaultprevented/index.md | 3 ++- .../web/api/event/preventdefault/index.md | 3 ++- .../web/api/eventsource/error_event/index.md | 3 ++- .../web/api/eventsource/eventsource/index.md | 3 ++- files/pt-br/web/api/eventsource/index.md | 3 ++- .../api/eventtarget/addeventlistener/index.md | 3 ++- files/pt-br/web/api/fetch/index.md | 6 +++-- files/pt-br/web/api/fetch_api/index.md | 3 ++- .../web/api/fetch_api/using_fetch/index.md | 15 +++++++---- files/pt-br/web/api/filelist/index.md | 3 ++- .../web/api/filereader/readasdataurl/index.md | 3 ++- files/pt-br/web/api/formdata/append/index.md | 6 +++-- files/pt-br/web/api/formdata/delete/index.md | 3 ++- files/pt-br/web/api/formdata/entries/index.md | 3 ++- .../pt-br/web/api/formdata/formdata/index.md | 6 +++-- files/pt-br/web/api/formdata/get/index.md | 3 ++- files/pt-br/web/api/formdata/getall/index.md | 3 ++- files/pt-br/web/api/formdata/has/index.md | 3 ++- files/pt-br/web/api/formdata/index.md | 6 +++-- files/pt-br/web/api/formdata/set/index.md | 6 +++-- files/pt-br/web/api/geolocation/index.md | 3 ++- .../working_with_the_history_api/index.md | 6 +++-- .../file_drag_and_drop/index.md | 6 +++-- .../api/htmlcanvaselement/getcontext/index.md | 3 ++- files/pt-br/web/api/htmlcollection/index.md | 3 ++- .../web/api/htmlelement/accesskey/index.md | 3 ++- .../web/api/htmlelement/offsetheight/index.md | 3 ++- .../web/api/htmlelement/offsetwidth/index.md | 3 ++- .../api/htmlformelement/submit_event/index.md | 3 ++- files/pt-br/web/api/idbcursor/index.md | 3 ++- files/pt-br/web/api/indexeddb_api/index.md | 6 +++-- .../indexeddb_api/using_indexeddb/index.md | 12 ++++++--- files/pt-br/web/api/mutationobserver/index.md | 6 +++-- .../web/api/navigator/geolocation/index.md | 3 ++- files/pt-br/web/api/node/clonenode/index.md | 3 ++- files/pt-br/web/api/node/firstchild/index.md | 3 ++- files/pt-br/web/api/node/index.md | 6 +++-- files/pt-br/web/api/nodelist/index.md | 3 ++- .../web/api/offlineaudiocontext/index.md | 3 ++- files/pt-br/web/api/push_api/index.md | 9 ++++--- files/pt-br/web/api/pushmanager/index.md | 3 ++- files/pt-br/web/api/request/index.md | 6 +++-- files/pt-br/web/api/request/request/index.md | 3 ++- files/pt-br/web/api/selection/index.md | 3 ++- .../using_server-sent_events/index.md | 12 ++++++--- .../pt-br/web/api/service_worker_api/index.md | 6 +++-- files/pt-br/web/api/setinterval/index.md | 18 ++++++++----- files/pt-br/web/api/storage/clear/index.md | 3 ++- files/pt-br/web/api/storage/getitem/index.md | 3 ++- files/pt-br/web/api/storage/index.md | 3 ++- files/pt-br/web/api/storage/key/index.md | 3 ++- files/pt-br/web/api/storage/length/index.md | 3 ++- .../pt-br/web/api/storage/removeitem/index.md | 3 ++- files/pt-br/web/api/storage/setitem/index.md | 3 ++- .../web/api/streams_api/concepts/index.md | 6 +++-- files/pt-br/web/api/streams_api/index.md | 3 ++- files/pt-br/web/api/subtlecrypto/index.md | 3 ++- files/pt-br/web/api/touch_events/index.md | 3 ++- .../api/url/createobjecturl_static/index.md | 6 +++-- files/pt-br/web/api/url/port/index.md | 3 ++- .../api/url/revokeobjecturl_static/index.md | 3 ++- .../web/api/urlsearchparams/values/index.md | 3 ++- .../using_the_web_animations_api/index.md | 3 ++- files/pt-br/web/api/web_audio_api/index.md | 3 ++- .../api/web_audio_api/simple_synth/index.md | 3 ++- .../using_custom_elements/index.md | 12 ++++++--- files/pt-br/web/api/web_storage_api/index.md | 6 +++-- .../using_the_web_storage_api/index.md | 6 +++-- .../simple_rtcdatachannel_sample/index.md | 9 ++++--- .../index.md | 6 +++-- .../writing_websocket_server/index.md | 12 ++++++--- .../writing_websocket_servers/index.md | 27 ++++++++++++------- files/pt-br/web/api/window/index.md | 3 ++- .../pt-br/web/api/window/innerheight/index.md | 3 ++- .../api/window/requestidlecallback/index.md | 3 ++- .../web/api/window/sessionstorage/index.md | 3 ++- .../web/api/window/setimmediate/index.md | 3 ++- files/pt-br/web/api/worker/index.md | 3 ++- files/pt-br/web/api/xmlhttprequest/index.md | 9 ++++--- .../web/api/xmlhttprequest/open/index.md | 6 +++-- .../api/xmlhttprequest/readystate/index.md | 3 ++- .../web/api/xmlhttprequest/timeout/index.md | 3 ++- .../index.md | 9 ++++--- .../using_xmlhttprequest/index.md | 24 +++++++++++------ files/pt-br/web/css/@layer/index.md | 3 ++- .../css/@media/prefers-color-scheme/index.md | 3 ++- files/pt-br/web/css/@page/index.md | 3 ++- files/pt-br/web/css/_colon_active/index.md | 3 ++- files/pt-br/web/css/_colon_blank/index.md | 3 ++- files/pt-br/web/css/_colon_checked/index.md | 3 ++- .../web/css/_colon_first-of-type/index.md | 3 ++- files/pt-br/web/css/_colon_not/index.md | 3 ++- .../web/css/_colon_nth-last-child/index.md | 3 ++- .../pt-br/web/css/_colon_only-child/index.md | 3 ++- 100 files changed, 324 insertions(+), 162 deletions(-) diff --git a/files/pt-br/web/api/element/getelementsbyclassname/index.md b/files/pt-br/web/api/element/getelementsbyclassname/index.md index 9879edf40fd57c..7fbebe7d2adee9 100644 --- a/files/pt-br/web/api/element/getelementsbyclassname/index.md +++ b/files/pt-br/web/api/element/getelementsbyclassname/index.md @@ -30,7 +30,8 @@ Habitualmente, o conjunto de elementos retornado será atualizado simultaneament O oposto disso também acontece; os elementos que não satisfazerem mais as classes contidas em `name` serão removidos instantaneamente do conjunto. -> **Nota:** No modo [quirks](/pt-BR/docs/Web/HTML/Quirks_Mode_and_Standards_Mode), o nome das classes são comparadas da forma case-insensitive. Caso contrário, considere case sensitive. +> [!NOTE] +> No modo [quirks](/pt-BR/docs/Web/HTML/Quirks_Mode_and_Standards_Mode), o nome das classes são comparadas da forma case-insensitive. Caso contrário, considere case sensitive. ## Exemplos diff --git a/files/pt-br/web/api/element/id/index.md b/files/pt-br/web/api/element/id/index.md index 58b729ea98a26c..fefd2469fc74e4 100644 --- a/files/pt-br/web/api/element/id/index.md +++ b/files/pt-br/web/api/element/id/index.md @@ -9,7 +9,8 @@ A propriedade **`Element.id`** representa o identificador do elemento, refletind O ID precisa ser único no documento, e geralmente é utilizado para obter o elemento usando {{domxref("document.getElementById", "getElementById")}}.. Outro uso comum de `id` é utilizar o [ID como um seletor](/pt-BR/docs/Web/CSS/ID_selectors) ao estilizar o documento com CSS. -> **Nota:** IDs são case-sensitive, mas você não deve criar IDs cuja única diferença nos nomes sejam letras maiúsculas/minúsculas (veja [Case sensitivity in class and id names](/pt-BR/docs/Case_Sensitivity_in_class_and_id_Names)). +> [!NOTE] +> IDs são case-sensitive, mas você não deve criar IDs cuja única diferença nos nomes sejam letras maiúsculas/minúsculas (veja [Case sensitivity in class and id names](/pt-BR/docs/Case_Sensitivity_in_class_and_id_Names)). ## Sintaxe diff --git a/files/pt-br/web/api/element/insertadjacenthtml/index.md b/files/pt-br/web/api/element/insertadjacenthtml/index.md index ad103bec102cee..51e620ff9d0b10 100644 --- a/files/pt-br/web/api/element/insertadjacenthtml/index.md +++ b/files/pt-br/web/api/element/insertadjacenthtml/index.md @@ -40,7 +40,8 @@ element.insertAdjacentHTML(posição, texto); ``` -> **Nota:** As posições beforeBegin e afterEnd funcionam apenas se o nó está em uma árvore DOM e tem um elemento pai. +> [!NOTE] +> As posições beforeBegin e afterEnd funcionam apenas se o nó está em uma árvore DOM e tem um elemento pai. ## Exemplo diff --git a/files/pt-br/web/api/element/matches/index.md b/files/pt-br/web/api/element/matches/index.md index 18f7d607a0a25d..dcff9594079be6 100644 --- a/files/pt-br/web/api/element/matches/index.md +++ b/files/pt-br/web/api/element/matches/index.md @@ -7,7 +7,8 @@ slug: Web/API/Element/matches O método **`Element.matches()`** retorna verdadeiro se o elemento puder ser selecionado pela sequência de caracteres específica; caso contrário retorna falso. -> **Aviso:** Diversos navegadores implementam isto, prefixado, sob nome não padronizado `matchesSelector()`. +> [!WARNING] +> Diversos navegadores implementam isto, prefixado, sob nome não padronizado `matchesSelector()`. ## Sintaxe diff --git a/files/pt-br/web/api/element/scroll_event/index.md b/files/pt-br/web/api/element/scroll_event/index.md index c6e2a449edf782..ce922042979640 100644 --- a/files/pt-br/web/api/element/scroll_event/index.md +++ b/files/pt-br/web/api/element/scroll_event/index.md @@ -9,7 +9,8 @@ A propriedade **`onscroll`** do {{domxref("GlobalEventHandlers")}} é uma mistur O evento `scroll` é disparado quando uma visão do documento ou um elemento foi rolado, seja por um usuário, uma [API Web](/pt-BR/docs/Web/API), ou o {{glossary("user agent")}}. -> **Nota:** Não confunda `onscroll` com {{domxref("GlobalEventHandlers.onwheel", "onwheel")}}: `onwheel` manipula a rotação da roda do mouse, enquanto `onscroll` manipula rolagem do conteúdo do objeto. +> [!NOTE] +> Não confunda `onscroll` com {{domxref("GlobalEventHandlers.onwheel", "onwheel")}}: `onwheel` manipula a rotação da roda do mouse, enquanto `onscroll` manipula rolagem do conteúdo do objeto. ## Sintaxe diff --git a/files/pt-br/web/api/element/scrollwidth/index.md b/files/pt-br/web/api/element/scrollwidth/index.md index 17047b67d12329..8690fc129ef64e 100644 --- a/files/pt-br/web/api/element/scrollwidth/index.md +++ b/files/pt-br/web/api/element/scrollwidth/index.md @@ -7,7 +7,8 @@ slug: Web/API/Element/scrollWidth A propriedade de somente leitura **`Element.scrollWidth`** retorna a largura em pixels do conteúdo de um elemento ou a largura do elemento em si, o que for maior. Se o elemento for mais amplo do que a área de conteúdo (por exemplo, se houver barras de rolagem para percorrer o conteúdo), o `scrollWidth` é maior do que o `clientWidth`. -> **Nota:** Esta propriedade irá arredondar o valor para um número inteiro. Se você precisar de um valor fracionário, use {{ domxref("element.getBoundingClientRect()") }}. +> [!NOTE] +> Esta propriedade irá arredondar o valor para um número inteiro. Se você precisar de um valor fracionário, use {{ domxref("element.getBoundingClientRect()") }}. ## Syntaxe diff --git a/files/pt-br/web/api/event/defaultprevented/index.md b/files/pt-br/web/api/event/defaultprevented/index.md index 22f349e25f3497..e068d0b54603df 100644 --- a/files/pt-br/web/api/event/defaultprevented/index.md +++ b/files/pt-br/web/api/event/defaultprevented/index.md @@ -9,7 +9,8 @@ slug: Web/API/Event/defaultPrevented Retorna um booleano que indica se ou não {{ domxref("event.preventDefault()") }} foi chamado no evento. -> **Nota:** Você deve usar isso em vez de a não-padrão, método desatualizado `getPreventDefault()` (ver [Firefox bug 691151](https://bugzil.la/691151)). +> [!NOTE] +> Você deve usar isso em vez de a não-padrão, método desatualizado `getPreventDefault()` (ver [Firefox bug 691151](https://bugzil.la/691151)). ### Sintaxe diff --git a/files/pt-br/web/api/event/preventdefault/index.md b/files/pt-br/web/api/event/preventdefault/index.md index 357ee44265b66c..d4adff1a483c98 100644 --- a/files/pt-br/web/api/event/preventdefault/index.md +++ b/files/pt-br/web/api/event/preventdefault/index.md @@ -103,7 +103,8 @@ Aqui está o resultado do código anterior: Chamar preventDefault durante qualquer fase do fluxo de eventos cancela o evento, o que significa que qualquer ação padrão normalmente feita pela aplicação como um resultado do evento não ocorrerá. -> **Nota:** A partir do Gecko 6.0, chamar o `preventDefault()` faz com que o {{ domxref("event.defaultPrevented") }} se torne true. +> [!NOTE] +> A partir do Gecko 6.0, chamar o `preventDefault()` faz com que o {{ domxref("event.defaultPrevented") }} se torne true. Você pode usar o [event.cancelable](/pt-BR/docs/Web/API/event.cancelable) para checar se o evento é cancelável. Chamar o `preventDefault` para um evento não cancelável não fará efeito. diff --git a/files/pt-br/web/api/eventsource/error_event/index.md b/files/pt-br/web/api/eventsource/error_event/index.md index 003047baba54d2..c4e2c2b5c6c394 100644 --- a/files/pt-br/web/api/eventsource/error_event/index.md +++ b/files/pt-br/web/api/eventsource/error_event/index.md @@ -21,7 +21,8 @@ evtSource.onerror = function () { }; ``` -> **Nota:** Você pode encontrar um exemplo completo no GitHub — veja [Simple SSE demo using PHP.](https://github.com/mdn/dom-examples/tree/master/server-sent-events) +> [!NOTE] +> Você pode encontrar um exemplo completo no GitHub — veja [Simple SSE demo using PHP.](https://github.com/mdn/dom-examples/tree/master/server-sent-events) ## Especificações diff --git a/files/pt-br/web/api/eventsource/eventsource/index.md b/files/pt-br/web/api/eventsource/eventsource/index.md index 4fd6bcae34c9d8..34159c498d377d 100644 --- a/files/pt-br/web/api/eventsource/eventsource/index.md +++ b/files/pt-br/web/api/eventsource/eventsource/index.md @@ -37,7 +37,8 @@ evtSource.onmessage = function (e) { }; ``` -> **Nota:** Você pode encontrar um exemplo completo no GitHub — veja [Simple SSE demo using PHP.](https://github.com/mdn/dom-examples/tree/master/server-sent-events) +> [!NOTE] +> Você pode encontrar um exemplo completo no GitHub — veja [Simple SSE demo using PHP.](https://github.com/mdn/dom-examples/tree/master/server-sent-events) ## Especificações diff --git a/files/pt-br/web/api/eventsource/index.md b/files/pt-br/web/api/eventsource/index.md index 2266880a98e10f..ac5e4ebea0e1f0 100644 --- a/files/pt-br/web/api/eventsource/index.md +++ b/files/pt-br/web/api/eventsource/index.md @@ -61,7 +61,8 @@ evtSource.onmessage = function (e) { Cada evento recebido faz com que o handler do evento `onmessage` no objeto `EventSource` seja executado. Ele, em contrapartida, cria um novo elemento {{HTMLElement("li")}} e escreve os dados da mensagem nele, e em seguida concatena o novo elemento na lista já presente no documento. -> **Nota:** Você pode encontrar um exemplo completo no GitHub — veja [Simple SSE demo using PHP.](https://github.com/mdn/dom-examples/tree/master/server-sent-events) +> [!NOTE] +> Você pode encontrar um exemplo completo no GitHub — veja [Simple SSE demo using PHP.](https://github.com/mdn/dom-examples/tree/master/server-sent-events) ## Especificações diff --git a/files/pt-br/web/api/eventtarget/addeventlistener/index.md b/files/pt-br/web/api/eventtarget/addeventlistener/index.md index 79a6f5db12fe86..c96462970cc135 100644 --- a/files/pt-br/web/api/eventtarget/addeventlistener/index.md +++ b/files/pt-br/web/api/eventtarget/addeventlistener/index.md @@ -161,7 +161,8 @@ Nos exemplos acima, o valor de this em modifyText(), quando disparado pelo event O valor de this em modifyText(), quando disparado pelo evento de clique no HTML, será uma referência ao objeto global (no caso, a janela). -> **Nota:** JavaScript 1.8.5 introduz o método [`Function.prototype.bind()`](/pt-BR/docs/JavaScript/Reference/Global_Objects/Function/bind), que permite especificar o valor que deve ser usado como `this` para todas as chamadas à uma determinada função. Isso evita problemas quando não é claro o que `this` será, dependendo do contexto do qual a sua função for chamada. Perceba, entretanto, que é preciso manter uma referência da escuta à mão, para que depois você possa removê-la. +> [!NOTE] +> JavaScript 1.8.5 introduz o método [`Function.prototype.bind()`](/pt-BR/docs/JavaScript/Reference/Global_Objects/Function/bind), que permite especificar o valor que deve ser usado como `this` para todas as chamadas à uma determinada função. Isso evita problemas quando não é claro o que `this` será, dependendo do contexto do qual a sua função for chamada. Perceba, entretanto, que é preciso manter uma referência da escuta à mão, para que depois você possa removê-la. Este é um exemplo com e sem `bind`: diff --git a/files/pt-br/web/api/fetch/index.md b/files/pt-br/web/api/fetch/index.md index 2e4e82a6d4fbcd..1d9886327f179a 100644 --- a/files/pt-br/web/api/fetch/index.md +++ b/files/pt-br/web/api/fetch/index.md @@ -19,7 +19,8 @@ similar). Uma promessa {{domxref("fetch()")}} _não_ rejeita erros HTTP (`404`, O método `fetch()` é controlado pela diretiva `connect-src` da [Content Security Policy](/pt-BR/docs/Web/HTTP/Headers/Content-Security-Policy) em vez da diretiva dos recursos que está recuperando. -> **Note:** Os parâmetros do método `fetch()` são idênticos +> [!NOTE] +> Os parâmetros do método `fetch()` são idênticos > aos do construtor {{domxref("Request.Request","Request()")}}. ## Sintaxe @@ -70,7 +71,8 @@ const fetchResponsePromise = fetch(resource [, init]) - : Diz aos navegadores para incluir credenciais em ambas requisições `same-origin` e `cross-origin`, e sempre use as credenciais enviadas de volta nas respostas. - > **Note:** As credenciais podem ser incluídas em requisições cross-origin simples e "finais", mas não devem ser incluídas em [requisições de comprovação de CORS](/pt-BR/docs/Web/HTTP/CORS#preflight_requests_and_credentials). + > [!NOTE] + > As credenciais podem ser incluídas em requisições cross-origin simples e "finais", mas não devem ser incluídas em [requisições de comprovação de CORS](/pt-BR/docs/Web/HTTP/CORS#preflight_requests_and_credentials). - `cache` - : Uma string indicando como a requisição vai interagir com o [cache HTTP](/pt-BR/docs/Web/HTTP/Caching) do navegador. Os valores possíveis, `default`, `no-store`, `reload`, `no-cache`, `force-cache`, e `only-if-cached`, estão documentados no artigo para a propriedade {{domxref("Request/cache", "cache")}} do objeto {{domxref("Request")}}. diff --git a/files/pt-br/web/api/fetch_api/index.md b/files/pt-br/web/api/fetch_api/index.md index 2948d901315e9c..94582f53a3a763 100644 --- a/files/pt-br/web/api/fetch_api/index.md +++ b/files/pt-br/web/api/fetch_api/index.md @@ -21,7 +21,8 @@ Uma vez que uma {{domxref("Response")}} é recuperada, há uma série de método Você pode criar um pedido e uma resposta diretamente usando os construtores {{domxref("Request.Request","Request()")}} e {{domxref("Response.Response","Response()")}}, mas é improvável que você faça isso diretamente. Em vez disso, é mais provável que sejam criados como resultados de outras ações da API (por exemplo, {{domxref("FetchEvent.respondWith")}} de service workers). -> **Nota:** Encontre mais informações sobre os recursos do Fetch API em [Using Fetch](/pt-BR/docs/Web/API/Fetch_API/Using_Fetch), e conceitos para estudos em [Fetch basic concepts](/pt-BR/docs/Web/API/Fetch_API/Basic_concepts). +> [!NOTE] +> Encontre mais informações sobre os recursos do Fetch API em [Using Fetch](/pt-BR/docs/Web/API/Fetch_API/Using_Fetch), e conceitos para estudos em [Fetch basic concepts](/pt-BR/docs/Web/API/Fetch_API/Basic_concepts). ## Fetch Interfaces diff --git a/files/pt-br/web/api/fetch_api/using_fetch/index.md b/files/pt-br/web/api/fetch_api/using_fetch/index.md index 441fd49cf6fb7c..d617d7d029bb34 100644 --- a/files/pt-br/web/api/fetch_api/using_fetch/index.md +++ b/files/pt-br/web/api/fetch_api/using_fetch/index.md @@ -19,7 +19,8 @@ Os suportes para Fetch ainda estão em uma fase bastante precoce, mas começa a Caso tenha interesse no uso da ferramenta, há também uma [Fetch Polyfill](https://github.com/github/fetch) disponivel que recria as funcionalidade para outros navegadores que ainda não o suporta. Fique ciente que está em estado experimental e ainda não há uma versão completa. -> **Nota:** There have been some concerns raised that the [Fetch spec](https://fetch.spec.whatwg.org/) is at odds with the [Streams spec](https://streams.spec.whatwg.org/); however, future plans show an intention to integrate Streams with Fetch: read [Fetch API integrated with Streams](https://github.com/yutakahirano/fetch-with-streams/) for more information. +> [!NOTE] +> There have been some concerns raised that the [Fetch spec](https://fetch.spec.whatwg.org/) is at odds with the [Streams spec](https://streams.spec.whatwg.org/); however, future plans show an intention to integrate Streams with Fetch: read [Fetch API integrated with Streams](https://github.com/yutakahirano/fetch-with-streams/) for more information. ## Detecção de Recursos @@ -54,7 +55,8 @@ Aqui estamos procurando uma imagem e inserindo em um elemento {{htmlelement("img Esta é apenas uma resposta HTTP, não a imagem em sí. Para extrairmos a imagem da resposta, nós usamos o método {{domxref("Body.blob","blob()")}} (definido no mixin do {{domxref("Body")}}, que são implementados por ambos os objetos {{domxref("Request")}} e {{domxref("Response")}}.) -> **Nota:** O Body mixin além disso possui métodos similares para extrair outros tipos de conteúdo do body; Veja a sessão [Body](#body) para mais detalhes. +> [!NOTE] +> O Body mixin além disso possui métodos similares para extrair outros tipos de conteúdo do body; Veja a sessão [Body](#body) para mais detalhes. Um `objectURL` é criado na extração de {{domxref("Blob")}}, que então é inserido no {{domxref("img")}}. @@ -143,7 +145,8 @@ var anotherRequest = new Request(myRequest, myInit); Isso é muito útil, pois os conteúdos de cada solicitação e resposta tem apenas um uso. Fazer uma cópia como essa permite que você use a solicitação / resposta novamente, variando as opções de inicialização, se desejar. -> **Nota:** Também existe um método que cria uma cópia: {{domxref ("Request.clone", "clone ()")}}. Isso tem uma semântica ligeiramente diferente do outro método de cópia: o primeiro dirá se o conteúdo, da solicitação anterior, já tiver sido lido (ou copiado), enquanto o segundo, `clone()` não. +> [!NOTE] +> Também existe um método que cria uma cópia: {{domxref ("Request.clone", "clone ()")}}. Isso tem uma semântica ligeiramente diferente do outro método de cópia: o primeiro dirá se o conteúdo, da solicitação anterior, já tiver sido lido (ou copiado), enquanto o segundo, `clone()` não. ## Headers @@ -222,7 +225,8 @@ Possible guard values are: - `response`: guard for a Headers obtained from a response ({{domxref("Response.headers")}}). - `immutable`: Mostly used for ServiceWorkers; renders a headers object read-only. -> **Nota:** You may not append or set a `request` guarded Headers' `Content-Length` header. Similarly, inserting `Set-Cookie` into a response header is not allowed: ServiceWorkers are not allowed to set cookies via synthesized responses. +> [!NOTE] +> You may not append or set a `request` guarded Headers' `Content-Length` header. Similarly, inserting `Set-Cookie` into a response header is not allowed: ServiceWorkers are not allowed to set cookies via synthesized responses. ## Response objects @@ -250,7 +254,8 @@ The most common response properties you'll use are: - {{domxref("Response.statusText")}} — A string (default value "OK"),which corresponds to the HTTP status code message. - {{domxref("Response.ok")}} — seen in use above, this is a shorthand for checking that status is in the range 200-299 inclusive. This returns a {{domxref("Boolean")}}. -> **Nota:** The static method {{domxref("Response.error","error()")}} simply returns an error response. Similarly, {{domxref("Response.redirect","redirect()")}} returns a response resulting in +> [!NOTE] +> The static method {{domxref("Response.error","error()")}} simply returns an error response. Similarly, {{domxref("Response.redirect","redirect()")}} returns a response resulting in > a redirect to a specified URL. These are also only relevant to Service Workers. ## Body diff --git a/files/pt-br/web/api/filelist/index.md b/files/pt-br/web/api/filelist/index.md index 2c475475c611f3..37da0e832a9c58 100644 --- a/files/pt-br/web/api/filelist/index.md +++ b/files/pt-br/web/api/filelist/index.md @@ -7,7 +7,8 @@ slug: Web/API/FileList Um objeto desse tipo é retornado pela propriedade `files` do elemento HTML {{HTMLElement("input")}}; isso permite acessar a lista de arquivos selecionados com o elemento ``. Também é usado para uma lista de arquivos soltos no conteúdo web usando a API drag and drop; consulte o objeto [`DataTransfer`](/pt-BR/docs/DragDrop/DataTransfer) para detalhes de seu uso. -> **Nota:** Antes do Gecko 1.9.2, o elemento input suportava apenas um arquivo selecionado por vez, ou seja, o array FileList conteria apenas um arquivo. A partir do Gecko 1.9.2, se o atributo multiple do elemento for definido, FileList pode conter múltiplos arquivos. +> [!NOTE] +> Antes do Gecko 1.9.2, o elemento input suportava apenas um arquivo selecionado por vez, ou seja, o array FileList conteria apenas um arquivo. A partir do Gecko 1.9.2, se o atributo multiple do elemento for definido, FileList pode conter múltiplos arquivos. ## Utilizando a lista de arquivos diff --git a/files/pt-br/web/api/filereader/readasdataurl/index.md b/files/pt-br/web/api/filereader/readasdataurl/index.md index a7ec2ee1f92fa3..7680ea207e4d90 100644 --- a/files/pt-br/web/api/filereader/readasdataurl/index.md +++ b/files/pt-br/web/api/filereader/readasdataurl/index.md @@ -96,7 +96,8 @@ function previewFiles() { } ``` -> **Nota:** O construtor do [`FileReader()`](/pt-BR/docs/Web/API/FileReader) não é suportado por versões anteriores à 10 do Internet Explorer. Para uma maior compatibilidade você pode ver os exemplos [prévia de imagem básica](https://mdn.mozillademos.org/files/3699/crossbrowser_image_preview.html) ou [prévia de imagem avançada](https://mdn.mozillademos.org/files/3698/image_upload_preview.html). +> [!NOTE] +> O construtor do [`FileReader()`](/pt-BR/docs/Web/API/FileReader) não é suportado por versões anteriores à 10 do Internet Explorer. Para uma maior compatibilidade você pode ver os exemplos [prévia de imagem básica](https://mdn.mozillademos.org/files/3699/crossbrowser_image_preview.html) ou [prévia de imagem avançada](https://mdn.mozillademos.org/files/3698/image_upload_preview.html). ## Especificações diff --git a/files/pt-br/web/api/formdata/append/index.md b/files/pt-br/web/api/formdata/append/index.md index b68844b4d6caf4..561e759d8c16fd 100644 --- a/files/pt-br/web/api/formdata/append/index.md +++ b/files/pt-br/web/api/formdata/append/index.md @@ -11,7 +11,8 @@ O método **`append()`** da Interface {{domxref("FormData")}} adiciona um novo v A diferença entre {{domxref("FormData.set")}} e `append()` é que se uma chave específica já exista, {{domxref("FormData.set")}} irá substituir o valor existente com um novo valor, já o `append()` irá adicionar um novo valor no fim do conjunto de valores. -> **Nota:** Este metodo esta desponivel no [Web Workers](/pt-BR/docs/Web/API/Web_Workers_API). +> [!NOTE] +> Este metodo esta desponivel no [Web Workers](/pt-BR/docs/Web/API/Web_Workers_API). ## Sintaxe @@ -31,7 +32,8 @@ formData.append(name, value, filename); - `filename` {{optional_inline}} - : O filename reporta para o servidor (a {{domxref("USVString")}}), quando a {{domxref("Blob")}} ou {{domxref("File")}} é passado como o segundo parametro. O default filename para {{domxref("Blob")}} o objecto é "blob". -> **Nota:** Se espisificares {{domxref("Blob")}} como a data append para o objecto `FormData` , o filename a ser reportado para o servidor no "Content-Disposition" header usado para mudar de browser em browser. +> [!NOTE] +> Se espisificares {{domxref("Blob")}} como a data append para o objecto `FormData` , o filename a ser reportado para o servidor no "Content-Disposition" header usado para mudar de browser em browser. ### Retorna diff --git a/files/pt-br/web/api/formdata/delete/index.md b/files/pt-br/web/api/formdata/delete/index.md index 1a78df181345a1..0c22cd4af2c810 100644 --- a/files/pt-br/web/api/formdata/delete/index.md +++ b/files/pt-br/web/api/formdata/delete/index.md @@ -9,7 +9,8 @@ slug: Web/API/FormData/delete O metodo **`delete()`** da interface {{domxref("FormData")}} deleta uma chave/valor pares do Objecto `FormData` . -> **Nota:** Este metodo esta Disponivel em [Web Workers](/pt-BR/docs/Web/API/Web_Workers_API). +> [!NOTE] +> Este metodo esta Disponivel em [Web Workers](/pt-BR/docs/Web/API/Web_Workers_API). ## Sintaxe diff --git a/files/pt-br/web/api/formdata/entries/index.md b/files/pt-br/web/api/formdata/entries/index.md index 3d0b7b7f623b8b..99325ea7ce07fb 100644 --- a/files/pt-br/web/api/formdata/entries/index.md +++ b/files/pt-br/web/api/formdata/entries/index.md @@ -9,7 +9,8 @@ slug: Web/API/FormData/entries O método **`FormData.entries()`** retorna um {{jsxref("Iteration_protocols",'iterator')}} permitindo percorrer todos os valores de chave/valor contidos nesse objeto. A chave de cada par é um objeto {{domxref("USVString")}}; o valor é {{domxref("USVString")}}, ou um {{domxref("Blob")}}. -> **Nota:** This method is available in [Web Workers](/pt-BR/docs/Web/API/Web_Workers_API). +> [!NOTE] +> This method is available in [Web Workers](/pt-BR/docs/Web/API/Web_Workers_API). ## Sintaxe diff --git a/files/pt-br/web/api/formdata/formdata/index.md b/files/pt-br/web/api/formdata/formdata/index.md index ce8051f521ac52..89b35328fed28f 100644 --- a/files/pt-br/web/api/formdata/formdata/index.md +++ b/files/pt-br/web/api/formdata/formdata/index.md @@ -9,7 +9,8 @@ slug: Web/API/FormData/FormData O **`FormData()`** construtor cria um novo objeto {{domxref("FormData")}}. -> **Nota:** Este recurso está disponível em [Web Workers](/pt-BR/docs/Web/API/Web_Workers_API). +> [!NOTE] +> Este recurso está disponível em [Web Workers](/pt-BR/docs/Web/API/Web_Workers_API). ## Sintaxe @@ -56,7 +57,8 @@ Ou você pode especificicar o opcional `form` argument ao criar o objeto `FormDa ``` -> **Nota:** Todos os elementos de entrada têm um atributo 'name'. Para que possa acessar seus valores mais tarde. +> [!NOTE] +> Todos os elementos de entrada têm um atributo 'name'. Para que possa acessar seus valores mais tarde. ```js var myForm = document.getElementById("myForm"); diff --git a/files/pt-br/web/api/formdata/get/index.md b/files/pt-br/web/api/formdata/get/index.md index a1ed1934690998..ba3dd8f58e3e27 100644 --- a/files/pt-br/web/api/formdata/get/index.md +++ b/files/pt-br/web/api/formdata/get/index.md @@ -9,7 +9,8 @@ slug: Web/API/FormData/get O método get() da interface {{domxref("FormData")}} retorna o primeiro valor associado com a chave fornecida de um objeto do tipo FormData. -> **Nota:** Este método está disponível em [Web Workers](/pt-BR/docs/Web/API/Web_Workers_API). +> [!NOTE] +> Este método está disponível em [Web Workers](/pt-BR/docs/Web/API/Web_Workers_API). ## Sintaxe diff --git a/files/pt-br/web/api/formdata/getall/index.md b/files/pt-br/web/api/formdata/getall/index.md index 3ae44b0c56da9b..a4544c85d58ffe 100644 --- a/files/pt-br/web/api/formdata/getall/index.md +++ b/files/pt-br/web/api/formdata/getall/index.md @@ -9,7 +9,8 @@ slug: Web/API/FormData/getAll O metodo **`getAll()`** do {{domxref("FormData")}} retorna todos os valores associados com a chave dentro `de um objeto FormData`. -> **Nota:** Este metodo esta disponivel no [Web Workers](/pt-BR/docs/Web/API/Web_Workers_API). +> [!NOTE] +> Este metodo esta disponivel no [Web Workers](/pt-BR/docs/Web/API/Web_Workers_API). ## Syntax diff --git a/files/pt-br/web/api/formdata/has/index.md b/files/pt-br/web/api/formdata/has/index.md index 6af741d8798e53..40895f69bfd166 100644 --- a/files/pt-br/web/api/formdata/has/index.md +++ b/files/pt-br/web/api/formdata/has/index.md @@ -9,7 +9,8 @@ slug: Web/API/FormData/has O método **`has()`** da interface {{domxref("FormData")}} retorna um booleano declarando se o objeto `FormData` contém uma certa chave. -> **Nota:** This method is available in [Web Workers](/pt-BR/docs/Web/API/Web_Workers_API). +> [!NOTE] +> This method is available in [Web Workers](/pt-BR/docs/Web/API/Web_Workers_API). ## Sintaxe diff --git a/files/pt-br/web/api/formdata/index.md b/files/pt-br/web/api/formdata/index.md index 9c84e56c5ea6ee..cf887d5e7d26ce 100644 --- a/files/pt-br/web/api/formdata/index.md +++ b/files/pt-br/web/api/formdata/index.md @@ -11,7 +11,8 @@ A interface **`FormData`** fornece uma maneira fácil de construir um conjunto d Um objeto `FormData` pode ser usado diretamente em uma estrutura {{jsxref("Statements/for...of", "for...of")}} em vez de {{domxref('FormData.entries()', 'entries()')}}: `for (var p of myFormData)` é o mesmo que `for (var p of myFormData.entries())`. -> **Nota:** Esse recurso está disponível em [https://developer.mozilla.org/pt-BR/docs/Web/API/Web_Workers_API](/pt-BR/docs/Web/API/Web_Workers_API) +> [!NOTE] +> Esse recurso está disponível em [https://developer.mozilla.org/pt-BR/docs/Web/API/Web_Workers_API](/pt-BR/docs/Web/API/Web_Workers_API) ## Construtor @@ -33,7 +34,8 @@ Um objeto `FormData` pode ser usado diretamente em uma estrutura {{jsxref("State - {{domxref("FormData.set")}} - : Define um novo valor para uma chave existente dentro de um objeto `FormData`, ou adiciona a chave/valor se ele ainda não existir. -> **Nota:** Para ser claro, a diferença entre {{domxref("FormData.set()")}} e {{domxref("FormData.append()")}} é que, se a chave especificada não existir, {{domxref("FormData.set()")}} irá substituir o valor existente por um novo, enquanto {{domxref("FormData.append()")}} irá acrescentar um novo valor no final dos valores existentes. Veja as suas páginas dedicadas para código de exemplo. +> [!NOTE] +> Para ser claro, a diferença entre {{domxref("FormData.set()")}} e {{domxref("FormData.append()")}} é que, se a chave especificada não existir, {{domxref("FormData.set()")}} irá substituir o valor existente por um novo, enquanto {{domxref("FormData.append()")}} irá acrescentar um novo valor no final dos valores existentes. Veja as suas páginas dedicadas para código de exemplo. ## Especificações diff --git a/files/pt-br/web/api/formdata/set/index.md b/files/pt-br/web/api/formdata/set/index.md index 7335530acc2b19..fdd650e19032e7 100644 --- a/files/pt-br/web/api/formdata/set/index.md +++ b/files/pt-br/web/api/formdata/set/index.md @@ -11,7 +11,8 @@ O método **`set()`** da interface {{domxref("FormData")}} adiciona o novo valor A diferença entre `set()` e {{domxref("FormData.append")}} é que, se a chave especificada já existir, `set()` irá sobrescrever todos os valores existentes pelo novo valor, enquanto o {{domxref("FormData.append")}} apenas acrescenta o novo valor ao conjunto de valores existentes. -> **Nota:** Esse método está disponível em [Web Workers](/pt-BR/docs/Web/API/Web_Workers_API). +> [!NOTE] +> Esse método está disponível em [Web Workers](/pt-BR/docs/Web/API/Web_Workers_API). ## Sintaxe @@ -31,7 +32,8 @@ formData.set(name, value, filename); - `filename` {{optional_inline}} - : O nome do arquivo a ser enviado (um {{domxref("USVString")}}), quando um {{domxref("Blob")}} ou um {{domxref("File")}} é passdo como o segundo parâmetro. O nome de arquivo padrão para objetos do tipo {{domxref("Blob")}} é "blob". -> **Nota:** Se você especificar um {{domxref("Blob")}} como o dado a ser acrescentado ao objeto `FormData`, o nome do arquivo que será enviado para o servidor, enviado no atributo "Content-Disposition" no cabeçalho varia de navegador para navegador. +> [!NOTE] +> Se você especificar um {{domxref("Blob")}} como o dado a ser acrescentado ao objeto `FormData`, o nome do arquivo que será enviado para o servidor, enviado no atributo "Content-Disposition" no cabeçalho varia de navegador para navegador. ## Exemplo diff --git a/files/pt-br/web/api/geolocation/index.md b/files/pt-br/web/api/geolocation/index.md index a70a02a2fe7e02..5b629179785d30 100644 --- a/files/pt-br/web/api/geolocation/index.md +++ b/files/pt-br/web/api/geolocation/index.md @@ -9,7 +9,8 @@ A interface **Geolocation** representa um objeto ábil de programaticamente obte Um objeto com tal interface é obtido utilizando a propriedade {{domxref("NavigatorGeolocation.geolocation")}} implementada pelo objeto {{domxref("Navigator")}}. -> **Nota:** Por questões de segurança, quando uma página tenta obter acesso às informações de localização o usuário é notificado e uma requisição é feita para o mesmo fornecesser a permissão. Saiba que cada navegaor possui suas próprias políticas e métodos para requisitar tal permissão. +> [!NOTE] +> Por questões de segurança, quando uma página tenta obter acesso às informações de localização o usuário é notificado e uma requisição é feita para o mesmo fornecesser a permissão. Saiba que cada navegaor possui suas próprias políticas e métodos para requisitar tal permissão. ## Propriedades diff --git a/files/pt-br/web/api/history_api/working_with_the_history_api/index.md b/files/pt-br/web/api/history_api/working_with_the_history_api/index.md index 405e3ddb367edd..973c4d111fe867 100644 --- a/files/pt-br/web/api/history_api/working_with_the_history_api/index.md +++ b/files/pt-br/web/api/history_api/working_with_the_history_api/index.md @@ -5,7 +5,8 @@ slug: Web/API/History_API/Working_with_the_History_API Esse é um exemplo de um web site em AJAX web site composto por apenas três páginas (_first_page.php_, _second_page.php_ e _third_page.php_). Para ver como funciona, crie os arquivos a seguir (ou _git clone_ [https://github.com/giabao/mdn-ajax-nav-example.git](https://github.com/giabao/mdn-ajax-nav-example) ): -> **Nota:** Para integrar completamente os elementos {{HTMLElement("form")}} com esse _mecanismo_, porfavor dê uma olhada no parágrafo [Enviando formulários e enviando arquivos](/pt-BR/docs/Web/API/XMLHttpRequest/Using_XMLHttpRequest#Submitting_forms_and_uploading_files). +> [!NOTE] +> Para integrar completamente os elementos {{HTMLElement("form")}} com esse _mecanismo_, porfavor dê uma olhada no parágrafo [Enviando formulários e enviando arquivos](/pt-BR/docs/Web/API/XMLHttpRequest/Using_XMLHttpRequest#Submitting_forms_and_uploading_files). **first_page.php**: @@ -432,7 +433,8 @@ const ajaxRequest = new (function () { })(); ``` -> **Nota:** A atual implementação de [`const`](/pt-BR/JavaScript/Reference/Statements/const) (declaração de constante) **não é parte do ECMAScript 5**. É suportada no Firefox e no Chrome (V8) e parcialmente suportada no Opera 9+ e no Safari. **Ela não é suportada nas versões do Internet Explorer 6 ao 9, ou na versão _preview_ do Internet Explorer 10**. [`const`](/pt-BR/JavaScript/Reference/Statements/const) será definida no ECMAScript 6, mas com semânticas diferentes. Similarmente ao que acontece com variáveis definidas como [`let`](/pt-BR/JavaScript/Reference/Statements/let), constantes declaradas com [`const`](/pt-BR/JavaScript/Reference/Statements/const) serão _block-scoped_, limitando seu escopo no bloco. **Nós só usamos isso com propósito didático. Se você quer total compatibilidade com os navegadores, substitua todas as declarações [`const`](/pt-BR/JavaScript/Reference/Statements/const) por declarações [`var`](/pt-BR/JavaScript/Reference/Statements/var).** +> [!NOTE] +> A atual implementação de [`const`](/pt-BR/JavaScript/Reference/Statements/const) (declaração de constante) **não é parte do ECMAScript 5**. É suportada no Firefox e no Chrome (V8) e parcialmente suportada no Opera 9+ e no Safari. **Ela não é suportada nas versões do Internet Explorer 6 ao 9, ou na versão _preview_ do Internet Explorer 10**. [`const`](/pt-BR/JavaScript/Reference/Statements/const) será definida no ECMAScript 6, mas com semânticas diferentes. Similarmente ao que acontece com variáveis definidas como [`let`](/pt-BR/JavaScript/Reference/Statements/let), constantes declaradas com [`const`](/pt-BR/JavaScript/Reference/Statements/const) serão _block-scoped_, limitando seu escopo no bloco. **Nós só usamos isso com propósito didático. Se você quer total compatibilidade com os navegadores, substitua todas as declarações [`const`](/pt-BR/JavaScript/Reference/Statements/const) por declarações [`var`](/pt-BR/JavaScript/Reference/Statements/var).** Para mais informações, veja: [Manipulando o histórico do navegador](/pt-BR/docs/DOM/Manipulating_the_browser_history). 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 index 34b7c3003871a7..c31a05fa5f91d5 100644 --- 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 @@ -9,7 +9,8 @@ As interfaces HTML Drag and Drop permitem que os aplicativos da Web arrastem e s Os principais passos para o drag and drop é definir a _drop zone_ (ou seja definir um elemento para a queda dos arquivos) e definir event handlers para os eventos {{event("drop")}} e {{event("dragover")}} . Essas etapas são descritas abaixo, incluindo exemplos de trechos de código. O codigo fonte esta disponivel em [MDN's drag-and-drop repository](https://github.com/mdn/dom-examples/tree/master/drag-and-drop) (pull requests e/ou issues são bem-vindas). -> **Nota:** Nota: {{domxref("HTML_Drag_and_Drop_API","HTML drag and drop")}}Define duas APIs diferentes para suportar arrastar e soltar arquivos. Uma API é a interface {{domxref("DataTransfer")}} e a segunda API é a interface {{domxref("DataTransferItem")}} e {{domxref("DataTransferItemList")}}. Este exemplo ilustra o uso de ambas as APIs (e não usa nehuma interface específica do Gecko). +> [!NOTE] +> Nota: {{domxref("HTML_Drag_and_Drop_API","HTML drag and drop")}}Define duas APIs diferentes para suportar arrastar e soltar arquivos. Uma API é a interface {{domxref("DataTransfer")}} e a segunda API é a interface {{domxref("DataTransferItem")}} e {{domxref("DataTransferItemList")}}. Este exemplo ilustra o uso de ambas as APIs (e não usa nehuma interface específica do Gecko). ## Definindo a drop _zone_ @@ -42,7 +43,8 @@ Por fim, um aplicativo pode querer estilizar o elemento da drop zone para indica } ``` -> **Nota:** Nota: Observe que os eventos `dragstart` e `dragend` não são acionados ao arrastar um arquivo para o navegador do OS. +> [!NOTE] +> Nota: Observe que os eventos `dragstart` e `dragend` não são acionados ao arrastar um arquivo para o navegador do OS. ## Processo de drop diff --git a/files/pt-br/web/api/htmlcanvaselement/getcontext/index.md b/files/pt-br/web/api/htmlcanvaselement/getcontext/index.md index ee7cf5a6b15734..b0ecb36d491e4d 100644 --- a/files/pt-br/web/api/htmlcanvaselement/getcontext/index.md +++ b/files/pt-br/web/api/htmlcanvaselement/getcontext/index.md @@ -24,7 +24,8 @@ canvas.getContext(contextType, contextAttributes); - `"webgl2"` que criará um objeto {{domxref("WebGL2RenderingContext")}} representando uma renderização tridimensional. Esse contexto está disponivel somente em browsers que implementam [WebGL](/pt-BR/docs/Web/WebGL) versão 2 (OpenGL ES 3.0). {{experimental_inline}} - `"bitmaprenderer"` que criará um {{domxref("ImageBitmapRenderingContext")}} que apenas provê a funcionalidade de substituir o conteúdo do canvas pelo de um {{domxref("ImageBitmap")}}. - > **Nota:** O identificador "`experimental-webgl`" é usado em novas implementações do WebGL. Essas implementações ou ainda não passaram nos casos de teste, ou os drivers gráficos na plataforma ainda não estão estáveis. O [Khronos Group](https://www.khronos.org/) certifica as implementações do WebGL sob certas [regas de conformidade](https://www.khronos.org/registry/webgl/sdk/tests/CONFORMANCE_RULES.txt). + > [!NOTE] + > O identificador "`experimental-webgl`" é usado em novas implementações do WebGL. Essas implementações ou ainda não passaram nos casos de teste, ou os drivers gráficos na plataforma ainda não estão estáveis. O [Khronos Group](https://www.khronos.org/) certifica as implementações do WebGL sob certas [regas de conformidade](https://www.khronos.org/registry/webgl/sdk/tests/CONFORMANCE_RULES.txt). - `contextAttributes` diff --git a/files/pt-br/web/api/htmlcollection/index.md b/files/pt-br/web/api/htmlcollection/index.md index 8d7f405b0a9046..f6d93a1c094fbf 100644 --- a/files/pt-br/web/api/htmlcollection/index.md +++ b/files/pt-br/web/api/htmlcollection/index.md @@ -7,7 +7,8 @@ slug: Web/API/HTMLCollection A interface **`HTMLCollection`** representa uma coleção genérica (objeto array) de elementos (na ordem em que aparecem no documento) e oferece métodos e propriedades para selecioná-los da lista. -> **Nota:** Esta interface é chamada `HTMLCollection` por razões históricas (antes do DOM4, coleções implementadas por esta interface somente podiam ter elementos HTML). +> [!NOTE] +> Esta interface é chamada `HTMLCollection` por razões históricas (antes do DOM4, coleções implementadas por esta interface somente podiam ter elementos HTML). Uma coleção `HTMLCollection` de um HTML DOM está linkada com o documento; ela será automaticamente atualizada quando o documento for modificado. diff --git a/files/pt-br/web/api/htmlelement/accesskey/index.md b/files/pt-br/web/api/htmlelement/accesskey/index.md index e172e740a3b571..fa1d9b95c15d75 100644 --- a/files/pt-br/web/api/htmlelement/accesskey/index.md +++ b/files/pt-br/web/api/htmlelement/accesskey/index.md @@ -7,4 +7,5 @@ slug: Web/API/HTMLElement/accessKey A propriedade **Element.accessKey** define a tecla pelo qual o usuário pode pressionar para saltar para este elemento. -> **Nota:** Nota: _A propriedade **Element.accessKey** é raramente usada por causa dos conflitos múltiplos com os atalhos pré-definidos nos navegadores. Para contornar isto, os navegadores implementam o comportamento da tecla de acesso se as teclas são pressionadas com outras teclas "qualificadas" (como Alt + tecla de acesso)._ +> [!NOTE] +> Nota: _A propriedade **Element.accessKey** é raramente usada por causa dos conflitos múltiplos com os atalhos pré-definidos nos navegadores. Para contornar isto, os navegadores implementam o comportamento da tecla de acesso se as teclas são pressionadas com outras teclas "qualificadas" (como Alt + tecla de acesso)._ diff --git a/files/pt-br/web/api/htmlelement/offsetheight/index.md b/files/pt-br/web/api/htmlelement/offsetheight/index.md index 2864e9af6b5083..8023061e0b702c 100644 --- a/files/pt-br/web/api/htmlelement/offsetheight/index.md +++ b/files/pt-br/web/api/htmlelement/offsetheight/index.md @@ -11,7 +11,8 @@ Typically, an element's `offsetHeight` is a measurement in pixels of the element For the document body object, the measurement includes total linear content height instead of the element's CSS height. Floated elements extending below other linear content are ignored. -> **Nota:** This property will round the value to an integer. If you need a fractional value, use {{ domxref("element.getBoundingClientRect()") }}. +> [!NOTE] +> This property will round the value to an integer. If you need a fractional value, use {{ domxref("element.getBoundingClientRect()") }}. ## Syntax diff --git a/files/pt-br/web/api/htmlelement/offsetwidth/index.md b/files/pt-br/web/api/htmlelement/offsetwidth/index.md index 2c55d8832d4e8d..497ae290c62b79 100644 --- a/files/pt-br/web/api/htmlelement/offsetwidth/index.md +++ b/files/pt-br/web/api/htmlelement/offsetwidth/index.md @@ -15,7 +15,8 @@ var offsetWidth =element.offsetWidth; `offsetWidth` é uma propriedade somente leitura. -> **Nota:** Esta propriedade irá arredondar o valor para um inteiro. se você precisa um valor fracionado, use {{ domxref("element.getBoundingClientRect()") }}. +> [!NOTE] +> Esta propriedade irá arredondar o valor para um inteiro. se você precisa um valor fracionado, use {{ domxref("element.getBoundingClientRect()") }}. ## Exemplo diff --git a/files/pt-br/web/api/htmlformelement/submit_event/index.md b/files/pt-br/web/api/htmlformelement/submit_event/index.md index a78700f59f5311..1fdd0a28ed5f80 100644 --- a/files/pt-br/web/api/htmlformelement/submit_event/index.md +++ b/files/pt-br/web/api/htmlformelement/submit_event/index.md @@ -32,7 +32,8 @@ O evento **`submit`** é disparado quando é feita a submissão de um {{HtmlElem O evento `submit` é disparado quando a pessoa usuária clica em um botão ({{HtmlElement("button")}} ou {{HtmlElement('input/submit', '<input type="submit">')}}) ou pressiona Enter enquanto está editando um campo (p. ex. {{HtmlElement('input/text', '<input type="text">')}}) em um formulário. O evento não é enviado ao formulário quando se chama o método {{domxref("HTMLFormElement.submit()", "form.submit()")}} diretamente. -> **Nota:** Tentar submeter um formulário que não passa na [validação](/pt-BR/docs/Learn/Forms/Form_validation) dispara um evento {{domxref("HTMLInputElement/invalid_event", "invalid")}}. Nesse caso, a validação previne a submissão do formulário, impedindo que seja disparado o evento `submit`. +> [!NOTE] +> Tentar submeter um formulário que não passa na [validação](/pt-BR/docs/Learn/Forms/Form_validation) dispara um evento {{domxref("HTMLInputElement/invalid_event", "invalid")}}. Nesse caso, a validação previne a submissão do formulário, impedindo que seja disparado o evento `submit`. ## Exemplos diff --git a/files/pt-br/web/api/idbcursor/index.md b/files/pt-br/web/api/idbcursor/index.md index 078af760687015..2f42d9509a0ba7 100644 --- a/files/pt-br/web/api/idbcursor/index.md +++ b/files/pt-br/web/api/idbcursor/index.md @@ -43,7 +43,8 @@ Pode ter um número ilimitado de cursores ao mesmo tempo. Você sempre consegue ## Constantes -> **Aviso:** These constants are no longer available. You should use the string constants directly instead. ([Firefox bug 891944](https://bugzil.la/891944)) +> [!WARNING] +> These constants are no longer available. You should use the string constants directly instead. ([Firefox bug 891944](https://bugzil.la/891944)) - `NEXT`: `"next"` : The cursor shows all records, including duplicates. It starts at the lower bound of the key range and moves upwards (monotonically increasing in the order of keys). - `NEXTUNIQUE` : `"nextunique"` : The cursor shows all records, excluding duplicates. If multiple records exist with the same key, only the first one iterated is retrieved. It starts at the lower bound of the key range and moves upwards. diff --git a/files/pt-br/web/api/indexeddb_api/index.md b/files/pt-br/web/api/indexeddb_api/index.md index 8ae8df2d79170d..0c7815a96b4bb7 100644 --- a/files/pt-br/web/api/indexeddb_api/index.md +++ b/files/pt-br/web/api/indexeddb_api/index.md @@ -13,7 +13,8 @@ IndexedDB provém APIs separadas para acesso tanto síncrono quanto assíncrono. Os métodos da API assíncrona são chamados sem bloquear a thread que os chama. Para obter acesso assíncrono à database, chame [open()](/pt-BR/docs/Web/API/IDBFactory.open) no atributo [indexedDB](/pt-BR/docs/Web/API/IDBEnvironment.indexedDB) do objeto [window](/pt-BR/docs/DOM/window), que retornará um objeto {{domxref("IDBRequest")}}. Operações assíncronas comunicam-se com a aplicação que os chamam executando eventos nos objetos {{domxref("IDBRequest")}}. -> **Nota:** Nota: O objeto indexedDB é prefixado em navegadores mais antigos (propriedade mozIndexedDB em Gecko < 16, webkitIndexedDb em Chrome e msIndexedDB no IE 10). +> [!NOTE] +> Nota: O objeto indexedDB é prefixado em navegadores mais antigos (propriedade mozIndexedDB em Gecko < 16, webkitIndexedDb em Chrome e msIndexedDB no IE 10). As interfaces da API assíncrona do IndexedDB são: @@ -47,7 +48,8 @@ Uma versão anterior da especificação também define estas interfaces agora re - {{domxref("IDBDatabaseException")}} - : Representa condições de erro que podem ser encontradas enquanto performando operações no banco de dados. -> **Nota:** há também a [versão síncrona da API](/pt-BR/docs/IndexedDB/Syncronous_API). A versão síncrona não tem implementação em qualquer navegador. É feita para ser utilizada com [WebWorkers](/pt-BR/docs/DOM/Using_web_workers). +> [!NOTE] +> há também a [versão síncrona da API](/pt-BR/docs/IndexedDB/Syncronous_API). A versão síncrona não tem implementação em qualquer navegador. É feita para ser utilizada com [WebWorkers](/pt-BR/docs/DOM/Using_web_workers). ## Limites de Armazenamento diff --git a/files/pt-br/web/api/indexeddb_api/using_indexeddb/index.md b/files/pt-br/web/api/indexeddb_api/using_indexeddb/index.md index 6839df36660a80..ea234223ae3d6a 100644 --- a/files/pt-br/web/api/indexeddb_api/using_indexeddb/index.md +++ b/files/pt-br/web/api/indexeddb_api/using_indexeddb/index.md @@ -74,7 +74,8 @@ A requisição de abertura não abre o banco ou inicia a transação. A chamada O segundo parâmetro para o método open é a versão do banco. A versão do banco determina seu schema — os registros no banco e sua estrutura. Se o banco não existe ainda, ele é criado pela operação `open`, então o evento `onupgradeneeded` é chamado e você cria o schema do banco nesse evento. Se o banco existe mas você está fornecendo um novo número de versão, o evento `onupgradeneeded` é chamado imediatamente, permitindo você tratar a atualização do schema. Para mais informações sobre isso veja [Updating the version of the database](#Updating_the_version_of_the_database). -> **Aviso:** O número de versão é um `unsigned long long`, o que significa que ele pode ver um inteiro muito grande. Isso também significa que você não pode usar float, pois ele será convertido em um inteiro pequeno e a transação pode não acontecer, ou o evento `upgradeneeded` pode não ser chamado. Então se você usar 2.4 como versão: +> [!WARNING] +> O número de versão é um `unsigned long long`, o que significa que ele pode ver um inteiro muito grande. Isso também significa que você não pode usar float, pois ele será convertido em um inteiro pequeno e a transação pode não acontecer, ou o evento `upgradeneeded` pode não ser chamado. Então se você usar 2.4 como versão: > > ```js > var request = indexedDB.open("DBteste", 2.4); // não faça isso, pois a versão será convertida para 2. @@ -344,7 +345,8 @@ db Viu como funciona? Desde que exista um objectStore, você pode evitar passar uma lista de objectStores que precisa na transação e passar apenas o nome como string. Você também pode ler do banco, apenas, então não precisará de uma transação `"readwrite"`. Chamando `transaction()` com nenhum modo especificado, você terá uma transação `"readonly"`. Outra consideração é que você não necessita salvar o request em uma variável. Desde que o evento DOM tenha o target que você precisará para obter a propriedade `result`. -> **Nota:** Você pode deixar o acesso aos dados mais rápido limitando o escopo e o modo de transação. Veja algumas dicas: +> [!NOTE] +> Você pode deixar o acesso aos dados mais rápido limitando o escopo e o modo de transação. Veja algumas dicas: > > - Quando definir o [escopo](#scope), especifique somente os objectStores que vai precisar. Assim você pode rodar multiplas transações sem sopreposições. > - Utilize uma transação `readwrite` somente quando necessário. Você pode rodar várias transações `readonly` simultâneas, mas apenas uma transação `readwrite` por objectStore. Para aprender mais sobre isso veja o artigo [_transactions_ in the Basic Concepts](/pt-BR/docs/IndexedDB/Basic_Concepts_Behind_IndexedDB#gloss_transaction). @@ -381,7 +383,8 @@ request.onsuccess = function (event) { Criamos uma `objectStore` e obtemos um cliente dele, identificado pelo ssn (`444-44-4444`). Nós atualizamos o objeto, passando-o como parâmetro de um método put de outro request (`requestUpdate`) sobrescrevendo o valor antigo. -> **Nota:** que neste caso nós temos que especificar a transação `readwrite` porque nós queremos escrever no banco, não somente ler os dados dele. +> [!NOTE] +> que neste caso nós temos que especificar a transação `readwrite` porque nós queremos escrever no banco, não somente ler os dados dele. ### Usando um cursor @@ -419,7 +422,8 @@ objectStore.openCursor().onsuccess = function (event) { }; ``` -> **Nota:** Note: Mozilla também implementou o método `getAll()` para ser usado nesse caso (e `getAllKeys()`, que está atualmente dentro da preferência do `dom.indexedDB.experimental` em about:config). Estes métodos não são parte do padrão IndexedDB, então eles podem desaparecer no futuro. Nós adicionamos porque achamos útil. O código abaixo faz o mesmo que o código acima: +> [!NOTE] +> Note: Mozilla também implementou o método `getAll()` para ser usado nesse caso (e `getAllKeys()`, que está atualmente dentro da preferência do `dom.indexedDB.experimental` em about:config). Estes métodos não são parte do padrão IndexedDB, então eles podem desaparecer no futuro. Nós adicionamos porque achamos útil. O código abaixo faz o mesmo que o código acima: > > ```js > objectStore.getAll().onsuccess = function (event) { diff --git a/files/pt-br/web/api/mutationobserver/index.md b/files/pt-br/web/api/mutationobserver/index.md index 23ee152bc64b2e..e81ac50c0806cf 100644 --- a/files/pt-br/web/api/mutationobserver/index.md +++ b/files/pt-br/web/api/mutationobserver/index.md @@ -49,7 +49,8 @@ void observe( - `options` - : Um objeto [`MutationObserverInit`](#MutationObserverInit) especifica quais mutações DOM devem ser reportadas. -> **Nota:** NOTA: Adicionar um observador para um elemento é como utilizar o addEventListener, se você observar o elemento várias vezes não faz diferença. Ou seja, se você observar um elemento duas vezes, o callback do observador não disparará duas vezes, nem você deverá executar duas vezes o disconnect(). Em outras palavras, uma vez que um elemento é observado, observá-lo novamento com a mesma instância do observador não fará nada. No entanto, se o objeto callback for diferente, ele, é claro, adicionará outro observador para isso. +> [!NOTE] +> NOTA: Adicionar um observador para um elemento é como utilizar o addEventListener, se você observar o elemento várias vezes não faz diferença. Ou seja, se você observar um elemento duas vezes, o callback do observador não disparará duas vezes, nem você deverá executar duas vezes o disconnect(). Em outras palavras, uma vez que um elemento é observado, observá-lo novamento com a mesma instância do observador não fará nada. No entanto, se o objeto callback for diferente, ele, é claro, adicionará outro observador para isso. ### `disconnect()` @@ -75,7 +76,8 @@ Retorna um Array de [`MutationRecord`s](#MutationRecord). `MutationObserverInit` é um objeto que pode especificar as seguintes propriedades: -> **Nota:** NOTA: No mínimo `childList`, `attributes`, ou `characterData` devem ser definidos como `true`. Caso contrário o erro "An invalid or illegal string was specified" é lançado. +> [!NOTE] +> NOTA: No mínimo `childList`, `attributes`, ou `characterData` devem ser definidos como `true`. Caso contrário o erro "An invalid or illegal string was specified" é lançado. | Property | Description | | ----------------------- | ----------------------------------------------------------------------------------------------------------------------------- | diff --git a/files/pt-br/web/api/navigator/geolocation/index.md b/files/pt-br/web/api/navigator/geolocation/index.md index 3a0e34fe357042..6f7337e217703a 100644 --- a/files/pt-br/web/api/navigator/geolocation/index.md +++ b/files/pt-br/web/api/navigator/geolocation/index.md @@ -7,7 +7,8 @@ slug: Web/API/Navigator/geolocation A propriedade de apenas leitura **`Navigator.geolocation`** retorna um objeto {{domxref("Geolocation")}} que disponibiliza acesso de conteúdo Web à localização do dispositivo. Isso permite que um Web site ou aplicativo ofereçam resultados customizados baseado na localização do usuário. -> **Nota:** Por questão de segurança, quando uma página web tenta acessar as informações de localização, o usuário é notificado e lhe é perguntado se este garante permissão. Esteja alerta que cada navegador possui suas próprias políticas e métodos para requisitar permissão. +> [!NOTE] +> Por questão de segurança, quando uma página web tenta acessar as informações de localização, o usuário é notificado e lhe é perguntado se este garante permissão. Esteja alerta que cada navegador possui suas próprias políticas e métodos para requisitar permissão. ## Sintaxe diff --git a/files/pt-br/web/api/node/clonenode/index.md b/files/pt-br/web/api/node/clonenode/index.md index 3d767f3f3cd637..82f18de3987962 100644 --- a/files/pt-br/web/api/node/clonenode/index.md +++ b/files/pt-br/web/api/node/clonenode/index.md @@ -20,7 +20,8 @@ var dupNode = node.cloneNode(deep); - _deep {{optional_inline}} \[1]_ - : true se os elementos filhos do nó que está sendo clonado devem ser clonados juntos, ou false para clonar apenas o nó específico dispensando, assim, qualquer elemento DOM filho. Veja os exemplos abaixo. -> **Nota:** Na especificação do DOM4 (implementado no Gecko 13.0), o argumento `deep` é opcional. Se omitido, por padrão, o método age como se o valor de deep fosse setado como true durante a sua execução. Para criação de clones superficiais, o argumento `deep` deve ser setado como `false`. +> [!NOTE] +> Na especificação do DOM4 (implementado no Gecko 13.0), o argumento `deep` é opcional. Se omitido, por padrão, o método age como se o valor de deep fosse setado como true durante a sua execução. Para criação de clones superficiais, o argumento `deep` deve ser setado como `false`. > > Este comportamento foi alterado na última especificação. Se omitido o argumento deep, o método irá interpretar o valor de deep como se fosse false. Embora ele continue opcional, é recomendado que você sempre observe o argumento deep para fins de compatibilidade anterior e posterior. Com o Gecko 28.0), foi advertido aos desenvolvedores para não omitirem o argumento. Iniciado com o Gecko 29.0), um clone superficial é o padrão ao invés de um clone aprofundado. diff --git a/files/pt-br/web/api/node/firstchild/index.md b/files/pt-br/web/api/node/firstchild/index.md index b8cb0e64fa6cac..793a3eccdcee0a 100644 --- a/files/pt-br/web/api/node/firstchild/index.md +++ b/files/pt-br/web/api/node/firstchild/index.md @@ -38,7 +38,8 @@ Este exemplo demonstra o uso do firstChild e como os espaços em branco "whitesp No exemplo acima, o console.log() deverá exibir '#text' porque o nó de texto inserido mantém espaços em branco 'whitespace' entre a tag \

e a tag \. Qualquer espaço em branco poderá causar '#text'. -> **Nota:** "Tabs" também podem causar esse comportamento. +> [!NOTE] +> "Tabs" também podem causar esse comportamento. Se os espaços em branco for removidos do código, o '#text' não será mais considerado e a tag \ se tornará o primeiro filho firstChild do parágrafo, conforme exemplo abaixo. diff --git a/files/pt-br/web/api/node/index.md b/files/pt-br/web/api/node/index.md index 76a0621757edcf..ba584efdf0f73f 100644 --- a/files/pt-br/web/api/node/index.md +++ b/files/pt-br/web/api/node/index.md @@ -71,13 +71,15 @@ _Herda propriedades de seus pais, {{domxref("EventTarget")}}_.\[1] - : Retorna um {{domxref("DOMString")}} representando a parte local do nome qualificado de um elemento. - > **Nota:** No Firefox 3.5 e nas versões anteriores, a propriedade coloca em caixa alta o nome local de elementos HTML (mas não elementos XHTML). Em versões posteriores, isso não acontece, então a propriedade está em caixa baixa para ambos HTML e XHTML. + > [!NOTE] + > No Firefox 3.5 e nas versões anteriores, a propriedade coloca em caixa alta o nome local de elementos HTML (mas não elementos XHTML). Em versões posteriores, isso não acontece, então a propriedade está em caixa baixa para ambos HTML e XHTML. - {{domxref("Node.namespaceURI")}}{{readonlyInline}} - : O espaço de nomes URI desse nó, ou `null` se não estiver no espaço de nomes. - > **Nota:** No Firefox 3.5 e nas versões anteriores, elementos HTML estão no espaço de nomes. Em versões posteriores, elementos HTML estão em [`https://www.w3.org/1999/xhtml/`](https://www.w3.org/1999/xhtml/), nas árvores HTML e XML. + > [!NOTE] + > No Firefox 3.5 e nas versões anteriores, elementos HTML estão no espaço de nomes. Em versões posteriores, elementos HTML estão em [`https://www.w3.org/1999/xhtml/`](https://www.w3.org/1999/xhtml/), nas árvores HTML e XML. - {{domxref("Node.prefix")}}{{readonlyInline}} - : É um {{domxref("DOMString")}} representando o espaço de nomes do nó, ou `null` se nenhum prefixo é especificado. diff --git a/files/pt-br/web/api/nodelist/index.md b/files/pt-br/web/api/nodelist/index.md index 2d4a078c1b8188..d299b4d14c7038 100644 --- a/files/pt-br/web/api/nodelist/index.md +++ b/files/pt-br/web/api/nodelist/index.md @@ -7,7 +7,8 @@ slug: Web/API/NodeList Objetos **`NodeList`** são coleções de nodos semelhantes aos objetos retornados pelos métodos {{domxref("Node.childNodes")}} e {{domxref("document.querySelectorAll()")}}. -> **Nota:** Apesar de `NodeList` não ser um `Array`, é possível ser iterada usando o método `forEach()`. Muitos navegadores antigos ainda não implementaram este método. +> [!NOTE] +> Apesar de `NodeList` não ser um `Array`, é possível ser iterada usando o método `forEach()`. Muitos navegadores antigos ainda não implementaram este método. Em alguns casos, `NodeList` é uma _coleção viva_, ou seja, toda alteração feita no {{ Glossary("DOM") }} reflete nos elementos da coleção. Por exemplo, {{ domxref("Node.childNodes") }} é uma coleção viva: diff --git a/files/pt-br/web/api/offlineaudiocontext/index.md b/files/pt-br/web/api/offlineaudiocontext/index.md index 691a6c139f428f..f5932b4613675b 100644 --- a/files/pt-br/web/api/offlineaudiocontext/index.md +++ b/files/pt-br/web/api/offlineaudiocontext/index.md @@ -43,7 +43,8 @@ Quando a 'promise' `startRendering()` é resolvida, a renderização foi conclu Neste ponto, criamos outro contexto de áudio, criamos um {{domxref("AudioBufferSourceNode")}} dentro dele e configuramos o buffer para ser igual à promessa `AudioBuffer`. Isso é jogado como parte de um gráfico de áudio padrão simples. -> **Nota:** Para um exemplo de trabalho, veja nosso [offline-audio-context-promise](https://mdn.github.io/webaudio-examples/offline-audio-context-promise/) Github repo (veja o [código fonte](https://github.com/mdn/webaudio-examples/tree/master/offline-audio-context-promise) também.) +> [!NOTE] +> Para um exemplo de trabalho, veja nosso [offline-audio-context-promise](https://mdn.github.io/webaudio-examples/offline-audio-context-promise/) Github repo (veja o [código fonte](https://github.com/mdn/webaudio-examples/tree/master/offline-audio-context-promise) também.) ```js // define o contexto de áudio online e offline diff --git a/files/pt-br/web/api/push_api/index.md b/files/pt-br/web/api/push_api/index.md index 92ca7426a0fa46..36f540282d6bd0 100644 --- a/files/pt-br/web/api/push_api/index.md +++ b/files/pt-br/web/api/push_api/index.md @@ -7,7 +7,8 @@ slug: Web/API/Push_API A **API Push** torna possível que aplicações web recebam mensagens enviadas a elas de um servidor, indepententemente de aplicação estar ou não em primeiro plano, ou até mesmo carregada, em um agente de usuário. Isso permite que desenvolvedores entreguem notificações e atualizações assíncronas a usuários que optarem por elas, resultando num melhor engajamento com conteúdo novo oportuno. -> **Nota:** Esta documentação cobre a especificação W3C da API Push; se você procura pela documentação do sistema de notificação proprietária do mecanismo push, veja [Simple Push](/pt-BR/docs/Web/API/Simple_Push_API). +> [!NOTE] +> Esta documentação cobre a especificação W3C da API Push; se você procura pela documentação do sistema de notificação proprietária do mecanismo push, veja [Simple Push](/pt-BR/docs/Web/API/Simple_Push_API). ## Conceitos e uso de Push @@ -21,9 +22,11 @@ Cada assinatura é única para um service worker. O endpoint para a assinatura A ativação de um service worker para entregar mensagens push pode resultar em um aumento de uso de recursos, particularmente de bateria. Diferentes navegadores tem diferentes formas para lidar com isso — atualmente não existe uma forma padrão. Firefox permite um número limitado (cota) de mensagens push para serem enviadas para uma aplicação, embora as mensagens Push que gerem notificações são isentas deste limite. O limite é atualizado a cada site visitado. Numa comparação, Chrome não aplica nenhum limite, mas requer que cada mensagem push exiba uma notificação. -> **Nota:** A partir do Gecko 44, a cota permitida de mensagens push por aplicação não é incrementada quando uma nova notificação é disparada quando outra está visível, por um período de três segundos. Isso lida com casos em que várias notificações são recebidas ao mesmo tempo, mas nem todas estão visíveis. +> [!NOTE] +> A partir do Gecko 44, a cota permitida de mensagens push por aplicação não é incrementada quando uma nova notificação é disparada quando outra está visível, por um período de três segundos. Isso lida com casos em que várias notificações são recebidas ao mesmo tempo, mas nem todas estão visíveis. -> **Nota:** Chrome atualmente requer que você crie um projeto no [Google Cloud Messaging](https://developers.google.com/cloud-messaging/) para enviar mensagens push e use um número do projeto e chave da API para o envio de notificações push. Isto também requer um _app manifest_ com alguns parâmetros especiais para usar o serviço. Essa restrição deverá ser removida no futuro. +> [!NOTE] +> Chrome atualmente requer que você crie um projeto no [Google Cloud Messaging](https://developers.google.com/cloud-messaging/) para enviar mensagens push e use um número do projeto e chave da API para o envio de notificações push. Isto também requer um _app manifest_ com alguns parâmetros especiais para usar o serviço. Essa restrição deverá ser removida no futuro. ## Interfaces diff --git a/files/pt-br/web/api/pushmanager/index.md b/files/pt-br/web/api/pushmanager/index.md index 0be2057df2e80c..2187cd905310e6 100644 --- a/files/pt-br/web/api/pushmanager/index.md +++ b/files/pt-br/web/api/pushmanager/index.md @@ -9,7 +9,8 @@ A `PushManager`interface da [API Push](/pt-BR/docs/Web/API/Push_API) fornece uma Essa interface é acessada através da propriedade {{domxref ("ServiceWorkerRegistration.pushManager")}}. -> **Nota:** : Esta interface substitui a funcionalidade anteriormente oferecida pela interface obsoleta {{domxref ("PushRegistrationManager")}}. +> [!NOTE] +> : Esta interface substitui a funcionalidade anteriormente oferecida pela interface obsoleta {{domxref ("PushRegistrationManager")}}. ## Propriedades diff --git a/files/pt-br/web/api/request/index.md b/files/pt-br/web/api/request/index.md index 0509354e6f5fad..4163a44bd5052d 100644 --- a/files/pt-br/web/api/request/index.md +++ b/files/pt-br/web/api/request/index.md @@ -64,7 +64,8 @@ Você pode criar um novo objeto `Request` usando o construtor {{domxref("Request - {{domxref("Body.text()")}} - : Retorna um objeto do tipo promise que resolve um {{domxref("USVString")}} (texto) com a representação do corpo da requisição. -> **Nota:** Os métodos de {{domxref("Body")}} só poderão ser executadas apenas uma vez; As chamadas subsequentes serão resolvidas com strings/ArrayBuffers vazias. +> [!NOTE] +> Os métodos de {{domxref("Body")}} só poderão ser executadas apenas uma vez; As chamadas subsequentes serão resolvidas com strings/ArrayBuffers vazias. ## Exemplos @@ -102,7 +103,8 @@ const myCred = myRequest.credentials; // omit const bodyUsed = myRequest.bodyUsed; // true ``` -> **Nota:** O tipo do corpo poderá ser apenas: {{domxref("Blob")}}, {{domxref("BufferSource")}}, {{domxref("FormData")}}, {{domxref("URLSearchParams")}}, {{domxref("USVString")}} ou {{domxref("ReadableStream")}}. Para adicionar um objeto JSON ao corpo, é necessário converter esse objeto para string. +> [!NOTE] +> O tipo do corpo poderá ser apenas: {{domxref("Blob")}}, {{domxref("BufferSource")}}, {{domxref("FormData")}}, {{domxref("URLSearchParams")}}, {{domxref("USVString")}} ou {{domxref("ReadableStream")}}. Para adicionar um objeto JSON ao corpo, é necessário converter esse objeto para string. Você poderá, então, solicitar uma nova requisição passando o objeto `Request` como parâmetro para a chamada {{domxref("GlobalFetch.fetch()")}}, por exemplo, e poderá capturar a resposta da seguinte forma: diff --git a/files/pt-br/web/api/request/request/index.md b/files/pt-br/web/api/request/request/index.md index 729e5f50a408e9..b730069a15a235 100644 --- a/files/pt-br/web/api/request/request/index.md +++ b/files/pt-br/web/api/request/request/index.md @@ -113,7 +113,8 @@ Você também pode passar um objeto {{domxref ("Request")}} para o construtor `R var copy = new Request(myRequest); ``` -> **Nota:** Este último uso é provavelmente útil apenas em [ServiceWorkers](/pt-BR/docs/Web/API/ServiceWorker_API). +> [!NOTE] +> Este último uso é provavelmente útil apenas em [ServiceWorkers](/pt-BR/docs/Web/API/ServiceWorker_API). ## Especificações diff --git a/files/pt-br/web/api/selection/index.md b/files/pt-br/web/api/selection/index.md index 3f4cecc342cd92..ddc7ee7160461d 100644 --- a/files/pt-br/web/api/selection/index.md +++ b/files/pt-br/web/api/selection/index.md @@ -101,7 +101,8 @@ A API de Seleção tem um comportamento comum (i.e. compartilhado entre navegado Os comportamentos são que um elemento editado recebe o foco se anteriormente a seleção estiver fora dele, então um método da API de seleção é executado e causa uma nova seleção que será feita em um único intervalo dentro do elemento sendo editado. O foco então é movido para o final do elemento. -> **Nota:** Os métodos da API de seleção, move o foco apenas para o elemento sendo editado, não para outro elemento que pode receber o foco (e.g. {{HTMLElement("a")}}). +> [!NOTE] +> Os métodos da API de seleção, move o foco apenas para o elemento sendo editado, não para outro elemento que pode receber o foco (e.g. {{HTMLElement("a")}}). O comportamento acima é aplicado para as seleções feitas usando os seguintes métodos: diff --git a/files/pt-br/web/api/server-sent_events/using_server-sent_events/index.md b/files/pt-br/web/api/server-sent_events/using_server-sent_events/index.md index 8d2ff15960dc04..7573e0306e15d8 100644 --- a/files/pt-br/web/api/server-sent_events/using_server-sent_events/index.md +++ b/files/pt-br/web/api/server-sent_events/using_server-sent_events/index.md @@ -51,7 +51,8 @@ evtSource.addEventListener("ping", (evento) => { Este código é semelhante, exceto que será chamado automaticamente sempre que o servidor enviar uma mensagem com o campo `event` definido como "ping"; ele então analisa o JSON no campo `data` e gera essa informação. -> **Aviso:** quando **não usado em HTTP/2**, o SSE sofre de uma limitação ao número máximo de conexões abertas, o que pode ser especialmente doloroso ao abrir várias guias, pois o limite é _por navegador_ e é definido para um número muito baixo (6). O problema foi marcado como "Não será corrigido" no [Chrome](https://bugs.chromium.org/p/chromium/issues/detail?id=275955) e no [Firefox](https://bugzilla.mozilla.org/show_bug.cgi?id=906896). Esse limite é por navegador + domínio, o que significa que você pode abrir 6 conexões SSE em todas as guias para `www.example1.com` e outras 6 conexões SSE para `www.example2.com` (por [Stackoverflow](https://stackoverflow.com/questions/5195452/websockets-vs-server-sent-events-eventsource/5326159)). Ao usar HTTP/2, o número máximo de _streams HTTP_ simultâneos é negociado entre o servidor e o cliente (o padrão é 100). +> [!WARNING] +> quando **não usado em HTTP/2**, o SSE sofre de uma limitação ao número máximo de conexões abertas, o que pode ser especialmente doloroso ao abrir várias guias, pois o limite é _por navegador_ e é definido para um número muito baixo (6). O problema foi marcado como "Não será corrigido" no [Chrome](https://bugs.chromium.org/p/chromium/issues/detail?id=275955) e no [Firefox](https://bugzilla.mozilla.org/show_bug.cgi?id=906896). Esse limite é por navegador + domínio, o que significa que você pode abrir 6 conexões SSE em todas as guias para `www.example1.com` e outras 6 conexões SSE para `www.example2.com` (por [Stackoverflow](https://stackoverflow.com/questions/5195452/websockets-vs-server-sent-events-eventsource/5326159)). Ao usar HTTP/2, o número máximo de _streams HTTP_ simultâneos é negociado entre o servidor e o cliente (o padrão é 100). ## Enviando eventos do servidor @@ -97,7 +98,8 @@ O código acima gera um evento a cada segundo, com o tipo de evento "ping". Os d O loop continuará funcionando independentemente do status da conexão, portanto, uma verificação é incluída para quebrar o loop se a conexão foi fechada (por exemplo, o cliente fecha a página). -> **Observação:** você pode encontrar um exemplo completo que usa o código mostrado neste artigo no GitHub — veja [Simple SSE demo using PHP]( /servidor-enviados-eventos). +> [!CALLOUT] +> você pode encontrar um exemplo completo que usa o código mostrado neste artigo no GitHub — veja [Simple SSE demo using PHP]( /servidor-enviados-eventos). ## Manipulação de erros @@ -121,7 +123,8 @@ evtSource.close(); O fluxo de eventos é um fluxo simples de dados de texto que deve ser codificado usando [UTF-8](/pt-BR/docs/Glossary/UTF-8). As mensagens no fluxo de eventos são separadas por um par de caracteres de nova linha. Dois pontos como o primeiro caractere de uma linha é essencialmente um comentário e é ignorado. -> **Nota:** A linha de comentário pode ser usada para evitar que as conexões atinjam o tempo limite; um servidor pode enviar um comentário periodicamente para manter a conexão ativa. +> [!NOTE] +> A linha de comentário pode ser usada para evitar que as conexões atinjam o tempo limite; um servidor pode enviar um comentário periodicamente para manter a conexão ativa. Cada mensagem consiste em uma ou mais linhas de texto listando os campos dessa mensagem. Cada campo é representado pelo nome do campo, seguido por dois pontos, seguido pelos dados de texto para o valor desse campo. @@ -140,7 +143,8 @@ Cada mensagem recebida tem alguma combinação dos seguintes campos, um por linh Todos os outros nomes de campo são ignorados. -> **Nota:** se uma linha não contiver dois pontos, a linha inteira será tratada como o nome do campo com uma string de valor vazia. +> [!NOTE] +> se uma linha não contiver dois pontos, a linha inteira será tratada como o nome do campo com uma string de valor vazia. ### Exemplos diff --git a/files/pt-br/web/api/service_worker_api/index.md b/files/pt-br/web/api/service_worker_api/index.md index e571aaf97d6275..09123a5777fcc8 100644 --- a/files/pt-br/web/api/service_worker_api/index.md +++ b/files/pt-br/web/api/service_worker_api/index.md @@ -15,9 +15,11 @@ Assim como outros tipos de _worker_, um _service worker_ é executado em um cont Por questões de segurança, _service workers_ funcionam apenas em sites servidos via HTTPS. A possibilidade de modificar requisições em um domínio desprotegido contra ataques do tipo [man-in-the-middle](/pt-BR/docs/Glossary/MitM) seria desastrosa. No Firefox, é vetado o acesso à API de _service workers_ para sites abertos no [Modo de navegação privativa](https://support.mozilla.org/pt-BR/kb/navegacao-privativa-use-firefox-sem-historico). -> **Nota:** Os service workers superaram tentativas anteriores de resolver problemas semelhantes, como o [AppCache](http://alistapart.com/article/application-cache-is-a-douchebag). Há uma explicação simples para eles terem sido bem-sucedidos: Service workers **não** tentam adivinhar o que você está tentando fazer e, muito menos, deixam de funcionar caso não tenham adivinhado corretamente. Pelo contrário, você tem o controle milimétrico de tudo. +> [!NOTE] +> Os service workers superaram tentativas anteriores de resolver problemas semelhantes, como o [AppCache](http://alistapart.com/article/application-cache-is-a-douchebag). Há uma explicação simples para eles terem sido bem-sucedidos: Service workers **não** tentam adivinhar o que você está tentando fazer e, muito menos, deixam de funcionar caso não tenham adivinhado corretamente. Pelo contrário, você tem o controle milimétrico de tudo. -> **Nota:** Service workers fazem uso intenso de [promessas](/pt-BR/docs/Web/JavaScript/Reference/Global_Objects/Promise), uma vez que eles têm de esperar por respostas assíncronas para, após retornadas, poderem executar a ação apropriada (de sucesso ou erro). A arquitetura de promessas é ideal para esse tipo de cenário. +> [!NOTE] +> Service workers fazem uso intenso de [promessas](/pt-BR/docs/Web/JavaScript/Reference/Global_Objects/Promise), uma vez que eles têm de esperar por respostas assíncronas para, após retornadas, poderem executar a ação apropriada (de sucesso ou erro). A arquitetura de promessas é ideal para esse tipo de cenário. ### Registrando diff --git a/files/pt-br/web/api/setinterval/index.md b/files/pt-br/web/api/setinterval/index.md index 828e72a4069a8d..074b70005bccee 100644 --- a/files/pt-br/web/api/setinterval/index.md +++ b/files/pt-br/web/api/setinterval/index.md @@ -25,7 +25,8 @@ var intervalID = scope.setInterval(code, delay); - `param1, ..., paramN` {{optional_inline}} - : Parâmetros adicionais que são passados através da função especificada pela _func_ quando o temporizador expirar. -> **Nota:** Passing additional parameters to `setInterval()` in the first syntax does not work in Internet Explorer 9 and earlier. If you want to enable this functionality on that browser, you must use a polyfill (see the [Callback arguments](#Callback_arguments) section). +> [!NOTE] +> Passing additional parameters to `setInterval()` in the first syntax does not work in Internet Explorer 9 and earlier. If you want to enable this functionality on that browser, you must use a polyfill (see the [Callback arguments](#Callback_arguments) section). ### Return value @@ -33,7 +34,8 @@ O `intervalID` retornado é um número, non-zero valor que identifica o temporiz Isso pode ser útil, estar ciente que o `setInterval()` e {{domxref("WindowOrWorkerGlobalScope.setTimeout", "setTimeout()")}} compartilham o mesmo grupo de IDs, e que o `clearInterval()` e {{domxref("WindowOrWorkerGlobalScope.clearTimeout", "clearTimeout()")}} podem tecnicamente serem usados em conjunto. Para deixar claro, contudo, você deve sempre tentar evitar combina-los, afim de evitar confusão na manutenção do seu código. -> **Nota:** The `delay` parameter is converted to a signed 32-bit integer. This effectively limits `delay` to 2147483647 ms, since it's specified as a signed integer in the IDL. +> [!NOTE] +> The `delay` parameter is converted to a signed 32-bit integer. This effectively limits `delay` to 2147483647 ms, since it's specified as a signed integer in the IDL. ## Exemplos @@ -489,7 +491,8 @@ window.setInterval = function ( }; ``` -> **Nota:** These two replacements also enable the HTML5 standard passage of arbitrary arguments to the callback functions of timers in IE. So they can be used as _non-standard-compliant_ polyfills also. See the [callback arguments paragraph](#Callback_arguments) for a _standard-compliant_ polyfill. +> [!NOTE] +> These two replacements also enable the HTML5 standard passage of arbitrary arguments to the callback functions of timers in IE. So they can be used as _non-standard-compliant_ polyfills also. See the [callback arguments paragraph](#Callback_arguments) for a _standard-compliant_ polyfill. Teste da nova implementação: @@ -507,13 +510,15 @@ setTimeout.call(myArray, myArray.myMethod, 2500, 2); // prints "two" after 2,5 s Outra, mais complexa, solução para o problema do `this` é [the following framework](#a_little_framework). -> **Nota:** JavaScript 1.8.5 introduces the [`Function.prototype.bind()`](/pt-BR/docs/Web/JavaScript/Reference/Global_Objects/Function/bind) method, which lets you specify the value that should be used as `this` for all calls to a given function. This lets you easily bypass problems where it's unclear what this will be, depending on the context from which your function was called. Also, ES2015 supports [arrow functions](/pt-BR/docs/Web/JavaScript/Reference/Functions/Arrow_functions), with lexical this allowing us to write setInterval( () => this.myMethod) if we're inside myArray method. +> [!NOTE] +> JavaScript 1.8.5 introduces the [`Function.prototype.bind()`](/pt-BR/docs/Web/JavaScript/Reference/Global_Objects/Function/bind) method, which lets you specify the value that should be used as `this` for all calls to a given function. This lets you easily bypass problems where it's unclear what this will be, depending on the context from which your function was called. Also, ES2015 supports [arrow functions](/pt-BR/docs/Web/JavaScript/Reference/Functions/Arrow_functions), with lexical this allowing us to write setInterval( () => this.myMethod) if we're inside myArray method. ## MiniDaemon - A framework for managing timers In pages requiring many timers, it can often be difficult to keep track of all of the running timer events. One approach to solving this problem is to store information about the state of a timer in an object. Following is a minimal example of such an abstraction. The constructor architecture explicitly avoids the use of closures. It also offers an alternative way to pass the [`this`](/pt-BR/docs/Web/JavaScript/Reference/Operators/this) object to the callback function (see [The "this" problem](#The_.22this.22_problem) for details). The following code is also [available on GitHub](https://github.com/madmurphy/minidaemon.js). -> **Nota:** For a more complex but still modular version of it (`Daemon`) see [JavaScript Daemons Management](/pt-BR/Add-ons/Code_snippets/Timers/Daemons). This more complex version is nothing but a big and scalable collection of methods for the `Daemon` constructor. However, the `Daemon` constructor itself is nothing but a clone of `MiniDaemon` with an added support for _init_ and _onstart_ functions declarable during the instantiation of the `daemon`. **So the `MiniDaemon` framework remains the recommended way for simple animations**, because `Daemon` without its collection of methods is essentially a clone of it. +> [!NOTE] +> For a more complex but still modular version of it (`Daemon`) see [JavaScript Daemons Management](/pt-BR/Add-ons/Code_snippets/Timers/Daemons). This more complex version is nothing but a big and scalable collection of methods for the `Daemon` constructor. However, the `Daemon` constructor itself is nothing but a clone of `MiniDaemon` with an added support for _init_ and _onstart_ functions declarable during the instantiation of the `daemon`. **So the `MiniDaemon` framework remains the recommended way for simple animations**, because `Daemon` without its collection of methods is essentially a clone of it. ### minidaemon.js @@ -610,7 +615,8 @@ MiniDaemon.prototype.start = function (bReverse) { }; ``` -> **Nota:** MiniDaemon passes arguments to the callback function. If you want to work on it with browsers that natively do not support this feature, use one of the methods proposed above. +> [!NOTE] +> MiniDaemon passes arguments to the callback function. If you want to work on it with browsers that natively do not support this feature, use one of the methods proposed above. ### Syntax diff --git a/files/pt-br/web/api/storage/clear/index.md b/files/pt-br/web/api/storage/clear/index.md index ce0e283cf50e72..9233509f592664 100644 --- a/files/pt-br/web/api/storage/clear/index.md +++ b/files/pt-br/web/api/storage/clear/index.md @@ -35,7 +35,8 @@ function populateStorage() { } ``` -> **Nota:** Para visualizar um exemplo real, veja nossa seção [Demonstração de Web Storage](https://github.com/mdn/web-storage-demo). +> [!NOTE] +> Para visualizar um exemplo real, veja nossa seção [Demonstração de Web Storage](https://github.com/mdn/web-storage-demo). ## Especificações diff --git a/files/pt-br/web/api/storage/getitem/index.md b/files/pt-br/web/api/storage/getitem/index.md index 9d7480450d8152..2509c215963331 100644 --- a/files/pt-br/web/api/storage/getitem/index.md +++ b/files/pt-br/web/api/storage/getitem/index.md @@ -42,7 +42,8 @@ function setStyles() { } ``` -> **Nota:** Para ver essa funcionalidade aplicada a um exemplo real, veja nossa [Web Storage Demo](https://github.com/mdn/web-storage-demo). +> [!NOTE] +> Para ver essa funcionalidade aplicada a um exemplo real, veja nossa [Web Storage Demo](https://github.com/mdn/web-storage-demo). ## Especificações diff --git a/files/pt-br/web/api/storage/index.md b/files/pt-br/web/api/storage/index.md index afa41268af0b2d..34d8d60256d1d0 100644 --- a/files/pt-br/web/api/storage/index.md +++ b/files/pt-br/web/api/storage/index.md @@ -61,7 +61,8 @@ function setStyles() { } ``` -> **Nota:** Para ver isso funcionando como um exemplo completo de trabalho, consulte nossa [Demonstração de armazenamento na Web](https://github.com/mdn/web-storage-demo). +> [!NOTE] +> Para ver isso funcionando como um exemplo completo de trabalho, consulte nossa [Demonstração de armazenamento na Web](https://github.com/mdn/web-storage-demo). ## Especificações diff --git a/files/pt-br/web/api/storage/key/index.md b/files/pt-br/web/api/storage/key/index.md index f7c629280ae55e..76dc1ccae6eb0b 100644 --- a/files/pt-br/web/api/storage/key/index.md +++ b/files/pt-br/web/api/storage/key/index.md @@ -42,7 +42,8 @@ for (var i = 0; i < localStorage.length; i++) { } ``` -> **Nota:** Pra ver um exemplo real, consulte nossa [Demonstração de armazenamento na Web](https://mdn.github.io/dom-examples/web-storage/). +> [!NOTE] +> Pra ver um exemplo real, consulte nossa [Demonstração de armazenamento na Web](https://mdn.github.io/dom-examples/web-storage/). ## Especificações diff --git a/files/pt-br/web/api/storage/length/index.md b/files/pt-br/web/api/storage/length/index.md index 9dfd735320554a..7335f707ed3215 100644 --- a/files/pt-br/web/api/storage/length/index.md +++ b/files/pt-br/web/api/storage/length/index.md @@ -31,7 +31,8 @@ function populateStorage() { } ``` -> **Nota:** Para um exemplo do mundo real, veja nosso [Web Storage Demo](https://github.com/mdn/web-storage-demo). +> [!NOTE] +> Para um exemplo do mundo real, veja nosso [Web Storage Demo](https://github.com/mdn/web-storage-demo). ## Especificações diff --git a/files/pt-br/web/api/storage/removeitem/index.md b/files/pt-br/web/api/storage/removeitem/index.md index 6fab87b6ac72e7..381114d2a4cf6b 100644 --- a/files/pt-br/web/api/storage/removeitem/index.md +++ b/files/pt-br/web/api/storage/removeitem/index.md @@ -36,7 +36,8 @@ function populateStorage() { } ``` -> **Nota:** Para ver o uso em um exemplo prático veja nosso [Web Storage Demo](https://github.com/mdn/web-storage-demo). +> [!NOTE] +> Para ver o uso em um exemplo prático veja nosso [Web Storage Demo](https://github.com/mdn/web-storage-demo). ## Especificações diff --git a/files/pt-br/web/api/storage/setitem/index.md b/files/pt-br/web/api/storage/setitem/index.md index eea4c594c1428e..92bf342c929d93 100644 --- a/files/pt-br/web/api/storage/setitem/index.md +++ b/files/pt-br/web/api/storage/setitem/index.md @@ -41,7 +41,8 @@ function populateStorage() { } ``` -> **Nota:** Para ver ele sendo usado em um exemplo real, consulte nosso [Web Storage Demo](https://github.com/mdn/web-storage-demo). +> [!NOTE] +> Para ver ele sendo usado em um exemplo real, consulte nosso [Web Storage Demo](https://github.com/mdn/web-storage-demo). ## Especificações diff --git a/files/pt-br/web/api/streams_api/concepts/index.md b/files/pt-br/web/api/streams_api/concepts/index.md index bc48a6025b492d..b3b3373a6628ac 100644 --- a/files/pt-br/web/api/streams_api/concepts/index.md +++ b/files/pt-br/web/api/streams_api/concepts/index.md @@ -73,7 +73,8 @@ Para iniciar um pipe chain é chamado o **original source**, e no final é chama ![](pipechain.png) -> **Nota:** Esta funcionalidade não está totalmente pensada ainda, embora disponível em muitos navegadores. Até certo ponto espero que a especificação dos writers pode contribuir para algo como uma clase `TransformStream` para criar facilmente transform stream. +> [!NOTE] +> Esta funcionalidade não está totalmente pensada ainda, embora disponível em muitos navegadores. Até certo ponto espero que a especificação dos writers pode contribuir para algo como uma clase `TransformStream` para criar facilmente transform stream. ## Backpressure @@ -102,6 +103,7 @@ high water mark - total size of chunks in queue = desired size O **desired size** é o tamanho de chunks que um stream ainda pode aceitar para manter o fluxo do stream menor que o high water mark. Após o cálculo ser efetuado, a geração de chunks terá sua velocidade reduzida ou aumentada conforme apropriado para manter o fluxo do stream o mais rápido possível enquanto mantém o tamanho desejado acima de zero. Se o valor cair para zero (ou menor no caso de writable streams), significa que os chunks estão sendo gerados mais rápido que o stream pode lidar, o qual resulta em problemas. -> **Nota:** O que ocorre no caso em que valor desejado for zero ou negativo não foi definido na especificação até o momento. Paciência é uma virtude. +> [!NOTE] +> O que ocorre no caso em que valor desejado for zero ou negativo não foi definido na especificação até o momento. Paciência é uma virtude. Como um exemplo, vamos pegar um chunk de tamanho 1, e uma high water mark de 3. Isto significa que até 3 chunks podem ser enfileirados antes que a high water mark seja alcançada e o backpressure aplicado. diff --git a/files/pt-br/web/api/streams_api/index.md b/files/pt-br/web/api/streams_api/index.md index e85c656f8e2455..6ac8a2e266b009 100644 --- a/files/pt-br/web/api/streams_api/index.md +++ b/files/pt-br/web/api/streams_api/index.md @@ -23,7 +23,8 @@ Usos mais complicados envolvem a criação de seu próprio fluxo usando o contru Você também pode gravar dados em streams usando {{domxref("WritableStream")}}. -> **Nota:** Você pode encontrar muito mais detalhes sobre a teoria e prática de streams em nossos artigos — [Streams API concepts](/pt-BR/docs/Web/API/Streams_API/Concepts), [Using readable streams](/pt-BR/docs/Web/API/Streams_API/Using_readable_streams), e [Using writable streams](/pt-BR/docs/Web/API/Streams_API/Using_writable_streams). +> [!NOTE] +> Você pode encontrar muito mais detalhes sobre a teoria e prática de streams em nossos artigos — [Streams API concepts](/pt-BR/docs/Web/API/Streams_API/Concepts), [Using readable streams](/pt-BR/docs/Web/API/Streams_API/Using_readable_streams), e [Using writable streams](/pt-BR/docs/Web/API/Streams_API/Using_writable_streams). ## Stream interfaces diff --git a/files/pt-br/web/api/subtlecrypto/index.md b/files/pt-br/web/api/subtlecrypto/index.md index c9e89593a4d384..760d72ef64898e 100644 --- a/files/pt-br/web/api/subtlecrypto/index.md +++ b/files/pt-br/web/api/subtlecrypto/index.md @@ -7,7 +7,8 @@ slug: Web/API/SubtleCrypto A interface **`SubtleCrypto`** representa um conjunto de criptografias primitivas. E está disponível via propriedades {{domxref("Crypto.subtle")}} disponíveis em uma janela de contexto (via {{domxref("Window.crypto")}}). -> **Aviso:** Por especificação: "Desenvolvedores fazendo uso da interface SubtleCrypto devem estar cientes das preocupações associadas com o design e a implementação de vários algoritmos providos. Os algoritmos brutos são providos em ordem para permitir aos desenvolvedores uma felixibilidade máxima na implementação de uma variedade de protocolos e aplicações, cada um deve representar a composição e os parâmetros de segurança em uma maneira única que necessita do uso de algoritmos brutos." +> [!WARNING] +> Por especificação: "Desenvolvedores fazendo uso da interface SubtleCrypto devem estar cientes das preocupações associadas com o design e a implementação de vários algoritmos providos. Os algoritmos brutos são providos em ordem para permitir aos desenvolvedores uma felixibilidade máxima na implementação de uma variedade de protocolos e aplicações, cada um deve representar a composição e os parâmetros de segurança em uma maneira única que necessita do uso de algoritmos brutos." ## Propriedades diff --git a/files/pt-br/web/api/touch_events/index.md b/files/pt-br/web/api/touch_events/index.md index 5d3528673db47f..acf5fdd6e75d69 100644 --- a/files/pt-br/web/api/touch_events/index.md +++ b/files/pt-br/web/api/touch_events/index.md @@ -27,7 +27,8 @@ Com a finalidade de fornecer suporte de qualidade para interfaces baseadas em to Este exemplo acompanha múltiplos pontos de contato de cada vez, permitindo o usuário desenhe em um {{ HTMLElement("canvas") }} com mais de um dedo por vez. Ele só funcionará em um browser que tenha suporte a eventos de toque. -> **Nota:** O texto a seguir utiliza o termo "finger" quando descreve o contato com a superfície, mas poderia, é claro, ser também uma caneta ou outro método de contato. +> [!NOTE] +> O texto a seguir utiliza o termo "finger" quando descreve o contato com a superfície, mas poderia, é claro, ser também uma caneta ou outro método de contato. ### Crie um canvas diff --git a/files/pt-br/web/api/url/createobjecturl_static/index.md b/files/pt-br/web/api/url/createobjecturl_static/index.md index 6921456ed28a95..63513c97588aff 100644 --- a/files/pt-br/web/api/url/createobjecturl_static/index.md +++ b/files/pt-br/web/api/url/createobjecturl_static/index.md @@ -15,7 +15,8 @@ Para anular um objeto URL, execute o método {{domxref("URL.revokeObjectURL", "r {{AvailableInWorkers}} -> **Nota:** Esta funcionalidade não está disponível em [Service Workers](/pt-BR/docs/Web/API/Service_Worker_API) devido ao potencial de criar vazamento de memória +> [!NOTE] +> Esta funcionalidade não está disponível em [Service Workers](/pt-BR/docs/Web/API/Service_Worker_API) devido ao potencial de criar vazamento de memória ## Sintaxe @@ -48,7 +49,8 @@ Os navegadores vão limpar objetos URLs automaticamente quando o documento for d Em versões antigas da especificação Media Source, anexar stream a um elemento {{HTMLElement("video")}} é obrigatório criar um objeto URL para o {{domxref("MediaStream")}}. Isto não é mais necessário, e os navegadores estão removendo o suporte para isso. -> **Warning:** Se você ainda tem código com +> [!WARNING] +> Se você ainda tem código com > {{domxref("URL.createObjectURL", "createObjectURL()")}} para anexar streams em elementos > de media, você precisa atualizar seu código para {{domxref("HTMLMediaElement.srcObject","srcObject")}} to the `MediaStream` directly. diff --git a/files/pt-br/web/api/url/port/index.md b/files/pt-br/web/api/url/port/index.md index 457797f2aa21e1..b92a65f72c97b7 100644 --- a/files/pt-br/web/api/url/port/index.md +++ b/files/pt-br/web/api/url/port/index.md @@ -7,7 +7,8 @@ slug: Web/API/URL/port A propriedade **`port`** da interface {{domxref("URL")}} é uma {{domxref("USVString")}} contendo o número da porta da URL. -> **Observação:** se uma string de entrada passada para o construtor [`URL()`](/pt-BR/docs/Web/API/URL/URL) não contiver um número de porta explicitamente (por exemplo, `https://localhost`) ou contiver um número de porta que é o número de porta padrão correspondente à parte do protocolo da string de entrada (por exemplo, `https://localhost:443`), então no [`URL`](/pt-BR/docs/Web/API/URL) que o construtor retornar, o valor da propriedade port será a string vazia: `''`. +> [!CALLOUT] +> se uma string de entrada passada para o construtor [`URL()`](/pt-BR/docs/Web/API/URL/URL) não contiver um número de porta explicitamente (por exemplo, `https://localhost`) ou contiver um número de porta que é o número de porta padrão correspondente à parte do protocolo da string de entrada (por exemplo, `https://localhost:443`), então no [`URL`](/pt-BR/docs/Web/API/URL) que o construtor retornar, o valor da propriedade port será a string vazia: `''`. {{AvailableInWorkers}} diff --git a/files/pt-br/web/api/url/revokeobjecturl_static/index.md b/files/pt-br/web/api/url/revokeobjecturl_static/index.md index ac1bdc13fad02f..3782f1b85d2dd5 100644 --- a/files/pt-br/web/api/url/revokeobjecturl_static/index.md +++ b/files/pt-br/web/api/url/revokeobjecturl_static/index.md @@ -11,7 +11,8 @@ Execute este método quando terminar de utilizar um objeto URL para informar o b {{AvailableInWorkers}} -> **Observação:** Este método não esta disponível em service workers, devido a +> [!CALLOUT] +> Este método não esta disponível em service workers, devido a > questões com cliclo de vida da interface {{domxref("Blob")}} e potenciais vazamentos. ## Sintaxe diff --git a/files/pt-br/web/api/urlsearchparams/values/index.md b/files/pt-br/web/api/urlsearchparams/values/index.md index 1da8747d7e7fc3..a8119092e58432 100644 --- a/files/pt-br/web/api/urlsearchparams/values/index.md +++ b/files/pt-br/web/api/urlsearchparams/values/index.md @@ -7,7 +7,8 @@ slug: Web/API/URLSearchParams/values O m*étodo* **`URLSearchParams.values()`**retorna um {{jsxref("Iteration_protocols",'iterator')}} que permite passar por todos os valores do objeto. Os valores são objetos {{domxref("USVString")}}. -> **Nota:** Esse método está disponível no [Web Workers](/pt-BR/docs/Web/API/Web_Workers_API). +> [!NOTE] +> Esse método está disponível no [Web Workers](/pt-BR/docs/Web/API/Web_Workers_API). ## Sintaxe diff --git a/files/pt-br/web/api/web_animations_api/using_the_web_animations_api/index.md b/files/pt-br/web/api/web_animations_api/using_the_web_animations_api/index.md index cead868235a5a8..c000ec2d472795 100644 --- a/files/pt-br/web/api/web_animations_api/using_the_web_animations_api/index.md +++ b/files/pt-br/web/api/web_animations_api/using_the_web_animations_api/index.md @@ -91,7 +91,8 @@ Você pode notar algumas diferenças aqui comparando com os valores equivalentes - A propriedade `duration` está em milisegundos (`3000`, não `3s`). Assim como {{domxref("WindowTimers.setTimeout()")}} e {{domxref("Window.requestAnimationFrame()")}}, a Web Animations API somente aceita millisegundos. - A outra diferença é o uso de `iterations` no lugar de `iteration-count`. -> **Nota:** Existem algumas pequenas diferenças de terminologia entre o CSS Animations e o Web Animations. Por exemplo, Web Animations não usa a string `"infinite"`, e sim a keyword JavaScript `Infinity`. E no lugar de `timing-function`, usamos `easing`. Não estamos citando um valor de `easing` aqui pois, diferente das Animações CSS onde o valor padrão do [animation-timing-function](/pt-BR/docs/Web/CSS/animation-timing-function) é `ease`, na Web Animations API o padrão é `linear` — o que nós já queremos para a animação da Alice. +> [!NOTE] +> Existem algumas pequenas diferenças de terminologia entre o CSS Animations e o Web Animations. Por exemplo, Web Animations não usa a string `"infinite"`, e sim a keyword JavaScript `Infinity`. E no lugar de `timing-function`, usamos `easing`. Não estamos citando um valor de `easing` aqui pois, diferente das Animações CSS onde o valor padrão do [animation-timing-function](/pt-BR/docs/Web/CSS/animation-timing-function) é `ease`, na Web Animations API o padrão é `linear` — o que nós já queremos para a animação da Alice. #### Juntando as peças diff --git a/files/pt-br/web/api/web_audio_api/index.md b/files/pt-br/web/api/web_audio_api/index.md index 15a8280535db20..a0d4d6705a6926 100644 --- a/files/pt-br/web/api/web_audio_api/index.md +++ b/files/pt-br/web/api/web_audio_api/index.md @@ -29,7 +29,8 @@ O tempo é controlado com alta precisão e baixa latência, permitindo que os de A API de áudio da Web também nos permite controlar como o áudio é _espacializado_. Utilizando um sistema baseado em um _modelo de ouvinte-fonte_, permite o controle do _modelo panorâmico_ e trata da _atenuação induzida por distância_ induzida por uma fonte em movimento (ou ouvinte em movimento). -> **Observação:** você pode ler sobre a teoria da API de áudio da Web com muito mais detalhes em nosso artigo [Conceitos básicos por trás da API de áudio da Web](/pt-BR/docs/Web/API/Web_Audio_API/Basic_concepts_behind_Web_Audio_API) . +> [!CALLOUT] +> você pode ler sobre a teoria da API de áudio da Web com muito mais detalhes em nosso artigo [Conceitos básicos por trás da API de áudio da Web](/pt-BR/docs/Web/API/Web_Audio_API/Basic_concepts_behind_Web_Audio_API) . ## Público-alvo da API de áudio da Web diff --git a/files/pt-br/web/api/web_audio_api/simple_synth/index.md b/files/pt-br/web/api/web_audio_api/simple_synth/index.md index a5ba5946d3f72e..904d7589560a4c 100644 --- a/files/pt-br/web/api/web_audio_api/simple_synth/index.md +++ b/files/pt-br/web/api/web_audio_api/simple_synth/index.md @@ -390,7 +390,8 @@ O resultado é uma matriz, `noteFreq`, com um objeto para cada oitava. Cada obje Com esta tabela no lugar, podemos descobrir a frequência para uma dada nota em uma oitava particular relativamente fácil. Se queremos a frequência pra nota G# na primeira oitava, nós simplesmente usamos `noteFreq[1]["G#"]` e conseguimos o valor 51.9 como resultado. -> **Nota:** Os valores na tabela de exemplo acima foram arredondados para duas casas decimais. +> [!NOTE] +> Os valores na tabela de exemplo acima foram arredondados para duas casas decimais. ```js hidden if (!Object.entries) { diff --git a/files/pt-br/web/api/web_components/using_custom_elements/index.md b/files/pt-br/web/api/web_components/using_custom_elements/index.md index 52f1f295c9b9f8..a49e4d3815fe27 100644 --- a/files/pt-br/web/api/web_components/using_custom_elements/index.md +++ b/files/pt-br/web/api/web_components/using_custom_elements/index.md @@ -7,7 +7,8 @@ slug: Web/API/Web_components/Using_custom_elements Um dos principais recursos do padrão de Web Components é a capacidade de criar elementos personalizados que encapsulam sua funcionalidade em uma página HTML, em vez de ter que se contentar com um lote longo e aninhado de elementos que, juntos, fornecem um recurso de página personalizada. Este artigo apresenta o uso da API de Custom Elements. -> **Nota:** Custom elements são suportados por padrão no Firefox, Chrome e Edge (76). Opera e Safari até agora suportam apenas custom elements autônomos. +> [!NOTE] +> Custom elements são suportados por padrão no Firefox, Chrome e Edge (76). Opera e Safari até agora suportam apenas custom elements autônomos. ## Visão de alto nível @@ -125,7 +126,8 @@ Agora está disponível para uso em nossa página. Em nosso HTML, nós o usamos back of your card."> ``` -> **Nota:** Você pode ver o [código-fonte JavaScript completo](https://github.com/mdn/web-components-examples/blob/master/popup-info-box-web-component/main.js) aqui. +> [!NOTE] +> Você pode ver o [código-fonte JavaScript completo](https://github.com/mdn/web-components-examples/blob/master/popup-info-box-web-component/main.js) aqui. ### Estilos internos vs. externos @@ -184,7 +186,8 @@ Usar o elemento integrado em um documento da web também parece um pouco diferen Você usa um elemento `