Skip to content

Commit 3a05e93

Browse files
committed
Review on guide/single-file-component
1 parent cb60dcc commit 3a05e93

File tree

1 file changed

+12
-12
lines changed

1 file changed

+12
-12
lines changed

src/guide/single-file-component.md

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -2,30 +2,30 @@
22

33
## Introdução
44

5-
Em muitos projetos Vue, os componentes globais serão definidos usando `app.component()`, seguido por `app.mount('#app')` para atingir um elemento _container_ no corpo de cada página.
5+
Em muitos projetos Vue, os componentes globais serão definidos usando `app.component()`, seguido por `app.mount('#app')` mirando em um elemento contêiner no corpo de cada página.
66

77
Isto pode funcionar bem em projetos pequenos e médios, onde o JavaScript só é utilizado para incrementar certas interfaces. No entanto, em projetos mais complexos ou quando o _frontend_ é totalmente orientado pelo JavaScript, tais desvantagens se tornam aparentes:
88

99
- **Definições globais** forçam nomes únicos para cada componente
10-
- **Templates com Strings** não têm _syntax highlighting_ e são difíceis de ler em múltiplas linhas
10+
- **Templates com Strings** não têm realce de sintaxe e são difíceis de ler em múltiplas linhas
1111
- **Sem suporte ao CSS** enquanto HTML e JavaScript são modularizados em componentes, CSS é notavelmente deixado de fora
12-
- **Sem processamento no build** ou seja, nos restringindo a HTML e JavaScript ES5, em vez de preprocessadores como Pug (anteriormente Jade) e Babel
12+
- **Sem processamento no build** ou seja, nos restringindo a HTML e JavaScript ES5, em vez de pré-processadores como Pug (anteriormente Jade) e Babel
1313

1414
Tudo isso é resolvido através dos **Componentes Single-File** com a extensão `.vue`, possibilitados graças a ferramentas de _build_ como Webpack ou Browserify.
1515

1616
Aqui está um exemplo de um arquivo que chamaremos de `Hello.vue`:
1717

18-
<a href="https://codepen.io/team/Vue/pen/3de13b5cd0133df4ecf307b6cf2c5f94" target="_blank" rel="noopener noreferrer"><img src="/images/sfc.png" width="403" alt="Single-file component example (click for code as text)" style="display: block; margin: 15px auto; max-width: 100%"></a>
18+
<a href="https://codepen.io/team/Vue/pen/3de13b5cd0133df4ecf307b6cf2c5f94" target="_blank" rel="noopener noreferrer"><img src="/images/sfc.png" width="403" alt="Exemplo de componente single-file (clique para ver o código em texto)" style="display: block; margin: 15px auto; max-width: 100%"></a>
1919

2020
Agora nós obtivemos:
2121

