Código de Angularjs / convenciones de nomenclatura [cerrado]

162

¿Alguien sabe si existe alguna referencia oficial o más aceptada para las convenciones de nomenclatura angular para usar cuando creamos nuestras aplicaciones?

Angular tiene muchos tipos diferentes de componentes, como filtros, directivas, servicios, etc. ¿No estaría de acuerdo con que tener una convención de nomenclatura de referencia cuando las implementemos en nuestras aplicaciones tenga sentido?

Por ejemplo:

Si necesitamos crear nuevos filtros, ¿cómo deberíamos nombrarlos como [Algo] Filtro o filtro [Algo] u otra cosa?

Y lo mismo se aplica a los controladores, servicios, directivas, etc.

Otras cosas que me preguntan es si las variables / funciones que pertenecen al ámbito deben tener un prefijo o sufijo especial. En algunas situaciones, puede ser útil tener una forma de diferenciarlas de las funciones y otras (código ninguno angular).

Dalorzo
fuente
2
Acabo de encontrar esta publicación interesante en el Blog Angular llamada Recomendaciones de mejores prácticas para la estructura angular de aplicaciones
Edwin Dalorzo

Respuestas:

45

Si es un principiante, es mejor que primero lea algunos tutoriales básicos y luego aprenda sobre las convenciones de nomenclatura. Revisé lo siguiente para aprender Angular, algunos de los cuales son muy efectivos.

Tutoriales:

  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/

Los detalles de la estructura de la aplicación y las convenciones de nombres se pueden encontrar en una variedad de lugares. He visitado cientos de sitios y creo que estos se encuentran entre los mejores:

Rajendra Khabiya
fuente
33

Para estructurar una aplicación, esta es una de las mejores guías que he encontrado:

Tenga en cuenta que la estructura recomendada por Google es diferente de la que encontrará en muchos proyectos semilla, pero para aplicaciones grandes es mucho más sensata.

Google también tiene una guía de estilo que tiene sentido usar solo si también usa Closure .


... esta respuesta es incompleta, pero espero que la información limitada anterior sea útil para alguien.

Gil Birman
fuente
19

Actualización: GUÍA DE ESTILO ahora está en documentos angulares.

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

Si está buscando una guía de estilo obstinada para la sintaxis, las convenciones y la estructuración de aplicaciones de AngularJS, entonces intervenga. Los estilos aquí contenidos se basan en mi experiencia con AngularJS, presentaciones, cursos de capacitación y trabajo en equipo.

El propósito de esta guía de estilo es proporcionar orientación sobre la creación de aplicaciones AngularJS mostrando las convenciones que uso y, lo que es más importante, por qué las elijo.

- John Papa

Aquí está el enlace impresionante (más reciente y actualizado): Guía de estilo de AngularJS

Sampath
fuente
6

Comencé esta esencia hace un año: https://gist.github.com/PascalPrecht/5411171

Brian Ford (miembro del equipo central) ha escrito esta publicación de blog al respecto: http://briantford.com/blog/angular-bower

Y luego comenzamos con esta especificación de componente (que no está del todo completa): https://github.com/angular/angular-component-spec

Desde la última ng-conf existe este documento para las mejores prácticas del equipo central: https://docs.google.com/document/d/1XXMvReO8-Awi1EZXAXS4PzDzdNvV6pGcuaF4Q9821Es/pub

Pascal Precht
fuente