Skip to content

Commit acab5fe

Browse files
committed
Review on api/built-in-components
1 parent 5647d00 commit acab5fe

File tree

1 file changed

+24
-24
lines changed

1 file changed

+24
-24
lines changed

src/api/built-in-components.md

Lines changed: 24 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -36,8 +36,8 @@
3636
- `name` - `string` Usado para gerar automaticamente nomes de classes CSS de transições. Por exemplo, `name: 'fade'` expandirá automaticamente para `.fade-enter`, `.fade-enter-active`, etc.
3737
- `appear` - `boolean`, Se a transição deve ser aplicada na renderização inicial deverá ser configurado para `true`. Por padrão, `false`.
3838
- `persisted` - `boolean`. Se estiver `true`, indica que esta transição não insere/remove realmente o elemento, mas alterna o status entre mostrar/esconder. Os gatilhos de transição são injetados, mas serão ignorados pelo renderizador. Em vez disso, uma diretiva personalizada pode controlar a transição chamando os gatilhos injetados (por exemplo `v-show`).
39-
- `css` - `boolean`. Aplicar ou não classes de transição CSS. Por padrão é `true`. Se configurado para `false`, apenas acionará gatilhos registados de JavaScript por meio de eventos de componentes.
40-
- `type` - `string`. Especifica o tipo de eventos de transição a aguardar o tempo de término da transição. Os valores disponíveis são `"transition"` and `"animation"`. Por padrão, será detectado automaticamente o tipo que tenha uma duração mais longa.
39+
- `css` - `boolean`. Aplicar ou não classes de transição CSS. Por padrão é `true`. Se configurado para `false`, apenas acionará gatilhos registrados no JavaScript por meio de eventos de componentes.
40+
- `type` - `string`. Especifica o tipo de eventos de transição a serem aguardados para determinar o tempo de término da transição. Os valores disponíveis são `"transition"` and `"animation"`. Por padrão, será detectado automaticamente o tipo que tenha uma duração mais longa.
4141
- `mode` - `string`. Controla a sequência de temporização das transições de saída/entrada. Modos disponíveis são `"out-in"` e `"in-out"`; o padrão é simultâneo.
4242
- `duration` - `number | {`enter`: number,`leave`: number }`. Especifica a duração da transição. Por padrão, o Vue aguarda o primeiro evento de `transitionend` ou `animationend` no elemento de transição raiz.
4343
- `enter-from-class` - `string`
@@ -61,12 +61,12 @@
6161
- `after-leave`
6262
- `after-appear`
6363
- `enter-cancelled`
64-
- `leave-cancelled` (`v-show` apenas)
64+
- `leave-cancelled` (apenas `v-show`)
6565
- `appear-cancelled`
6666

6767
- **Uso:**
6868

69-
`<transition>` servem como efeitos de transição para elemento/componente **único**. O `<transition>` aplica apenas o comportamento de transição para o conteúdo dentro do *wrapper*; Ele não processa um elemento DOM extra ou aparece na hierarquia dos componentes inspecionados.
69+
`<transition>` servem como efeitos de transição para elemento/componente **único**. O `<transition>` aplica apenas o comportamento de transição para o conteúdo dentro do *wrapper*; Ele não renderiza um elemento DOM extra ou aparece na hierarquia dos componentes inspecionados.
7070

7171
```html
7272
<!-- elemento simples -->
@@ -101,14 +101,14 @@
101101
app.mount('#transition-demo')
102102
```
103103

