From 7b580edd5ae3dc5ad77fec175953e8cb92aaad26 Mon Sep 17 00:00:00 2001 From: Cezar Augusto Date: Fri, 8 Feb 2019 22:23:21 -0200 Subject: [PATCH 01/14] translate SyntheticEvent --- content/docs/reference-events.md | 182 +++++++++++++++---------------- 1 file changed, 91 insertions(+), 91 deletions(-) diff --git a/content/docs/reference-events.md b/content/docs/reference-events.md index 745c6a71e..a8246a555 100644 --- a/content/docs/reference-events.md +++ b/content/docs/reference-events.md @@ -6,13 +6,13 @@ layout: docs category: Reference --- -This reference guide documents the `SyntheticEvent` wrapper that forms part of React's Event System. See the [Handling Events](/docs/handling-events.html) guide to learn more. +Este guia de referência documenta o agregador `SyntheticEvent` (evento sintético), que faz parte do sistema de eventos do React. Veja o guia [Manipulando Eventos (Handling Events)](/docs/handling-events.html) para saber mais. -## Overview {#overview} +## Visão geral {#visao-geral} -Your event handlers will be passed instances of `SyntheticEvent`, a cross-browser wrapper around the browser's native event. It has the same interface as the browser's native event, including `stopPropagation()` and `preventDefault()`, except the events work identically across all browsers. +Os manipuladores de evento (_event handlers_) serão passados como instâncias do `SyntheticEvent`, um agregador _cross-browser_ que envolve os eventos nativos do navegador. Ambos tem a mesma interface, incluindo `stopPropagation()` e `preventDefault()`, considerando que os eventos funcionem de forma idêntica entre os navegadores. -If you find that you need the underlying browser event for some reason, simply use the `nativeEvent` attribute to get it. Every `SyntheticEvent` object has the following attributes: +Caso você pense, por algum motivo, que precisa do evento original do navegador, basta utilizar o atributo `nativeEvent` para acessá-lo. Cada objeto do `SyntheticEvent` tem os seguintes atributos: ```javascript boolean bubbles @@ -31,19 +31,19 @@ number timeStamp string type ``` -> Note: +> Nota: > -> As of v0.14, returning `false` from an event handler will no longer stop event propagation. Instead, `e.stopPropagation()` or `e.preventDefault()` should be triggered manually, as appropriate. +> Começando pela v0.14, retornar `false` de um _event handler_ não irá mais parar a propagação de eventos. Sendo assim, tanto o `e.stopPropagation()` quanto o `e.preventDefault()` deve ser acionado manualmente, quando apropriado. -### Event Pooling {#event-pooling} +### Event Pooling (acumulador de eventos) {#event-pooling} -The `SyntheticEvent` is pooled. This means that the `SyntheticEvent` object will be reused and all properties will be nullified after the event callback has been invoked. -This is for performance reasons. -As such, you cannot access the event in an asynchronous way. +O `SyntheticEvent` é acumulado. Isso significa que o objeto `SyntheticEvent` será reutilizado e todas as suas propriedades serão anuladas após o evento de retorno (callback) ser acionado. +O motivo de ser do jeito que é, é uma questão de performance. +Sendo assim, você não pode acessar o evento de forma assíncrona. ```javascript function onClick(event) { - console.log(event); // => nullified object. + console.log(event); // => objeto anulado (nullified). console.log(event.type); // => "click" const eventType = event.type; // => "click" @@ -52,54 +52,54 @@ function onClick(event) { console.log(eventType); // => "click" }, 0); - // Won't work. this.state.clickEvent will only contain null values. + // Não funciona. this.state.clickEvent irá conter apenas valores nulos. this.setState({clickEvent: event}); - // You can still export event properties. + // Você ainda pode exportar as propriedades do evento. this.setState({eventType: event.type}); } ``` -> Note: +> Nota: > -> If you want to access the event properties in an asynchronous way, you should call `event.persist()` on the event, which will remove the synthetic event from the pool and allow references to the event to be retained by user code. - -## Supported Events {#supported-events} - -React normalizes events so that they have consistent properties across different browsers. - -The event handlers below are triggered by an event in the bubbling phase. To register an event handler for the capture phase, append `Capture` to the event name; for example, instead of using `onClick`, you would use `onClickCapture` to handle the click event in the capture phase. - -- [Clipboard Events](#clipboard-events) -- [Composition Events](#composition-events) -- [Keyboard Events](#keyboard-events) -- [Focus Events](#focus-events) -- [Form Events](#form-events) -- [Mouse Events](#mouse-events) -- [Pointer Events](#pointer-events) -- [Selection Events](#selection-events) -- [Touch Events](#touch-events) -- [UI Events](#ui-events) -- [Wheel Events](#wheel-events) -- [Media Events](#media-events) -- [Image Events](#image-events) -- [Animation Events](#animation-events) -- [Transition Events](#transition-events) -- [Other Events](#other-events) +> Se você deseja acessar as propriedades de um evento de forma assíncrona, você deve chamar o `event.persist()` no evento em questão, o que irá remover o evento sintético do acumulador e permitir referências ao evento a ser retido pelo código do usuário. + +## Eventos (Suporte) {#eventos-suporte} + +O React normaliza eventos para que se possa ter propriedades consistentes entre os navegadores. + +Os manipuladores de evento (_event handlers_) abaixo são acionados por um evento na fase de bolha (_bubbling_). Para registrar um manipulador de evento para a fase de captura, adicione `Capture` como sufixo do nome do evento. Por exemplo, ao invés de usar `onClick`, você usaria `onClickCapture` para manipular o evento de clique na fase de captura. + +- [Eventos do Clipboard](#eventos-do-clipboard) +- [Eventos de Composição (Composition)](#eventos-de-composicao) +- [Eventos do Teclado](#eventos-do-teclado) +- [Eventos de Foco](#eventos-de-foco) +- [Eventos de Formulário](#eventos-de-formulario) +- [Eventos do Mouse](#eventos-do-mouse) +- [Eventos do Ponteiro (Pointer)](#eventos-do-ponteiro) +- [Eventos de Seleção](#eventos-de-selecao) +- [Eventos de Toque (Touch)](#eventos-de-toque) +- [Eventos da Interface do Usuário (UI)](#eventos-de-ui) +- [Eventos de Rolagem (Wheel)](#eventos-de-rolagem) +- [Eventos de Mídia](#eventos-de-midia) +- [Eventos de Imagem](#eventos-de-imagem) +- [Eventos de Animação](#eventos-de-animacao) +- [Eventos de Transição](#eventos-de-transicao) +- [Outros Eventos](#outros-eventos) * * * -## Reference {#reference} +## Referência {#referencia} -### Clipboard Events {#clipboard-events} +### Eventos do Clipboard {#eventos-do-clipboard} -Event names: +Nome dos eventos: ``` onCopy onCut onPaste ``` -Properties: +Propriedades: ```javascript DOMDataTransfer clipboardData @@ -107,15 +107,15 @@ DOMDataTransfer clipboardData * * * -### Composition Events {#composition-events} +### Eventos de Composição (Composition) {#eventos-de-composicao} -Event names: +Nome dos eventos: ``` onCompositionEnd onCompositionStart onCompositionUpdate ``` -Properties: +Propriedades: ```javascript string data @@ -124,15 +124,15 @@ string data * * * -### Keyboard Events {#keyboard-events} +### Eventos do Teclado {#eventos-do-teclado} -Event names: +Nome dos eventos: ``` onKeyDown onKeyPress onKeyUp ``` -Properties: +Propriedades: ```javascript boolean altKey @@ -149,21 +149,21 @@ boolean shiftKey number which ``` -The `key` property can take any of the values documented in the [DOM Level 3 Events spec](https://www.w3.org/TR/uievents-key/#named-key-attribute-values). +A propriedade `key` pode conter quaisquer valores documentados na [especificação de eventos do DOM Level 3](https://www.w3.org/TR/uievents-key/#named-key-attribute-values). * * * -### Focus Events {#focus-events} +### Eventos de Foco {#eventos-de-foco} -Event names: +Nome dos eventos: ``` onFocus onBlur ``` -These focus events work on all elements in the React DOM, not just form elements. +Esses eventos de foco funcionam em todos os elementos do React DOM, não apenas em elementos de formulário. -Properties: +Propriedades: ```javascript DOMEventTarget relatedTarget @@ -171,21 +171,21 @@ DOMEventTarget relatedTarget * * * -### Form Events {#form-events} +### Eventos de Formulário {#eventos-de-formulario} -Event names: +Nome dos eventos: ``` onChange onInput onInvalid onSubmit ``` -For more information about the onChange event, see [Forms](/docs/forms.html). +Para mais informações sobre o evento onChange, veja [Formulários](/docs/forms.html). * * * -### Mouse Events {#mouse-events} +### Eventos do Mouse {#eventos-do-mouse} -Event names: +Nome dos eventos: ``` onClick onContextMenu onDoubleClick onDrag onDragEnd onDragEnter onDragExit @@ -193,9 +193,9 @@ onDragLeave onDragOver onDragStart onDrop onMouseDown onMouseEnter onMouseLeave onMouseMove onMouseOut onMouseOver onMouseUp ``` -The `onMouseEnter` and `onMouseLeave` events propagate from the element being left to the one being entered instead of ordinary bubbling and do not have a capture phase. +Os eventos `onMouseEnter` e `onMouseLeave` propagam do elemento do lado esquerdo ao evento que está entrando, ao invés do _bubbling_ comum e não tem uma fase de captura. -Properties: +Propriedades: ```javascript boolean altKey @@ -216,20 +216,20 @@ boolean shiftKey * * * -### Pointer Events {#pointer-events} +### Eventos do Ponteiro {#eventos-do-ponteiro} -Event names: +Nome dos eventos: ``` onPointerDown onPointerMove onPointerUp onPointerCancel onGotPointerCapture onLostPointerCapture onPointerEnter onPointerLeave onPointerOver onPointerOut ``` -The `onPointerEnter` and `onPointerLeave` events propagate from the element being left to the one being entered instead of ordinary bubbling and do not have a capture phase. +Os eventos `onPointerEnter` e `onPointerLeave` propagam do elemento do lado esquerdo ao evento que está entrando, ao invés do _bubbling_ comum e não tem uma fase de captura. -Properties: +Propriedades: -As defined in the [W3 spec](https://www.w3.org/TR/pointerevents/), pointer events extend [Mouse Events](#mouse-events) with the following properties: +Como definido na [espeficicação da W3](https://www.w3.org/TR/pointerevents/), os eventos de ponteiro estendem os [Eventos do Mouse](#eventos-do-mouse) com as seguintes propriedades: ```javascript number pointerId @@ -244,17 +244,17 @@ string pointerType boolean isPrimary ``` -A note on cross-browser support: +Uma nota em relação a compatiblidade entre navegadores: -Pointer events are not yet supported in every browser (at the time of writing this article, supported browsers include: Chrome, Firefox, Edge, and Internet Explorer). React deliberately does not polyfill support for other browsers because a standard-conform polyfill would significantly increase the bundle size of `react-dom`. +Os eventos de ponteiro ainda não tem suporte em todos os navegadores (no momento da escrita deste artigo, navegadores que oferecem suporte são: Chrome, Firefox, Edge e Internet Explorer). O React deliberadamente não fornece um polyfill para outros navegadores, pois um polyfill que seja compilante com os padrōes aumentaria drasticamente o tamanho do _bundle_ do `react-dom`. -If your application requires pointer events, we recommend adding a third party pointer event polyfill. +Se sua aplicação necessita de eventos de ponteiro, recomendamos adicionar um polyfill de terceiros. * * * -### Selection Events {#selection-events} +### Eventos de Seleção {#eventos-de-selecao} -Event names: +Nome dos eventos: ``` onSelect @@ -262,15 +262,15 @@ onSelect * * * -### Touch Events {#touch-events} +### Eventos de Toque (Touch) {#eventos-de-toque} -Event names: +Nome dos eventos: ``` onTouchCancel onTouchEnd onTouchMove onTouchStart ``` -Properties: +Propriedades: ```javascript boolean altKey @@ -285,15 +285,15 @@ DOMTouchList touches * * * -### UI Events {#ui-events} +### Eventos da Interface do Usuário (UI) {#eventos-de-ui} -Event names: +Nome dos eventos: ``` onScroll ``` -Properties: +Propriedades: ```javascript number detail @@ -302,15 +302,15 @@ DOMAbstractView view * * * -### Wheel Events {#wheel-events} +### Eventos de Rolagem (Wheel) {#eventos-de-rolagem} -Event names: +Nome dos eventos: ``` onWheel ``` -Properties: +Propriedades: ```javascript number deltaMode @@ -321,9 +321,9 @@ number deltaZ * * * -### Media Events {#media-events} +### Eventos de Mídia {#eventos-de-midia} -Event names: +Nome dos eventos: ``` onAbort onCanPlay onCanPlayThrough onDurationChange onEmptied onEncrypted @@ -334,9 +334,9 @@ onTimeUpdate onVolumeChange onWaiting * * * -### Image Events {#image-events} +### Eventos de Imagem {#eventos-de-imagem} -Event names: +Nome dos eventos: ``` onLoad onError @@ -344,15 +344,15 @@ onLoad onError * * * -### Animation Events {#animation-events} +### Eventos de Animação {#eventos-de-animacao} -Event names: +Nome dos eventos: ``` onAnimationStart onAnimationEnd onAnimationIteration ``` -Properties: +Propriedades: ```javascript string animationName @@ -362,15 +362,15 @@ float elapsedTime * * * -### Transition Events {#transition-events} +### Eventos de Transição {#eventos-de-transicao} -Event names: +Nome dos eventos: ``` onTransitionEnd ``` -Properties: +Propriedades: ```javascript string propertyName @@ -380,9 +380,9 @@ float elapsedTime * * * -### Other Events {#other-events} +### Outros Eventos {#outros-eventos} -Event names: +Nome dos eventos: ``` onToggle From d10769c0a76314adcd9597c9eab9459ecc175943 Mon Sep 17 00:00:00 2001 From: Halian Vilela Date: Sat, 9 Feb 2019 19:21:51 -0200 Subject: [PATCH 02/14] Update content/docs/reference-events.md Co-Authored-By: cezaraugusto --- content/docs/reference-events.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/reference-events.md b/content/docs/reference-events.md index a8246a555..52f9b0904 100644 --- a/content/docs/reference-events.md +++ b/content/docs/reference-events.md @@ -10,7 +10,7 @@ Este guia de referência documenta o agregador `SyntheticEvent` (evento sintéti ## Visão geral {#visao-geral} -Os manipuladores de evento (_event handlers_) serão passados como instâncias do `SyntheticEvent`, um agregador _cross-browser_ que envolve os eventos nativos do navegador. Ambos tem a mesma interface, incluindo `stopPropagation()` e `preventDefault()`, considerando que os eventos funcionem de forma idêntica entre os navegadores. +Os manipuladores de evento (_event handlers_) serão passados como instâncias do `SyntheticEvent`, um agregador _cross-browser_ que envolve os eventos nativos do navegador. Ambos tem a mesma interface, incluindo `stopPropagation()` e `preventDefault()`, porém funcionam de forma idêntica em todos os navegadores. Caso você pense, por algum motivo, que precisa do evento original do navegador, basta utilizar o atributo `nativeEvent` para acessá-lo. Cada objeto do `SyntheticEvent` tem os seguintes atributos: From 9aaabdb7eefe4ac8459b485a77f003ccc2b96eb0 Mon Sep 17 00:00:00 2001 From: Halian Vilela Date: Sat, 9 Feb 2019 19:22:38 -0200 Subject: [PATCH 03/14] Update content/docs/reference-events.md Co-Authored-By: cezaraugusto --- content/docs/reference-events.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/reference-events.md b/content/docs/reference-events.md index 52f9b0904..4b03e3cff 100644 --- a/content/docs/reference-events.md +++ b/content/docs/reference-events.md @@ -33,7 +33,7 @@ string type > Nota: > -> Começando pela v0.14, retornar `false` de um _event handler_ não irá mais parar a propagação de eventos. Sendo assim, tanto o `e.stopPropagation()` quanto o `e.preventDefault()` deve ser acionado manualmente, quando apropriado. +> A partir da v0.14, retornar `false` de um _event handler_ não irá mais parar a propagação de eventos. Sendo assim, tanto o `e.stopPropagation()` quanto o `e.preventDefault()` deve ser acionado manualmente, quando apropriado. ### Event Pooling (acumulador de eventos) {#event-pooling} From 2f3202bfab57951f9ff9f2761ad0ab1427247391 Mon Sep 17 00:00:00 2001 From: Halian Vilela Date: Sat, 9 Feb 2019 19:22:55 -0200 Subject: [PATCH 04/14] Update content/docs/reference-events.md Co-Authored-By: cezaraugusto --- content/docs/reference-events.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/reference-events.md b/content/docs/reference-events.md index 4b03e3cff..c62887a31 100644 --- a/content/docs/reference-events.md +++ b/content/docs/reference-events.md @@ -38,7 +38,7 @@ string type ### Event Pooling (acumulador de eventos) {#event-pooling} O `SyntheticEvent` é acumulado. Isso significa que o objeto `SyntheticEvent` será reutilizado e todas as suas propriedades serão anuladas após o evento de retorno (callback) ser acionado. -O motivo de ser do jeito que é, é uma questão de performance. +É assim por questões de performance. Sendo assim, você não pode acessar o evento de forma assíncrona. ```javascript From 5591aac3adaf005e63a06982aca9ff8c15155889 Mon Sep 17 00:00:00 2001 From: Halian Vilela Date: Sat, 9 Feb 2019 19:24:47 -0200 Subject: [PATCH 05/14] Update content/docs/reference-events.md Co-Authored-By: cezaraugusto --- content/docs/reference-events.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/reference-events.md b/content/docs/reference-events.md index c62887a31..afb739132 100644 --- a/content/docs/reference-events.md +++ b/content/docs/reference-events.md @@ -68,7 +68,7 @@ function onClick(event) { O React normaliza eventos para que se possa ter propriedades consistentes entre os navegadores. -Os manipuladores de evento (_event handlers_) abaixo são acionados por um evento na fase de bolha (_bubbling_). Para registrar um manipulador de evento para a fase de captura, adicione `Capture` como sufixo do nome do evento. Por exemplo, ao invés de usar `onClick`, você usaria `onClickCapture` para manipular o evento de clique na fase de captura. +Os manipuladores de evento (_event handlers_) abaixo são acionados por um evento na fase de propagação (_bubbling_). Para registrar um manipulador de evento para a fase de captura, adicione `Capture` como sufixo do nome do evento. Por exemplo, ao invés de usar `onClick`, você usaria `onClickCapture` para manipular o evento de clique na fase de captura. - [Eventos do Clipboard](#eventos-do-clipboard) - [Eventos de Composição (Composition)](#eventos-de-composicao) From 7379df5e96c1795ff3d864981812e6ed98227ce3 Mon Sep 17 00:00:00 2001 From: Halian Vilela Date: Sat, 9 Feb 2019 19:26:00 -0200 Subject: [PATCH 06/14] Update content/docs/reference-events.md Co-Authored-By: cezaraugusto --- content/docs/reference-events.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/reference-events.md b/content/docs/reference-events.md index afb739132..bfa8f656f 100644 --- a/content/docs/reference-events.md +++ b/content/docs/reference-events.md @@ -62,7 +62,7 @@ function onClick(event) { > Nota: > -> Se você deseja acessar as propriedades de um evento de forma assíncrona, você deve chamar o `event.persist()` no evento em questão, o que irá remover o evento sintético do acumulador e permitir referências ao evento a ser retido pelo código do usuário. +> Se você deseja acessar as propriedades de um evento de forma assíncrona, você deve chamar o `event.persist()` no evento em questão. Isso irá remover o evento sintético do acumulador e permitir referências ao evento serem retidas pelo código do usuário. ## Eventos (Suporte) {#eventos-suporte} From fe43f2725f8cbe90b1417a89188b743589f437d1 Mon Sep 17 00:00:00 2001 From: Cezar Augusto Date: Sat, 9 Feb 2019 19:35:15 -0200 Subject: [PATCH 07/14] do not translate anchors --- content/docs/reference-events.md | 72 ++++++++++++++++---------------- 1 file changed, 36 insertions(+), 36 deletions(-) diff --git a/content/docs/reference-events.md b/content/docs/reference-events.md index bfa8f656f..834257769 100644 --- a/content/docs/reference-events.md +++ b/content/docs/reference-events.md @@ -8,7 +8,7 @@ category: Reference Este guia de referência documenta o agregador `SyntheticEvent` (evento sintético), que faz parte do sistema de eventos do React. Veja o guia [Manipulando Eventos (Handling Events)](/docs/handling-events.html) para saber mais. -## Visão geral {#visao-geral} +## Visão geral {#overview} Os manipuladores de evento (_event handlers_) serão passados como instâncias do `SyntheticEvent`, um agregador _cross-browser_ que envolve os eventos nativos do navegador. Ambos tem a mesma interface, incluindo `stopPropagation()` e `preventDefault()`, porém funcionam de forma idêntica em todos os navegadores. @@ -64,34 +64,34 @@ function onClick(event) { > > Se você deseja acessar as propriedades de um evento de forma assíncrona, você deve chamar o `event.persist()` no evento em questão. Isso irá remover o evento sintético do acumulador e permitir referências ao evento serem retidas pelo código do usuário. -## Eventos (Suporte) {#eventos-suporte} +## Eventos (Suporte) {#supported-events} O React normaliza eventos para que se possa ter propriedades consistentes entre os navegadores. Os manipuladores de evento (_event handlers_) abaixo são acionados por um evento na fase de propagação (_bubbling_). Para registrar um manipulador de evento para a fase de captura, adicione `Capture` como sufixo do nome do evento. Por exemplo, ao invés de usar `onClick`, você usaria `onClickCapture` para manipular o evento de clique na fase de captura. -- [Eventos do Clipboard](#eventos-do-clipboard) -- [Eventos de Composição (Composition)](#eventos-de-composicao) -- [Eventos do Teclado](#eventos-do-teclado) -- [Eventos de Foco](#eventos-de-foco) -- [Eventos de Formulário](#eventos-de-formulario) -- [Eventos do Mouse](#eventos-do-mouse) -- [Eventos do Ponteiro (Pointer)](#eventos-do-ponteiro) -- [Eventos de Seleção](#eventos-de-selecao) -- [Eventos de Toque (Touch)](#eventos-de-toque) -- [Eventos da Interface do Usuário (UI)](#eventos-de-ui) -- [Eventos de Rolagem (Wheel)](#eventos-de-rolagem) -- [Eventos de Mídia](#eventos-de-midia) -- [Eventos de Imagem](#eventos-de-imagem) -- [Eventos de Animação](#eventos-de-animacao) -- [Eventos de Transição](#eventos-de-transicao) -- [Outros Eventos](#outros-eventos) +- [Eventos do Clipboard](#clipboard-events) +- [Eventos de Composição (Composition)](#composition-events) +- [Eventos do Teclado](#keyboard-events) +- [Eventos de Foco](#focus-events) +- [Eventos de Formulário](#form-events) +- [Eventos do Mouse](#mouse-events) +- [Eventos do Ponteiro (Pointer)](#pointer-events) +- [Eventos de Seleção](#selection-events) +- [Eventos de Toque (Touch)](#touch-events) +- [Eventos da Interface do Usuário (UI)](#ui-events) +- [Eventos de Rolagem (Wheel)](#wheel-events) +- [Eventos de Mídia](#media-events) +- [Eventos de Imagem](#image-events) +- [Eventos de Animação](#animation-events) +- [Eventos de Transição](#transition-events) +- [Outros Eventos](#other-eventos) * * * -## Referência {#referencia} +## Referência {#reference} -### Eventos do Clipboard {#eventos-do-clipboard} +### Eventos do Clipboard {#clipboard-events} Nome dos eventos: @@ -107,7 +107,7 @@ DOMDataTransfer clipboardData * * * -### Eventos de Composição (Composition) {#eventos-de-composicao} +### Eventos de Composição (Composition) {#composition-events} Nome dos eventos: @@ -124,7 +124,7 @@ string data * * * -### Eventos do Teclado {#eventos-do-teclado} +### Eventos do Teclado {#keyboard-events} Nome dos eventos: @@ -153,7 +153,7 @@ A propriedade `key` pode conter quaisquer valores documentados na [especificaç * * * -### Eventos de Foco {#eventos-de-foco} +### Eventos de Foco {#focus-events} Nome dos eventos: @@ -171,7 +171,7 @@ DOMEventTarget relatedTarget * * * -### Eventos de Formulário {#eventos-de-formulario} +### Eventos de Formulário {#form-events} Nome dos eventos: @@ -183,7 +183,7 @@ Para mais informações sobre o evento onChange, veja [Formulários](/docs/forms * * * -### Eventos do Mouse {#eventos-do-mouse} +### Eventos do Mouse {#mouse-events} Nome dos eventos: @@ -216,7 +216,7 @@ boolean shiftKey * * * -### Eventos do Ponteiro {#eventos-do-ponteiro} +### Eventos do Ponteiro {#pointer-events} Nome dos eventos: @@ -229,7 +229,7 @@ Os eventos `onPointerEnter` e `onPointerLeave` propagam do elemento do lado esqu Propriedades: -Como definido na [espeficicação da W3](https://www.w3.org/TR/pointerevents/), os eventos de ponteiro estendem os [Eventos do Mouse](#eventos-do-mouse) com as seguintes propriedades: +Como definido na [espeficicação da W3](https://www.w3.org/TR/pointerevents/), os eventos de ponteiro estendem os [Eventos do Mouse](#mouse-events) com as seguintes propriedades: ```javascript number pointerId @@ -252,7 +252,7 @@ Se sua aplicação necessita de eventos de ponteiro, recomendamos adicionar um p * * * -### Eventos de Seleção {#eventos-de-selecao} +### Eventos de Seleção {#selection-events} Nome dos eventos: @@ -262,7 +262,7 @@ onSelect * * * -### Eventos de Toque (Touch) {#eventos-de-toque} +### Eventos de Toque (Touch) {#touch-events} Nome dos eventos: @@ -285,7 +285,7 @@ DOMTouchList touches * * * -### Eventos da Interface do Usuário (UI) {#eventos-de-ui} +### Eventos da Interface do Usuário (UI) {#ui-events} Nome dos eventos: @@ -302,7 +302,7 @@ DOMAbstractView view * * * -### Eventos de Rolagem (Wheel) {#eventos-de-rolagem} +### Eventos de Rolagem (Wheel) {#wheel-events} Nome dos eventos: @@ -321,7 +321,7 @@ number deltaZ * * * -### Eventos de Mídia {#eventos-de-midia} +### Eventos de Mídia {#media-events} Nome dos eventos: @@ -334,7 +334,7 @@ onTimeUpdate onVolumeChange onWaiting * * * -### Eventos de Imagem {#eventos-de-imagem} +### Eventos de Imagem {#image-events} Nome dos eventos: @@ -344,7 +344,7 @@ onLoad onError * * * -### Eventos de Animação {#eventos-de-animacao} +### Eventos de Animação {#animation-events} Nome dos eventos: @@ -362,7 +362,7 @@ float elapsedTime * * * -### Eventos de Transição {#eventos-de-transicao} +### Eventos de Transição {#transicao-events} Nome dos eventos: @@ -380,7 +380,7 @@ float elapsedTime * * * -### Outros Eventos {#outros-eventos} +### Outros Eventos {#other-events} Nome dos eventos: From b980b376bb9d85ae1d29f12894c91a879f9d1585 Mon Sep 17 00:00:00 2001 From: Eric Pereira Date: Sun, 10 Feb 2019 23:07:26 -0200 Subject: [PATCH 08/14] Update content/docs/reference-events.md Co-Authored-By: cezaraugusto --- content/docs/reference-events.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/reference-events.md b/content/docs/reference-events.md index 834257769..c491001cf 100644 --- a/content/docs/reference-events.md +++ b/content/docs/reference-events.md @@ -362,7 +362,7 @@ float elapsedTime * * * -### Eventos de Transição {#transicao-events} +### Eventos de Transição {#transition-events} Nome dos eventos: From 2a6bf81402d73aaff4d9aa2775484152165fbdc3 Mon Sep 17 00:00:00 2001 From: Eric Pereira Date: Sun, 10 Feb 2019 23:07:33 -0200 Subject: [PATCH 09/14] Update content/docs/reference-events.md Co-Authored-By: cezaraugusto --- content/docs/reference-events.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/reference-events.md b/content/docs/reference-events.md index c491001cf..9166f72dc 100644 --- a/content/docs/reference-events.md +++ b/content/docs/reference-events.md @@ -229,7 +229,7 @@ Os eventos `onPointerEnter` e `onPointerLeave` propagam do elemento do lado esqu Propriedades: -Como definido na [espeficicação da W3](https://www.w3.org/TR/pointerevents/), os eventos de ponteiro estendem os [Eventos do Mouse](#mouse-events) com as seguintes propriedades: +Como definido na [especificação da W3](https://www.w3.org/TR/pointerevents/), os eventos de ponteiro estendem os [Eventos do Mouse](#mouse-events) com as seguintes propriedades: ```javascript number pointerId From 6e1a7618d8a844740a65ffc7cf6c19e8a8e16eae Mon Sep 17 00:00:00 2001 From: Eric Pereira Date: Sun, 10 Feb 2019 23:51:20 -0200 Subject: [PATCH 10/14] Update content/docs/reference-events.md Co-Authored-By: cezaraugusto --- content/docs/reference-events.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/reference-events.md b/content/docs/reference-events.md index 9166f72dc..51ba7162f 100644 --- a/content/docs/reference-events.md +++ b/content/docs/reference-events.md @@ -149,7 +149,7 @@ boolean shiftKey number which ``` -A propriedade `key` pode conter quaisquer valores documentados na [especificação de eventos do DOM Level 3](https://www.w3.org/TR/uievents-key/#named-key-attribute-values). +A propriedade `key` pode receber quaisquer valores documentados na [especificação de eventos do DOM Level 3](https://www.w3.org/TR/uievents-key/#named-key-attribute-values). * * * From 2bacc0e0db893420fa05c82f3466a0087c150906 Mon Sep 17 00:00:00 2001 From: Eric Pereira Date: Sun, 10 Feb 2019 23:51:28 -0200 Subject: [PATCH 11/14] Update content/docs/reference-events.md Co-Authored-By: cezaraugusto --- content/docs/reference-events.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/reference-events.md b/content/docs/reference-events.md index 51ba7162f..14ed696d3 100644 --- a/content/docs/reference-events.md +++ b/content/docs/reference-events.md @@ -66,7 +66,7 @@ function onClick(event) { ## Eventos (Suporte) {#supported-events} -O React normaliza eventos para que se possa ter propriedades consistentes entre os navegadores. +O React normaliza eventos para que eles possam ter propriedades consistentes entre os navegadores. Os manipuladores de evento (_event handlers_) abaixo são acionados por um evento na fase de propagação (_bubbling_). Para registrar um manipulador de evento para a fase de captura, adicione `Capture` como sufixo do nome do evento. Por exemplo, ao invés de usar `onClick`, você usaria `onClickCapture` para manipular o evento de clique na fase de captura. From d9a289b99da97d8851eea85130b9fb32ef37cea2 Mon Sep 17 00:00:00 2001 From: Eric Pereira Date: Sun, 10 Feb 2019 23:51:37 -0200 Subject: [PATCH 12/14] Update content/docs/reference-events.md Co-Authored-By: cezaraugusto --- content/docs/reference-events.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/reference-events.md b/content/docs/reference-events.md index 14ed696d3..d93eb9ce9 100644 --- a/content/docs/reference-events.md +++ b/content/docs/reference-events.md @@ -64,7 +64,7 @@ function onClick(event) { > > Se você deseja acessar as propriedades de um evento de forma assíncrona, você deve chamar o `event.persist()` no evento em questão. Isso irá remover o evento sintético do acumulador e permitir referências ao evento serem retidas pelo código do usuário. -## Eventos (Suporte) {#supported-events} +## Eventos Suportados {#supported-events} O React normaliza eventos para que eles possam ter propriedades consistentes entre os navegadores. From a99be8e8a5ec1ab8ccb94254a7bb5373a25aed7a Mon Sep 17 00:00:00 2001 From: Eric Pereira Date: Sun, 10 Feb 2019 23:51:53 -0200 Subject: [PATCH 13/14] Update content/docs/reference-events.md Co-Authored-By: cezaraugusto --- content/docs/reference-events.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/reference-events.md b/content/docs/reference-events.md index d93eb9ce9..7ec8552f1 100644 --- a/content/docs/reference-events.md +++ b/content/docs/reference-events.md @@ -6,7 +6,7 @@ layout: docs category: Reference --- -Este guia de referência documenta o agregador `SyntheticEvent` (evento sintético), que faz parte do sistema de eventos do React. Veja o guia [Manipulando Eventos (Handling Events)](/docs/handling-events.html) para saber mais. +Este guia de referência documenta o agregador `SyntheticEvent` (evento sintético), que faz parte do sistema de eventos do React. Veja o guia [Manipulando Eventos](/docs/handling-events.html) para saber mais. ## Visão geral {#overview} From 344751fcddf02d5700f138d85c29752b5a720426 Mon Sep 17 00:00:00 2001 From: Eric Pereira Date: Sun, 10 Feb 2019 23:52:00 -0200 Subject: [PATCH 14/14] Update content/docs/reference-events.md Co-Authored-By: cezaraugusto --- content/docs/reference-events.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/reference-events.md b/content/docs/reference-events.md index 7ec8552f1..76b330330 100644 --- a/content/docs/reference-events.md +++ b/content/docs/reference-events.md @@ -37,7 +37,7 @@ string type ### Event Pooling (acumulador de eventos) {#event-pooling} -O `SyntheticEvent` é acumulado. Isso significa que o objeto `SyntheticEvent` será reutilizado e todas as suas propriedades serão anuladas após o evento de retorno (callback) ser acionado. +O `SyntheticEvent` é acumulado. Isso significa que o objeto `SyntheticEvent` será reutilizado e todas as suas propriedades serão anuladas após o callback do evento ser acionado. É assim por questões de performance. Sendo assim, você não pode acessar o evento de forma assíncrona.