Skip to content

Commit a2a45b7

Browse files
authored
Review on guide/component-custom-events
1 parent f391590 commit a2a45b7

File tree

1 file changed

+18
-18
lines changed

1 file changed

+18
-18
lines changed

src/guide/component-custom-events.md

Lines changed: 18 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -1,29 +1,29 @@
1-
# Eventos Personalizados
1+
# Eventos Customizados
22

3-
> Esta página pressupõe que você já leu o [Básico sobre Componentes](component-basics.md). Leia isso antes se você está iniciando com componentes.
3+
> Esta página assume que você já leu o [Básico sobre Componentes](component-basics.md). Leia antes se você está iniciando com componentes.
44
55
## Nomes de Eventos
66

7-
Diferente de componentes e propriedades, os nomes de eventos não convertem automaticamente maiúsculas e minúsculas. Em vez disso, o nome de um evento emitido deve corresponder exatamente ao nome usado para ouvir este evento. Por exemplo, se emitir um evento com nome em camelCase:
7+
Diferente de componentes e propriedades, os nomes de eventos não convertem automaticamente maiúsculas e minúsculas. Em vez disso, o nome de um evento emitido deve corresponder exatamente ao nome usado para escutar este evento. Por exemplo, se emitir um evento com nome em camelCase:
88

99
```js
1010
this.$emit('myEvent')
1111
```
1212

13-
Ouvir com kebab-case não funcionará:
13+
Escutar com kebab-case não funcionará:
1414

1515
```html
1616
<!-- Não funcionará -->
1717
<my-component @my-event="doSomething"></my-component>
1818
```
1919

20-
Considerando que os nomes de eventos nunca serão usados como nomes de variáveis ou de propriedades no JavaScript, não há razão para usar camelCase ou PascalCase. Além disso, os ouvintes de eventos `v-on` dentro dos templates DOM serão automaticamente transformados em minúsculas (devido ao HTML ser insensível a maiúsculas e minúsculas), então `@myEvent` se tornará `@myevent` -- fazendo `myEvent` impossível de ser ouvido.
20+
Considerando que os nomes de eventos nunca serão usados como nomes de variáveis ou de propriedades no JavaScript, não há razão para usar camelCase ou PascalCase. Além disso, escutadores de eventos `v-on` dentro dos templates DOM serão automaticamente transformados em minúsculas (devido ao HTML ser insensível à maiúsculas e minúsculas), então `@myEvent` se tornará `@myevent` -- fazendo `myEvent` impossível de ser escutado.
2121

2222
Por estas razões, nós recomendamos que você **sempre use kebab-case para nomes de eventos**.
2323

24-
## Definindo Eventos Personalizados
24+
## Definindo Eventos Customizados
2525

26-
<VideoLesson href="https://vueschool.io/lessons/defining-custom-events-emits?friend=vuejs" title="Aprenda a definir quais eventos um componente pode emitir com a Vue School (em inglês)">Assista a um vídeo grátis sobre como definir Eventos Personalizados na Vue School (em inglês)</VideoLesson>
26+
<VideoLesson href="https://vueschool.io/lessons/defining-custom-events-emits?friend=vuejs" title="Aprenda à definir quais eventos um componente pode emitir com a Vue School (em inglês)">Assista um vídeo grátis sobre como definir Eventos Customizados na Vue School (em inglês)</VideoLesson>
2727

2828
Os eventos emitidos podem ser definidos no componente através da opção `emits`.
2929

@@ -33,7 +33,7 @@ app.component('custom-form', {
3333
})
3434
```
3535

36-
Quando um evento nativo (por exemplo, `click`) for definido na opção `emits`, o evento do componente será uaado __ao invés__ de um escutador de evento nativo.
36+
Quando um evento nativo (por exemplo, `click`) for definido na opção `emits`, o evento do componente será usado __ao invés__ de um escutador de evento nativo.
3737

3838
::: tip DICA
3939
Recomenda-se definir todos os eventos emitidos para documentar melhor como o componente deve funcionar.
@@ -56,7 +56,7 @@ app.component('custom-form', {
5656
if (email && password) {
5757
return true
5858
} else {
59-
console.warn('Invalid submit event payload!')
59+
console.warn('Argumentos inválidos para o evento submit!')
6060
return false
6161
}
6262
}
@@ -69,9 +69,9 @@ app.component('custom-form', {
6969
})
7070
```
7171

