Skip to content

Commit 3ed547a

Browse files
authored
Merge pull request #201 from kellydosocorro/docs/translates-introduction
Translates src/guide/migration/introduction
2 parents 4a1be34 + 1491d24 commit 3ed547a

File tree

1 file changed

+83
-83
lines changed

1 file changed

+83
-83
lines changed

src/guide/migration/introduction.md

Lines changed: 83 additions & 83 deletions
Original file line numberDiff line numberDiff line change
@@ -1,132 +1,132 @@
1-
# Introduction
1+
# Introdução
22

33
::: info
4-
New to Vue.js? Check out our [Essentials Guide](/guide/introduction.html) to get started.
4+
Novo no Vue.js? Veja nosso [Guia Essencial](/guide/introduction.html) para começar.
55
:::
66

7-
This guide is primarily for users with prior Vue 2 experience who want to learn about the new features and changes in Vue 3. **This is not something you have to read from top to bottom before trying out Vue 3.** While it looks like a lot has changed, a lot of what you know and love about Vue is still the same; but we wanted to be as thorough as possible and provide detailed explanations and examples for every documented change.
7+
Este guia é sobretudo para usuários com experiência prévia em Vue 2 que desejam aprender sobre os novos recursos e mudanças do Vue 3. **Este não é um artigo que você precise ler do começo ao fim antes de experimentar o Vue 3.** Embora pareça que muita coisa mudou, muito do que você conhece e ama no Vue ainda é o mesmo; mas queríamos ser tão minuciosos quanto possível fornecendo explicações detalhadas e exemplos para cada alteração documentada.
88

