Convenções de código / nomenclatura angularjs

Alguém sabe se existe alguma referência oficial ou mais aceita para convenções de nomenclatura angular para usar quando construímos nossos aplicativos?

Angular tem 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 ao implementá-las em nossos aplicativos fará sentido?

Por exemplo:

Se precisarmos criar novos filtros, como devemos nomeá-los como [algo] filtrar ou filtrar [algo] ou outra coisa?

E o mesmo se aplica a Controladores, Serviços, Diretivas e assim por diante.

Outras coisas que me pergunto é se variables ​​/ 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 das funções e outras (nenhum código angular).

Confira este repository do GitHub que descreve as melhores práticas para aplicativos AngularJS. Tem convenções de nomenclatura para diferentes componentes. Não está completo, mas é orientado pela comunidade, para que todos possam contribuir.

Se você é um iniciante, é melhor você primeiro passar por alguns tutoriais básicos e depois aprender sobre convenções de nomenclatura. Eu passei pelo 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 da aplicação e convenções de nomenclatura podem ser encontrados em vários lugares. Já passei por centenas de sites e acho que eles estão entre os melhores:

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

  • Recomendações de práticas recomendadas do Google para estrutura de aplicativo angular

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

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


… esta resposta está incompleta, mas espero que a informação limitada acima seja útil para alguém.

Atualização: o GUIA DE ESTILO está agora em documentos angulares.

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

Se você estiver procurando por um guia de estilo opinativo para syntax, convenções e estruturação de aplicativos AngularJS, siga em frente. Os estilos aqui contidos baseiam-se em minha experiência com o AngularJS, apresentações, cursos de treinamento e trabalho em equipe.

O objective deste guia de estilo é fornecer orientação 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 Awesome (mais recente e atualizado): AngularJS Style Guide

Eu comecei esta essência há um ano atrás: https://gist.github.com/PascalPrecht/5411171

Brian Ford (membro da equipe principal) escreveu este post sobre isso: http://briantford.com/blog/angular-bower

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

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