Angular - The good Patterns

Slide 1

Slide 1 text

Angularjs The Good Patterns

Slide 2

Slide 2 text

O que iremos ver?

Slide 3

Slide 3 text

• Evite a utilização de jQuery • http://youmightnotneedjquery.com/ • Atenção nos operadores js  !=, ===, == • Atenção nos erros do JSHint • promises para ﬂuxo de execução assíncrono. • princípio da responsabilidade única.

Slide 4

Slide 4 text

• Uma declaração por arquivo, facilita na manutenção, leitura, testes e para realizar mocs. • Deﬁna funções pequenas, que realizam poucas atividades, facilita em manter e no reaproveitamento. • Envolva seu código angular em uma IIFE, evitando variáveis globais.

Slide 5

Slide 5 text

Styleguides

Slide 6

Slide 6 text

No content

Slide 7

Slide 7 text

@John_Papa John Papa https://github.com/johnpapa/ @toddmotto Todd Motto https://github.com/toddmotto VS

Slide 8

Slide 8 text

angular.module() Módulos

Slide 9

Slide 9 text

O que são módulos? https://docs.angularjs.org/guide/module

Slide 10

Slide 10 text

• As deﬁnições de um módulo não devem reservar uma variável. • Divida sua aplicação em sub-módulos de módulos. • Use um nome único para os sub- módulos app.algumaCoisa • O módulo principal deve herdar outros sub-módulos. angular.module()

Slide 11

Slide 11 text

Let's do it!

Slide 12

Slide 12 text

EVITE

Slide 13

Slide 13 text

PREFIRA

Slide 14

Slide 14 text

PREFIRA

Slide 15

Slide 15 text

Controllers angular.controller()

Slide 16

Slide 16 text

O que são controllers? https://docs.angularjs.org/guide/controller

Slide 17

Slide 17 text

• Utilize a syntax controllerAs para realizar o bind da view com o controller, diretamente no $routeProvider. • Ao utilizar o controllerAs, você acessa o $scope do seu controller utilizando o this. • Guarde o contexto do controller utilizando vm. • Evite escrever lógica no controller, para isto utilize services e factories. angular.controller()

Slide 18

Slide 18 text

• Evite funções anônimas como callback. • Utilize menos angular e mais javascript. • Deﬁna um controller para uma view e tente não reusar o controller para outras views. • Deﬁna os nomes dos controllers em UpperCamelCase é convencional para objetos que podem ser instanciados usando um construtor. Ex.: new angular.controller()

Slide 19

Slide 19 text

• Utilize o suﬁxo MainController ou MainCtrl. • Exponha os elementos que recebem bind no início da declaração da função. • Deﬁna a função do método antes de instanciar o próprio método.   jslint: function was declared before used • Utilize on-time-binding sempre que possível. angular.controller()

Slide 20

Slide 20 text

• Utilize o suﬁxo MainController ou MainCtrl. • Evite manipulação de dados na view. angular.controller()

Slide 21

Slide 21 text

Let's do it!

Slide 22

Slide 22 text

EVITE

Slide 23

Slide 23 text

PREFIRA

Slide 24

Slide 24 text

PREFIRA

Slide 25

Slide 25 text

Services angular.service()

Slide 26

Slide 26 text

O que são services? https://docs.angularjs.org/guide/services

Slide 27

Slide 27 text

• Service é uma função construtora e será instanciada utilizando o new (por debaixo dos panos) • Exponha os métodos que são retornados pelo objeto do método no topo da declaração. • Utilize em operações que tenham persistência de informação.   Ex.: localStorage, angular.value() • Devem ser como classes, utilizando o this torna a função mais consistente. • É um tipo de serviço do angular. angular.service()

Slide 28

Slide 28 text

Let's do it!

Slide 29

Slide 29 text

EVITE

Slide 30

Slide 30 text

PREFIRA

Slide 31

Slide 31 text

Factory angular.factory()

Slide 32

Slide 32 text

O que são Factory? https://docs.angularjs.org/guide/services

Slide 33

Slide 33 text

