Convenções de código / nomeação do Angularjs [fechadas]

162

Alguém sabe se existe alguma referência oficial ou mais aceita para que as convenções de nomenclatura angular sejam usadas ao criar nossos aplicativos?

O Angular possui muitos tipos diferentes de componentes, como filtros, diretivas, serviços e assim por diante. Você não concorda que ter uma convenção de nomenclatura de referência quando os implementarmos em nossos aplicativos fará sentido?

Por exemplo:

Se precisarmos criar novos filtros, como nomeá-los como [Algo] Filtrar ou filtrar [Algo] ou algo mais?

E o mesmo se aplica aos controladores, serviços, diretivas e assim por diante.

Outras coisas sobre as quais me pergunto é se variáveis ​​/ funções que pertencem ao escopo devem ter um prefixo ou sufixo especial. Em algumas situações, pode ser útil ter uma maneira de diferenciá-las de funções e outras (nenhum código angular).

Dalorzo
fonte
2
Eu encontrei este interessante post no Blog Angular chamado Recomendações de Boas Práticas para a Estrutura angular App
Edwin Dalorzo

Respostas:

45

Se você é iniciante, é melhor seguir primeiro alguns tutoriais básicos e depois aprender sobre as convenções de nomenclatura. Analisei o seguinte para aprender Angular, alguns dos quais são muito eficazes.

Tutoriais:

  1. http://www.toptal.com/angular-js/a-step-by-step-guide-to-your-first-angularjs-app
  2. http://viralpatel.net/blogs/angularjs-controller-tutorial/
  3. http://www.angularjstutorial.com/

Detalhes da estrutura do aplicativo e convenções de nomenclatura podem ser encontrados em vários locais. Passei por centenas de sites e acho que esses estão entre os melhores:

Rajendra Khabiya
fonte
33

Para estruturar um aplicativo, este é um dos melhores guias que eu encontrei:

Observe que a estrutura recomendada pelo Google é diferente da que você encontrará em muitos projetos de sementes, mas para aplicativos grandes é muito mais saudável.

O Google também possui um guia de estilo que faz sentido usar somente se você também usar o Closure .


... esta resposta está incompleta, mas espero que as informações limitadas acima sejam úteis para alguém.

Gil Birman
fonte
19

Atualização: o GUIA DE ESTILO está agora disponível na documentação do Angular.

//////////////////////////////////////////////////// //////////////////////////////////////////////////// //////////////////////////////////////////////////// //////

Se você está procurando um guia de estilo opinativo para sintaxe, convenções e estruturação de aplicativos AngularJS, entre diretamente. Os estilos aqui contidos são baseados na minha experiência com AngularJS, apresentações, cursos de treinamento e trabalho em equipe.

O objetivo deste guia de estilo é fornecer orientações sobre a criação de aplicativos AngularJS, mostrando as convenções que uso e, mais importante, por que as escolho.

- John Papa

Aqui está o link impressionante (mais recente e atualizado): Guia de estilo do AngularJS

Sampath
fonte
6

Comecei esta essência há um ano: https://gist.github.com/PascalPrecht/5411171

Brian Ford (membro da equipe principal) escreveu esta postagem no blog: http://briantford.com/blog/angular-bower

E então começamos com esta especificação de componente (que ainda não está completa): https://github.com/angular/angular-component-spec

Desde o último ng-conf, há este documento para práticas recomendadas pela equipe principal: https://docs.google.com/document/d/1XXMvReO8-Awi1EZXAXS4PzDzdNvV6pGcuaF4Q9821Es/pub

Pascal Precht
fonte