You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README-pt-br.md
+9-9Lines changed: 9 additions & 9 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -10,7 +10,7 @@ O objetivo deste guia é apresentar um conjunto de boas práticas e diretrizes p
10
10
11
11
**Nota 1**: Este guia ainda é um rascunho, seu objetivo principal é ser construído pela comunidade, então ao contribuir você será muito apreciado por toda ela.
12
12
13
-
**Nota 2**: Antes de seguir qualquer das diretrizes nas traduções do documento original, verifique se a mesma está atualizada.
13
+
**Nota 2**: Antes de seguir qualquer das diretrizes nas traduções do documento original, verifique se a mesma está atualizada.
14
14
15
15
Neste guia você **não** irá encontrar diretrizes para desenvolvimento JavaScript. O que pode ser encontrado em:
16
16
@@ -44,7 +44,7 @@ Na wiki do AngularJS no Github tem uma seção similar feita pelo [ProLoser](htt
44
44
# Índice
45
45
*[Geral](#geral)
46
46
*[Estrutura de Diretório](#estrutura-de-diretorio)
47
-
*[Markup](#markup)
47
+
*[Markup](#markup)
48
48
*[Convenções de nomenclatura](#convencoes-de-nomenclatura)
49
49
*[Outros](#outros)
50
50
*[Módulos](#modulos)
@@ -64,7 +64,7 @@ Na wiki do AngularJS no Github tem uma seção similar feita pelo [ProLoser](htt
64
64
65
65
## Estrutura de Diretório
66
66
67
-
Uma vez que uma grande aplicação AngularJS tem muitos componentes, é melhor estruturá-la em uma hierarquia de diretórios.
67
+
Uma vez que uma grande aplicação AngularJS tem muitos componentes, é melhor estruturá-la em uma hierarquia de diretórios.
68
68
Há duas abordagens:
69
69
70
70
* Criando uma divisão alto nível por tipos de componentes e uma divisão baixo nível por funcionalidade.
*`$location` ao invés de `window.location` ou `$window.location`
270
+
*`$location` ao invés de `window.location` ou `$window.location`
271
271
*`$cookies` ao invés de `document.cookie`
272
272
273
273
Seus testes serão mais fáceis e em alguns casos irá prevenir comportamentos inesperados (por exemplo, se você perder `$scope.$apply` em `setTimeout`).
@@ -322,7 +322,7 @@ module.factory('Service', function ($rootScope, $timeout, MyCustomDependency1, M
322
322
# Controladores
323
323
324
324
*Não manipule DOM em seus controllers, isso fará com que os controllers sejam mais dificeis para testar e violará a [Separação de interesses](https://en.wikipedia.org/wiki/Separation_of_concerns). Use diretivas para isso.
325
-
*A nomenclatura do controller é dada pela sua funcionalidade (por exemplo *shopping cart*, *homepage*, *admin panel*) e o adicional `Ctrl` no final.
325
+
*A nomenclatura do controller é dada pela sua funcionalidade (por exemplo *shopping cart*, *homepage*, *admin panel*) e o adicional `Ctrl` no final.
326
326
* Controllers são javascript puros [construtores](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/constructor), serão nomeados através de UpperCamelCase (`HomePageCtrl`, `ShoppingCartCtrl`, `AdminPanelCtrl`, etc.).
327
327
* Os controladores não devem ser definidos como globais (embora o AngularJS permita isso, entretanto isso é uma má prática poluindo o namespace global).
328
328
* Use a sintaxe a seguir para definir controllers:
@@ -353,7 +353,7 @@ module.factory('Service', function ($rootScope, $timeout, MyCustomDependency1, M
353
353
* Evite usar o serviço `$scope` para definir funções e propriedades como parte dos controllers. Use`$scope` somente se necessário:
354
354
0. Para publicar e assinar eventos:`$scope.$emit`, `$scope.$broadcast`, e `$scope.$on`.
355
355
0. Para valores ou coleções _watch_:`$scope.$watch`, `$scope.$watchCollection`
356
-
356
+
357
357
* Prefira usar a sintaxe `controller as` e capture com `this` usando a variavel:
358
358
359
359
```html
@@ -415,7 +415,7 @@ module.factory('Service', function ($rootScope, $timeout, MyCustomDependency1, M
@@ -427,7 +427,7 @@ module.factory('Service', function ($rootScope, $timeout, MyCustomDependency1, M
427
427
428
428
Isso se aplica especialmente para um arquivo que tem muito código que você precisa percorrer. Isto, eventualmente, pode causar que você esqueça qual variável está ligada a qual dependência..
429
429
430
-
* Faça controllers mais simples possível. Funções abstratas comumente usadas em um serviço.
430
+
* Faça controllers mais simples possível. Funções abstratas comumente usadas em um serviço.
431
431
* Evite escrever lógica de negócio dentro dos controllers. Dê essa responsabilidade para o `model`, usando um serviço.
432
432
Por exemplo:
433
433
@@ -617,7 +617,7 @@ Esta seção inclui informações sobre o componentes de serviços no AngularJS.
617
617
totalPrice: total
618
618
};
619
619
});
620
-
```
620
+
```
621
621
Veja 'Evite escrever lógica de negócio dentro dos controllers' para um exemplo de um controlador consumindo o serviço.
622
622
* Serviços que representam o domínio de preferência um `service` em vez de um `factory`. Desta forma, podemos tirar proveito da herança "klassical" mais fácil:
0 commit comments