• São singletons e retornam um objeto que contém os membros do serviço. • Utilize factory quando houver requisições XHR (por exemplo) • É um tipo de serviço do angular. • Guarda toda a lógica de negócios.   endpoints da api, manipulações no Banco. • Deverá retornar um objeto angular.factory()

Slide 34

Slide 34 text

• Exponha os métodos que são retornados pelo factory no topo da declaração. angular.factory()

Slide 35

Slide 35 text

Let's do it!

Slide 36

Slide 36 text

EVITE

Slide 37

Slide 37 text

PREFIRA

Slide 38

Slide 38 text

Directives angular.directive()

Slide 39

Slide 39 text

https://docs.angularjs.org/guide/directive O que são Diretivas?

Slide 40

Slide 40 text

• manipulações do DOM, deverão ser realizadas utilizando diretivas. • método link da diretiva é o responsável pelo código da manipulação. • O nome das diretivas devem ser em camelCase sendo a primeira letra minúscula. • Adicione um prefixo para as suas diretivas. • Evite diretivas como classes ou comentários. angular.directive()

Slide 41

Slide 41 text

• Utilize como atributo, caso seja manipulação de estilo. • Utilize como elemento, caso seja manipulação ou inserção do DOM. • Utilize a syntax controllerAs também nas diretivas. • Utilize bindToController = true quando utilizar controllerAs na diretiva. • Angular utiliza por default uma versão do jQuery mais resumida, chamada de jQlite, facilitando a manipulação. angular.directive()

Slide 42

Slide 42 text

Let's do it!

Slide 43

Slide 43 text

EVITE

Slide 44

Slide 44 text

PREFIRA

Slide 45

Slide 45 text

PREFIRA

Slide 46

Slide 46 text

Gerais vanilla js e angular

Slide 47

Slide 47 text

• Locating our code is easy • Identify code at a glance • Flat structure as long as we can • Try to stay DRY (Don’t Repeat Yourself) or T-DRY LIFT

Slide 48

Slide 48 text

• Envolva todo o seu código em uma IIFE, isto evita poluição no escopo global. • Mantenha o nome dos arquivos legíveis e consistentes, auxiliam na manutenção e na hora de achar alguma coisa em algum lugar. • Separe as pastas e arquivos por módulos. • ng-annotate é indicado para injeção das dependências e miniﬁcação. • Otimize o binding da view com o one- timing-biding. vanilla js e angular

Slide 49

Slide 49 text

• Resolva as dependências do controller utilizando o resolve do $routeProvider. • Crie ﬁltros globais: angular.filter(), nunca dentro de controllers ou services. • Para gerar documentação com comentário no código, utilize o ngDocs ou jsDoc. • Trabalhe com promises. • Trate erros relacionados a rotas com $routeChangeError vanilla js e angular

Slide 50

Slide 50 text

• Use convenções clara para nomenclatura dos arquivos.  feature.type.js (arquivos)  feature.type.spec.js (testes) • Gerencie todas as suas dependências de forma automatizadas (bower, npm). • Crie pequenos módulos que encapsulam uma responsabilidade • Mantenha o app.js limpo e claro, ele servirá como um "manifesto" contendo o que tem e o que não tem injetado na sua aplicação. vanilla js e angular

Slide 51

Slide 51 text

• Utilize a notação @ngInject para injetar de forma automática as dependências. (ponto negativo por ser um comentário) • Para injetar de forma manual, utilize o provider $inject. • Utilize ng-if ao invés de ng-show. • Utilize ngRepeat + track-by • Habilite patterns assíncronos com ngModelOptions. Ex.: debounce vanilla js e angular

Slide 52

Slide 52 text

• Não utilize ng-include em ng-repeat. (em loops de iteração) • Evite ﬁltrar/tratar dados no template. • Utilize $log ao invés de console. • $timeOut ao invés de setTimeOut. • $interval ao invés de setInterval. • Evite múltiplas declarações, no javascript cada declaração é uma operação. vanilla js e angular

Slide 53

Slide 53 text

• Apenas utilize $scope para delegar eventos. ($emit, $broadcast, $on) • Evite utilizar $scope.$watch, para ser mais performático utilize a diretiva ng-change. • Na injeção de dependências, adicione primeiro os providers do Angular, depois adicione os seus. vanilla js e angular