22-
- [_Syntax Highlighting_ completo](https://github.com/vuejs/awesome-vue#source-code-editing)
22+
- [Realce de sintaxe completo](https://github.com/vuejs/awesome-vue#source-code-editing)
2323
- [Módulos tipo CommonJS](https://webpack.js.org/concepts/modules/#what-is-a-webpack-module)
2424
- [Escopo de CSS por componente](https://vue-loader.vuejs.org/en/features/scoped-css.html)
2525

26-
Como prometido, podemos também utilizar pré-processadores como Pug (Jade), Babel (com módulos ES2015+) e Stylus para componentes mais limpos e mais ricos em recursos.
26+
Como prometido, também podemos utilizar pré-processadores como Pug (Jade), Babel (com módulos ES2015+) e Stylus para componentes mais limpos e mais ricos em recursos.
2727

28-
<a href="https://codesandbox.io/s/vue-single-file-component-with-pre-processors-mr3ik?file=/src/App.vue" target="_blank" rel="noopener noreferrer"><img src="/images/sfc-with-preprocessors.png" width="563" alt="Single-file component with pre-processors example (click for code as text)" style="display: block; margin: 15px auto; max-width: 100%"></a>
28+
<a href="https://codesandbox.io/s/vue-single-file-component-with-pre-processors-mr3ik?file=/src/App.vue" target="_blank" rel="noopener noreferrer"><img src="/images/sfc-with-preprocessors.png" width="563" alt="Exemplo de componente single-file com pré-processadores (clique para ver o código em texto)" style="display: block; margin: 15px auto; max-width: 100%"></a>
2929

3030
Estas linguagens específicas são meros exemplos. Poderíamos tão facilmente usar TypeScript, SCSS, PostCSS - ou qualquer outro que acreditarmos nos tornar mais produtivos. Se usar Webpack com `vue-loader`, também há suporte de primeira classe a CSS Modules.
3131

@@ -46,22 +46,22 @@ Se mesmo assim não gostar da ideia de Componentes _Single-File_, você ainda po
4646

4747
## Primeiros Passos
4848

49-
### Exemplo Sandbox
49+
### Sandbox de Exemplo
5050

5151
Se você quiser se mergulhar agora mesmo e começar a brincar com Componentes _Single-File_, dê uma olhada [neste aplicativo de lista de tarefas simples](https://codesandbox.io/s/vue-todo-list-app-with-single-file-component-vzkl3?file=/src/App.vue) no CodeSandbox.
5252

53-
### Para Iniciantes com Empacotadores
53+
### Para Iniciantes em Empacotadores JS
5454

5555
Com componentes `.vue`, estamos entrando no reino das aplicações JavaScript avançadas. Significa aprender a utilizar algumas ferramentas adicionais se ainda não teve oportunidade:
5656

57-
- **Node Package Manager (npm)**: Leia o guia de [Primeiros Passos](https://docs.npmjs.com/packages-and-modules/getting-packages-from-the-registry) do NPM na seção sobre como obter pacotes de registro.
57+
- **Node Package Manager (npm)**: Leia o guia de [Primeiros Passos](https://docs.npmjs.com/packages-and-modules/getting-packages-from-the-registry) do NPM na seção sobre como obter pacotes do registro.
5858

59-
- **JavaScript Moderno com ES2015+**: Leia o guia [Aprendendo ES2015](https://babeljs.io/docs/en/learn) do Babel. Não é necessário memorizar cada recurso agora, mas mantenha esta página como referência.
59+
- **JavaScript Moderno com ES2015/16**: Leia o guia [Aprendendo ES2015](https://babeljs.io/docs/en/learn) do Babel. Não é necessário memorizar cada recurso agora, mas mantenha esta página como referência.
6060

6161
Depois que tiver tirado um dia para mergulhar nestes tópicos, recomendamos dar uma olhada no [Vue CLI](https://cli.vuejs.org/). Seguindo as instruções, você terá em mãos um projeto Vue com componentes `.vue`, ES2015, Webpack e _hot-reloading_, rodando em pouquíssimo tempo!
6262

6363
### Para Usuários Avançados
6464

6565
A CLI cuida da maioria das configurações de ferramentas para você, mas também permite a personalização refinada através de suas próprias [opções de configuração](https://cli.vuejs.org/config/).
6666

67-
Caso você prefira configurar seu próprio _build_ a partir do zero, você precisará configurar manualmente o webpack com o [vue-loader](https://vue-loader.vuejs.org). Para saber mais sobre o webpack, confira os [documentos oficiais](https://webpack.js.org/configuration/) e a [Webpack Academy](https://webpack.academy/p/the-core-concepts).
67+
Caso você prefira configurar seu próprio _build_ a partir do zero, você precisará configurar manualmente o Webpack com o [vue-loader](https://vue-loader.vuejs.org). Para saber mais sobre o Webpack, confira os [documentos oficiais](https://webpack.js.org/configuration/) e a [Webpack Academy](https://webpack.academy/p/the-core-concepts).

0 commit comments

Comments
 (0)