72-
## Argumentos `v-model`
72+
## Argumentos do `v-model`
7373

74-
Por padrão, em um componente `v-model` usa `modelValue` como propriedade e `update:modelValue` como evento. Podemos modificar esses nomes passando um argumento para `v-model`:
74+
Por padrão, em um componente o `v-model` usa `modelValue` como propriedade e `update:modelValue` como evento. Podemos modificar esses nomes passando um argumento para `v-model`:
7575

7676
```html
7777
<my-component v-model:title="bookTitle"></my-component>
@@ -99,11 +99,11 @@ app.component('my-component', {
9999
<my-component v-model:title="bookTitle"></my-component>
100100
```
101101

102-
## Vários vínculos `v-model`
102+
## Múltiplos Vínculos `v-model`
103103

104-
Aproveitando a capacidade de direcionar uma determinada propriedade e evento como aprendemos antes em [argumentos `v-model`](#argumentos-v-model), agora podemos criar vários vínculos de v-model em uma única instância do componente.
104+
Aproveitando a capacidade de direcionar uma determinada propriedade e evento como aprendemos antes em [argumentos do `v-model`](#argumentos-do-v-model), agora podemos criar múltiplos vínculos de `v-model` em uma única instância do componente.
105105

106-
Cada v-model será sincronizado com uma propriedade diferente, sem a necessidade de opções extras no componente:
106+
Cada `v-model` será sincronizado com uma propriedade diferente, sem a necessidade de opções extras no componente:
107107

108108
```html
109109
<user-name
@@ -141,15 +141,15 @@ app.component('user-name', {
141141
</p>
142142
<script async src="https://static.codepen.io/assets/embed/ei.js"></script>
143143

144-
## Manipulando modificadores `v-model`
144+
## Manipulando Modificadores do `v-model`
145145

146146
Quando estávamos aprendendo sobre interligações em elementos _input_, vimos que `v-model` tem [modificadores embutidos](/guide/forms.html#modifiers) - `.trim`, `.number` e `.lazy`. Em alguns casos, entretanto, você também pode querer adicionar seus próprios modificadores personalizados.
147147

148148
Vamos criar um modificador personalizado de exemplo, `capitalize`, que coloca em maiúscula a primeira letra da string fornecida pela vinculação `v-model`.
149149

150-
Modificadores adicionados a um componente `v-model` serão fornecidos ao componente por meio da propriedade `modelModifiers`. No exemplo abaixo, criamos um componente que contém uma propriedade `modelModifiers` cujo padrão é um objeto vazio.
150+
Modificadores adicionados ao `v-model` de um componente serão fornecidos ao componente por meio da propriedade `modelModifiers`. No exemplo abaixo, criamos um componente que contém uma propriedade `modelModifiers` cujo padrão é um objeto vazio.
151151

152-
Observe que quando o gancho do ciclo de vida `created` do componente é acionado, a propriedade `modelModifiers` contém `capitalize` e seu valor é `true` - devido ao fato de ser definido na vinculação `v-model.capitalize="bar"`.
152+
Observe que quando o gatilho do ciclo de vida `created` do componente é acionado, a propriedade `modelModifiers` contém `capitalize` e seu valor é `true` - devido ao fato de ser definido na vinculação `v-model.capitalize="bar"`.
153153

154154
```html
155155
<my-component v-model.capitalize="bar"></my-component>
@@ -217,7 +217,7 @@ app.component('my-component', {
217217
app.mount('#app')
218218
```
219219

220-
Para as ligações `v-model` com argumentos, o nome da propriedade gerada será `arg + "Modifiers"`:
220+
Para os vínculos `v-model` com argumentos, o nome da propriedade gerada será `arg + "Modifiers"`:
221221

222222
```html
223223
<my-component v-model:foo.capitalize="bar"></my-component>

0 commit comments

Comments
 (0)