104-
- **Ver também:** [Transições de entrada e saída](/guide/transitions-enterleave.html#transitioning-single-elements-components)
104+
- **Ver também:** [Transições de entrada e saída](/guide/transitions-enterleave.html#transicao-de-elementos-componentes-unicos)
105105

106106
## transition-group
107107

108108
- **Propriedades:**
109109

110-
- `tag` - `string`, padrão para `span`.
111-
- `move-class` - substituí a classe CSS aplicada durante a transição em movimento.
110+
- `tag` - `string`, `span` como padrão.
111+
- `move-class` - substitui a classe CSS aplicada durante a transição em movimento.
112112
- expõe as mesmas propriedades que `<transition>` exceto `mode`.
113113

114114
- **Eventos:**
@@ -121,7 +121,7 @@
121121

122122
Note que cada filho em um `<transition-group>` deve ser identificado com [**chave única**](./special-attributes.html#key) para as animações funcionarem corretamente.
123123

124-
`<transition-group>` suporta transições de movimento via transformações CSS. Quando a posição de um elemento filho na tela muda após uma actualização, ele aplicará uma classe de movimento CSS (gerada automaticamente a partir do atributo `name` ou configurada com o atributo `move-class` ). Se a propriedade CSS `transform` for passível de transição quando a classe de movimento é aplicada, o elemento será animado suavemente para o seu destino usando a [técnica FLIP](https://aerotwist.com/blog/flip-your-animations/).
124+
`<transition-group>` suporta transições de movimento via transformações CSS. Quando a posição de um elemento filho na tela muda após uma atualização, ele aplicará uma classe de movimento CSS (gerada automaticamente a partir do atributo `name` ou configurada com o atributo `move-class` ). Se a propriedade CSS `transform` for passível de transição quando a classe de movimento é aplicada, o elemento será animado suavemente para o seu destino usando a [técnica FLIP](https://aerotwist.com/blog/flip-your-animations/).
125125

126126
```html
127127
<transition-group tag="ul" name="slide">
@@ -137,15 +137,15 @@
137137

138138
- **Propriedades:**
139139

140-
- `include` - `string | RegExp | Array`. Apenas os componentes correspondentes serão colocados em cache.
141-
- `exclude` - `string | RegExp | Array`. Qualquer componente com o mesmo nome não será colocado em cache.
140+
- `include` - `string | RegExp | Array`. Apenas os componentes com nomes correspondentes serão colocados em cache.
141+
- `exclude` - `string | RegExp | Array`. Qualquer componente com o nome correspondente não será colocado em cache.
142142
- `max` - `number | string`. O número máximo de instâncias do componente a serem colocadas em cache.
143143

144144
- **Uso:**
145145

146-
Quando *wrapped* (enrolado) em torno de um componente dinâmico, `<keep-alive>` coloca as instâncias dos componentes inativos em cache sem os destruir. Semelhante a `<transition>`, `<keep-alive>` é um componente abstrato: ele não processa um elemento DOM em si, e não aparece na cadeia principal do componente.
146+
Quando *wrapped* (envolvido) em torno de um componente dinâmico, `<keep-alive>` coloca as instâncias dos componentes inativos em cache sem os destruir. Semelhante a `<transition>`, `<keep-alive>` é um componente abstrato: ele não renderiza um elemento DOM em si, e não aparece na cadeia pai do componente.
147147

148-
Quando um componente é alternado para dentro de `<keep-alive>`, em `activated` e `deactivated` os gatilhos de ciclo de vida serão invocados de acordo.
148+
Quando um componente é alternado dentro de `<keep-alive>`, seus gatilhos de ciclo de vida `activated` e` deactivated` serão invocados de acordo.
149149

150150
Usado principalmente para preservar o estado do componente ou evitar re-renderização.
151151

@@ -169,9 +169,9 @@
169169
</transition>
170170
```
171171

172-
Nota, `<keep-alive>` é projetado para o caso em que ele possui um componente filho direto que está sendo alternado. Isso não funciona se você tiver `v-for` dentro dele. Quando há múltiplos filhos condicionais, como acima, `<keep-alive>` exige que apenas um filho seja renderizado de cada vez.
172+
Note que, `<keep-alive>` é projetado para o caso em que ele possui um componente filho direto que está sendo alternado. Isso não funciona se você tiver `v-for` dentro dele. Quando há múltiplos filhos condicionais, como acima, `<keep-alive>` exige que apenas um filho seja renderizado de cada vez.
173173

174-
- **`include` and `exclude`**
174+
- **`include` e `exclude`**
175175

176176
As propriedades `include` e `exclude` permitem que os componentes sejam cacheados condicionalmente. Ambas as propriedades podem ser uma String separada por vígulas, uma RegExp ou um Array:
177177

@@ -192,7 +192,7 @@
192192
</keep-alive>
193193
```
194194

195-
A correspondência é verificada primeiro na opção `name` do componente, depois pelo nome no registro local (a chave dentro das opções do `components` pai) se a opção `name` não estiver disponível. Os componentes anônimos não poder ser comparados.
195+
A correspondência é verificada primeiro na opção `name` do componente, depois pelo nome no registro local (a chave dentro da opção `components` do pai) se a opção `name` não estiver disponível. Os componentes anônimos não poder ser comparados.
196196

197197
- **`max`**
198198

@@ -204,11 +204,11 @@
204204
</keep-alive>
205205
```
206206

207-
::: warning
207+
::: warning Aviso
208208
`<keep-alive>` não funciona com componentes funcionais porque eles não têm instâncias a serem guardadas em cache.
209209
:::
210210

211-
- **Ver também:** [Componentes dinâmicos - keep-alive](../guide/component-dynamic-async.html#dynamic-components-with-keep-alive)
211+
- **Ver também:** [Componentes dinâmicos - keep-alive](../guide/component-dynamic-async.html#componentes-dinamicos-com-keep-alive)
212212

213213
## slot
214214

@@ -218,30 +218,30 @@
218218

219219
- **Uso:**
220220

221-
`<slot>` servem como pontos de distribuição de conteúdo em modelos de componentes. O próprio `<slot>` será substituído.
221+
`<slot>` servem como pontos de distribuição de conteúdo em _templates_ de componentes. O `<slot>` em si será substituído.
222222

223-
For detailed usage, see the guide section no link em baixo.
223+
Para obter detalhes sobre o uso, consulte a seção do guia no link abaixo.
224224

225-
- **Ver também:** [Distribuição de Conteúdo com Slots](../guide/component-basics.html#content-distribution-with-slots)
225+
- **Ver também:** [Distribuição de Conteúdo com Slots](../guide/component-basics.html#distribuicao-de-conteudo-com-slots)
226226

227227
## teleport
228228

229229
- **Propriedades:**
230230

231-
- `to` - `string`. Propriedade obrigatória, tem que ser um seletor de consulta válido, ou um elemento de HTML (se usado em um ambiente de *browser*). Especifica um elemento de destino para onde o conteúdo de `<teleport>` será movido.
231+
- `to` - `string`. Propriedade obrigatória, tem que ser um seletor (*query*) válido, ou um elemento HTML (*HTMLElement*) (se usado no ambiente do navegador). Especifica um elemento de destino para onde o conteúdo de `<teleport>` será movido.
232232

233233
```html
234234
<!-- ok -->
235235
<teleport to="#some-id" />
236236
<teleport to=".some-class" />
237237
<teleport to="[data-teleport]" />
238238

239-
<!-- Wrong -->
239+
<!-- Errado -->
240240
<teleport to="h1" />
241241
<teleport to="some-string" />
242242
```
243243

244-
- `disabled` - `boolean`. Esta propriedade opcional pode ser usada para desativar a funcionalidade de `<teleport>`, o que significa que o conteúdo do slot não será movido para qualquer lugar, e em vez disso será renderizado onde você especificou o `<teleport>` no componente pai envolvente.
244+
- `disabled` - `boolean`. Esta propriedade opcional pode ser usada para desativar a funcionalidade de `<teleport>`, o que significa que o conteúdo do slot não será movido para qualquer lugar, e em vez disso será renderizado onde você especificou o `<teleport>` no componente pai que o envolve.
245245

246246
```html
247247
<teleport to="#popup" :disabled="displayVideoInline">
@@ -251,4 +251,4 @@
251251

252252
Observe que isso moverá os nós DOM reais em vez de serem destruídos e recriados e também manterá todas as instâncias do componente vivas. Todos os elementos HTML com estado (por exemplo, um vídeo em reprodução) manterão seu estado.
253253

254-
- **Ver também:** [Componente de teletransporte](../guide/teleport.html#teleport)
254+
- **Ver também:** [Componente de teletransporte](../guide/teleport.html#teleporte)

0 commit comments

Comments
 (0)