9-
- [Quickstart](#quickstart)
10-
- [Notable New Features](#notable-new-features)
11-
- [Breaking Changes](#breaking-changes)
12-
- [Supporting Libraries](#supporting-libraries)
9+
- [Início rápido](#inicio-rapido)
10+
- [Principais recursos novos](#principais-recursos-novos)
11+
- [Incompatibilidades](#incompatibilidades)
12+
- [Bibliotecas suportadas](#bibliotecas-suportadas)
1313

14-
## Overview
14+
## Visão Geral
1515

1616
<br>
1717
<iframe src="https://player.vimeo.com/video/440868720" width="640" height="360" frameborder="0" allow="autoplay; fullscreen" allowfullscreen></iframe>
1818

19-
Start learning Vue 3 at [Vue Mastery](https://www.vuemastery.com/courses-path/vue3).
19+
Comece aprendendo Vue 3 com [Vue Mastery](https://www.vuemastery.com/courses-path/vue3).
2020

21-
## Quickstart
21+
## Início Rápido
2222

2323
- Via CDN: `<script src="https://unpkg.com/vue@next"></script>`
24-
- In-browser playground on [Codepen](https://codepen.io/yyx990803/pen/OJNoaZL)
25-
- In-browser Sandbox on [CodeSandbox](https://v3.vue.new)
26-
- Scaffold via [Vite](https://github.com/vitejs/vite):
24+
- Pelo navegador, via _playground_ em [Codepen](https://codepen.io/yyx990803/pen/OJNoaZL)
25+
- Pelo navegador, via Sandbox em [CodeSandbox](https://v3.vue.new)
26+
- Pré-estruturado, via [Vite](https://github.com/vitejs/vite):
2727

2828
```bash
29-
npm init vite-app hello-vue3 # OR yarn create vite-app hello-vue3
29+
npm init vite-app hello-vue3 # OU yarn create vite-app hello-vue3
3030
```
3131

32-
- Scaffold via [vue-cli](https://cli.vuejs.org/):
32+
- Pré-estruturado, via [vue-cli](https://cli.vuejs.org/):
3333

3434
```bash
35-
npm install -g @vue/cli # OR yarn global add @vue/cli
35+
npm install -g @vue/cli # OU yarn global add @vue/cli
3636
vue create hello-vue3
37-
# select vue 3 preset
37+
# selecione a predefinição vue 3
3838
```
3939

40-
## Notable New Features
40+
## Principais Recursos Novos
4141

42-
Some of the new features to keep an eye on in Vue 3 include:
42+
Alguns dos recursos novos para ficar de olho no Vue 3 incluem:
4343

44-
- [Composition API](/guide/composition-api-introduction.html)
45-
- [Teleport](/guide/teleport.html)
46-
- [Fragments](/guide/migration/fragments.html)
47-
- [Emits Component Option](/guide/component-custom-events.html)
48-
- [`createRenderer` API from `@vue/runtime-core`](https://github.com/vuejs/vue-next/tree/master/packages/runtime-core) to create custom renderers
49-
- [SFC Composition API Syntax Sugar (`<script setup>`)](https://github.com/vuejs/rfcs/blob/sfc-improvements/active-rfcs/0000-sfc-script-setup.md) <Badge text="experimental" type="warning" />
50-
- [SFC State-driven CSS Variables (`<style vars>`)](https://github.com/vuejs/rfcs/blob/sfc-improvements/active-rfcs/0000-sfc-style-variables.md) <Badge text="experimental" type="warning" />
51-
- [SFC `<style scoped>` can now include global rules or rules that target only slotted content](https://github.com/vuejs/rfcs/blob/master/active-rfcs/0023-scoped-styles-changes.md)
44+
- [API de Composição](/guide/composition-api-introduction.html)
45+
- [Teleporte](/guide/teleport.html)
46+
- [Fragmentos](/guide/migration/fragments.html)
47+
- [Opções para emitir eventos de componentes](/guide/component-custom-events.html)
48+
- [API `createRenderer` de `@vue/runtime-core`](https://github.com/vuejs/vue-next/tree/master/packages/runtime-core) para criar renderizações custumizadas
49+
- [Açúcar sintático para SFC que utilizem API de Composição (`<script setup>`)](https://github.com/vuejs/rfcs/blob/sfc-improvements/active-rfcs/0000-sfc-script-setup.md) <Badge text="experimental" type="warning" />
50+
- [Variáveis CSS baseadas em estado de SFC (`<style vars>`)](https://github.com/vuejs/rfcs/blob/sfc-improvements/active-rfcs/0000-sfc-style-variables.md) <Badge text="experimental" type="warning" />
51+
- [`<style scoped>` de SFC agora pode incluir regras globais ou regras que visam apenas conteúdo de _slot_](https://github.com/vuejs/rfcs/blob/master/active-rfcs/0023-scoped-styles-changes.md)
5252

53-
## Breaking Changes
53+
## Incompatibilidades
5454

55-
::: info INFO
56-
We are still working on a dedicated Migration Build of Vue 3 with Vue 2 compatible behavior and runtime warnings of incompatible usage. If you are planning to migrate a non-trivial Vue 2 app, we strongly recommend waiting for the Migration Build for a smoother experience.
55+
::: info
56+
Ainda estamos trabalhando em uma versão dedicada de migração do Vue 3 com comportamento compatível com o Vue 2 e avisos em tempo de execução de uso incompatível. Se você está planejando migrar um aplicativo Vue 2 mais complexo, é altamente recomendável aguardar a Distribuição de Migração para uma experiência mais tranquila.
5757
:::
5858

59-
The following consists a list of breaking changes from 2.x:
59+
A seguir, uma lista de mudanças incompatíveis com v2.x:
6060

61-
### Global API
61+
### API Global
6262

63-
- [Global Vue API is changed to use an application instance](/guide/migration/global-api.html)
64-
- [Global and internal APIs have been restructured to be tree-shakable](/guide/migration/global-api-treeshaking.html)
63+
- [API Global do Vue agora utiliza uma instância da aplicação](/guide/migration/global-api.html)
64+
- [API Global e internas foram reestruturadas para serem _tree-shakable_](/guide/migration/global-api-treeshaking.html)
6565

66-
### Template Directives
66+
### Diretivas de _Template_
6767

68-
- [`v-model` usage on components has been reworked](/guide/migration/v-model.html)
69-
- [`key` usage on `<template v-for>` and non-`v-for` nodes has changed](/guide/migration/key-attribute.html)
70-
- [`v-if` and `v-for` precedence when used on the same element has changed](/guide/migration/v-if-v-for.html)
71-
- [`v-bind="object"` is now order-sensitive](/guide/migration/v-bind.html)
72-
- [`ref` inside `v-for` no longer register an array of refs](/guide/migration/array-refs.html)
68+
- [O uso de `v-model` em componentes foi retrabalhado](/guide/migration/v-model.html)
69+
- [O atributo `key` em `<template v-for>` e nós que não sejam `v-for` foi alterado](/guide/migration/key-attribute.html)
70+
- [A precedência de `v-if` e `v-for` quando usados no mesmo elemento foi modificada](/guide/migration/v-if-v-for.html)
71+
- [`v-bind="object"` agora é sensível à ordem de disposição](/guide/migration/v-bind.html)
72+
- [`ref` em `v-for` não resulta mais em um array de refs](/guide/migration/array-refs.html)
7373

74-
### Components
74+
### Componentes
7575

76-
- [Functional components can only be created using a plain function](/guide/migration/functional-components.html)
77-
- [`functional` attribute on single-file component (SFC) `<template>` and `functional` component option are deprecated](/guide/migration/functional-components.html)
78-
- [Async components now require `defineAsyncComponent` method to be created](/guide/migration/async-components.html)
76+
- [Componentes funcionais só podem ser criados usando uma função simples](/guide/migration/functional-components.html)
77+
- [O atributo `functional` no `<template>` de Componentes Single File (CSF) e a opção de componente `functional` estão obsoletas](/guide/migration/functional-components.html)
78+
- [Componentes assíncronos necessitam de um método `defineAsyncComponent` para serem criados](/guide/migration/async-components.html)
7979

80-
### Render Function
80+
### Funções de Renderização
8181

82-
- [Render function API changed](/guide/migration/render-function-api.html)
83-
- [`$scopedSlots` property is removed and all slots are exposed via `$slots` as functions](/guide/migration/slots-unification.html)
82+
- [A API da função de renderização foi modificada](/guide/migration/render-function-api.html)
83+
- [A propriedade `$scopedSlots` foi removida e todos os seus _slots_ passam a ser obtidos como funções através de `$slots`](/guide/migration/slots-unification.html)
8484

85-
### Custom Elements
85+
### Elementos Personalizados
8686

87-
- [Custom elements whitelisting is now performed during template compilation](/guide/migration/custom-elements-interop.html)
88-
- [Special `is` prop usage is restricted to the reserved `<component>` tag only](/guide/migration/custom-elements-interop.html#customized-built-in-elements)
87+
- [A lista de permissões para elementos personalizados agora é realizada durante a compilação do _template_](/guide/migration/custom-elements-interop.html)
88+
- [A propriedade especial `is` está restrita apenas à _tag_ `<component>`](/guide/migration/custom-elements-interop.html#customized-built-in-elements)
8989

90-
### Other Minor Changes
90+
### Outras Mudanças Menores
9191

92-
- The `destroyed` lifecycle option has been renamed to `unmounted`
93-
- The `beforeDestroy` lifecycle option has been renamed to `beforeUnmount`
94-
- [Props `default` factory function no longer has access to `this` context](/guide/migration/props-default-this.html)
95-
- [Custom directive API changed to align with component lifecycle](/guide/migration/custom-directives.html)
96-
- [The `data` option should always be declared as a function](/guide/migration/data-option.html)
97-
- [The `data` option from mixins is now merged shallowly](/guide/migration/data-option.html#mixin-merge-behavior-change)
98-
- [Attributes coercion strategy changed](/guide/migration/attribute-coercion.html)
99-
- [Some transition classes got a rename](/guide/migration/transition.html)
100-
- [When watching an array, the callback will only trigger when the array is replaced. If you need to trigger on mutation, the `deep` option must be specified.](/guide/migration/watch.html)
101-
- `<template>` tags with no special directives (`v-if/else-if/else`, `v-for`, or `v-slot`) are now treated as plain elements and will result in a native `<template>` element instead of rendering its inner content.
102-
- In Vue 2.x, application root container's `outerHTML` is replaced with root component template (or eventually compiled to a template, if root component has no template/render option). Vue 3.x now uses application container's `innerHTML` instead - this means the container itself is no longer considered part of the template.
92+
- A opção de ciclo de vida `destroyed` foi renomeada para `unmounted`
93+
- A opção de ciclo de vida `beforeDestroy` foi renomeada para `beforeUnmount`
94+
- [A função fabricadora de props `default` não acessa mais o contexto `this`](/guide/migration/props-default-this.html)
95+
- [A API de diretivas customizadas foi modificada para se alinhar ao ciclo de vida do componente](/guide/migration/custom-directives.html)
96+
- [A opção `data` deverá sempre ser declarada como uma função](/guide/migration/data-option.html)
97+
- [A opção `data` dos _mixins_ agora é mesclada superficialmente](/guide/migration/data-option.html#mixin-merge-behavior-change)
98+
- [Estratégia de coerção de atributos foi alterada](/guide/migration/attribute-coercion.html)
99+
- [Algumas classes de transição foram renomeadas](/guide/migration/transition.html)
100+
- [O `callback` de um `array` que está sendo observado só será acionado quando este for substituído. Caso você precise dispará-lo em mutação, a opção `deep` deve ser especificada.](/guide/migration/watch.html)
101+
- As tags `<template>` sem diretivas especiais (`v-if/else-if/else`, `v-for`, ou `v-slot`) agora são tratadas como elementos simples resultando em um elemento `<template>` nativo ao invés de renderizar seu conteúdo interno.
102+
- No Vue 2.x, o contêiner raiz `outerHTML` da aplicação é substituído pelo _template_ do componente raiz (ou eventualmente compilado em um _template_, se o componente raiz não dispuser da opção _template_/_render_). Vue 3.x agora usa o contêiner `innerHTML` da aplicação ao invés disso - isto é, o próprio contêiner não é mais considerado parte do _template_.
103103

104-
### Removed APIs
104+
### APIs Removidas
105105

106-
- [`keyCode` support as `v-on` modifiers](/guide/migration/keycode-modifiers.html)
107-
- [$on, $off and \$once instance methods](/guide/migration/events-api.html)
108-
- [Filters](/guide/migration/filters.html)
109-
- [Inline templates attributes](/guide/migration/inline-template-attribute.html)
110-
- `$destroy` instance method. Users should no longer manually manage the lifecycle of individual Vue components.
106+
- [Suporte a `keyCode` como modificadores `v-on`](/guide/migration/keycode-modifiers.html)
107+
- [Métodos de instância $on, $off e \$once](/guide/migration/events-api.html)
108+
- [Filtros](/guide/migration/filters.html)
109+
- [Atributos _inline_ em _templates_](/guide/migration/inline-template-attribute.html)
110+
- Método de instância `$destroy`. Os usuários não devem mais acessar manualmente o ciclo de vida de componentes indiviuais Vue.
111111

112-
## Supporting Libraries
112+
## Bibliotecas Suportadas
113113

114-
All of our official libraries and tools now support Vue 3, but most of them are still in beta status and distributed under the `next` dist tag on npm. **We are planning to stabilize and switch all projects to use the `latest` dist tag by end of 2020.**
114+
Todas as nossas bibliotecas e ferramentas oficiais agora oferecem suporte ao Vue 3, mas, a maioria delas ainda está em _status_ beta e distribuídas sob a _tag_ `next` no NPM. **Estamos planejando estabilizar e mudar todos os projetos para usar a tag `latest` até o final de 2020.**
115115

116116
### Vue CLI
117117

118118
<a href="https://www.npmjs.com/package/@vue/cli" target="_blank" noopener noreferrer><img src="https://img.shields.io/npm/v/@vue/cli"></a>
119119

120-
As of v4.5.0, `vue-cli` now provides built-in option to choose Vue 3 preset when creating a new project. You can upgrade `vue-cli` and run `vue create` to create a Vue 3 project today.
120+
A partir da v4.5.0, `vue-cli` agora oferece opção integrada para escolher a pre-definição Vue 3 ao criar um novo projeto. Você pode atualizar o `vue-cli` e executar o `vue create` para criar um projeto Vue 3 hoje.
121121

122-
- [Documentation](https://cli.vuejs.org/)
122+
- [Documentação](https://cli.vuejs.org/)
123123
- [GitHub](https://github.com/vuejs/vue-cli)
124124

125125
### Vue Router
126126

127127
<a href="https://www.npmjs.com/package/vue-router/v/next" target="_blank" noopener noreferrer><img src="https://img.shields.io/npm/v/vue-router/next.svg"></a>
128128

129-
Vue Router 4.0 provides Vue 3 support and has a number of breaking changes of its own. Check out its [README](https://github.com/vuejs/vue-router-next#vue-router-next-) for full details.
129+
Vue Router 4.0 provê suporte ao Vue 3 e possui uma série de modificações incompatíveis próprias. Leia o [README](https://github.com/vuejs/vue-router-next#vue-router-next-) para verificar todos os detalhes.
130130

131131
- [GitHub](https://github.com/vuejs/vue-router-next)
132132
- [RFCs](https://github.com/vuejs/rfcs/pulls?q=is%3Apr+is%3Amerged+label%3Arouter)
@@ -135,27 +135,27 @@ Vue Router 4.0 provides Vue 3 support and has a number of breaking changes of it
135135

136136
<a href="https://www.npmjs.com/package/vuex/v/next" target="_blank" noopener noreferrer><img src="https://img.shields.io/npm/v/vuex/next.svg"></a>
137137

138-
Vuex 4.0 provides Vue 3 support with largely the same API as 3.x. The only breaking change is [how the plugin is installed](https://github.com/vuejs/vuex/tree/4.0#breaking-changes).
138+
Vuex 4.0 provê suporte ao Vue 3 com basicamente a mesma API que o 3.x. A única modificação incompatível é em [como o plugin é instalado](https://github.com/vuejs/vuex/tree/4.0#breaking-changes).
139139

140140
- [GitHub](https://github.com/vuejs/vuex/tree/4.0)
141141

142-
### Devtools Extension
142+
### Extensão para Desenvolvedores
143143

144-
We are working on a new version of the Devtools with a new UI and refactored internals to support multiple Vue versions. The new version is currently in beta and only supports Vue 3 (for now). Vuex and Router integration is also work in progress.
144+
Estamos trabalhando em uma nova versão do _Devtools_ com uma nova interface e refatoração interna para oferecer suporte a várias versões do Vue. A nova versão está atualmente em beta e suporta apenas Vue 3 (por enquanto). A integração do Vuex e do Router também está em andamento.
145145

146-
- For Chrome: [Install from Chrome web store](https://chrome.google.com/webstore/detail/vuejs-devtools/ljjemllljcmogpfapbkkighbhhppjdbg?hl=en)
146+
- Para navegador Chrome: [Instale da Chrome web store](https://chrome.google.com/webstore/detail/vuejs-devtools/ljjemllljcmogpfapbkkighbhhppjdbg?hl=en)
147147

148-
- Note: the beta channel may conflict with the stable version of devtools so you may need to temporarily disable the stable version for the beta channel to work properly.
148+
- Nota: o canal beta pode entrar em conflito com a versão estável do _devtools_, então pode ser necessário desabilitar temporariamente a versão estável para que a versão beta funcione corretamente.
149149

150-
- For Firefox: [Download the signed extension](https://github.com/vuejs/vue-devtools/releases/tag/v6.0.0-beta.2) (`.xpi` file under Assets)
150+
- Para navegador Firefox: [Baixe a extensão assinada](https://github.com/vuejs/vue-devtools/releases/tag/v6.0.0-beta.2) (Arquivo `.xpi` em Assets)
151151

152-
### IDE Support
152+
### Suporte de IDE
153153

154-
It is recommended to use [VSCode](https://code.visualstudio.com/) with our official extension [Vetur](https://marketplace.visualstudio.com/items?itemName=octref.vetur), which provides comprehensive IDE support for Vue 3.
154+
É recomendado o uso do [VSCode](https://code.visualstudio.com/) com a extensão oficial [Vetur](https://marketplace.visualstudio.com/items?itemName=octref.vetur), qual provê suporte à IDE para Vue 3.
155155

156-
### Other Projects
156+
### Outros Projetos
157157

158-
| Project | npm | Repo |
158+
| Projeto | NPM | Repositório |
159159
| --------------------- | ----------------------------- | -------------------- |
160160
| @vue/babel-plugin-jsx | [![rc][jsx-badge]][jsx-npm] | [[GitHub][jsx-code]] |
161161
| eslint-plugin-vue | [![ga][epv-badge]][epv-npm] | [[GitHub][epv-code]] |

0 commit comments

Comments
 (0)