fcbk
Conéctate con TwitterConéctate con Facebook
49

Una buena práctica para escribir código: nombrar elementos

13021Puntos

hace 3 meses

¿Les ha pasado que están súper inspirados escribiendo código pero repentinamente necesitan una luz divina que les diga qué nombre ponerle a la variable que están a punto de escribir?

Como Frontend, hay tantas cosas que debo nombrar en mi día a día: clases para cada elemento HTML, variables en Stylus que puedan ser reutilizables, componentes, archivos, funciones… Tengo que poner a volar mi imaginación para poder lograrlo.

A pesar de que es algo que depende totalmente de nosotros y no hay una forma estrictamente correcta o incorrecta de hacerlo, nombrar cada elemento es un trabajo en el que debemos poner empeño, pues se verá impactado en la organización y mantenibilidad de nuestro código.

Fanny es parte del Team Platzi. Si quieres una carrera en Frontend, empieza por el Curso de Desarrollo Web y luego el Curso de Responsive Design.

Lo más importante es que el nombre que le asignes siempre refleje el trabajo que está haciendo, de esta forma podemos incluso reducir la necesidad de comentar cada línea de código con su funcionamiento.

A continuación algunos consejos que hay que seguir para evitar algún desastre a la hora de nombrar un elemento en tu código.

Nombres descriptivos

Abreviar nombres puede que en algunos casos no sea tan buena idea. Seguramente con el paso del tiempo o cuando un nuevo desarrollador tenga que darle mantenimiento a tu código habrá quedado en el olvido lo que esa variable representa. Lo ideal es utilizar nombres que describan la funcionalidad de nuestro código.

Por ejemplo, es mucho más descriptivo escribir:

functionreceipt(){
....
return ingredient;
}

que:

functiona(){
....
return b;
}

Nombres conformados por un conjunto de palabras

Generalmente los lenguajes de programación no permiten espacios en las variables. Sin embargo hay distintos métodos para separar el conjunto de palabras que conforman una variable y que de esta manera logren ser más legibles. Esto se puede hacer capitalizando cada palabra agrupada (camelCase) o separando cada palabra con underscore
(snake_case).

Por ejemplo:

var post_likes = 4;

o

var postWords = 320;

La longitud de el nombre asignado

A pesar de que los nombres de variables cortos deben ser sustituidos por nombres de variables más largos y descriptivos, no quiere decir que tenemos que usar frases completas. Es importante que el nombre describa qué es lo que el código asignado hace y no cómo lo hace. Utilizar un nombre largo puede incluso ser más susceptible a errores tipográficos a la hora de escribirlo. Se dice que la longitud recomendable es de 2 a 4 palabras o entre 8 y 20 caracteres.

En conclusión nombrar elementos no es difícil, más bien es un súper poder o habilidad que va mejorando con la práctica. Nosotros como desarrolladores tenemos la responsabilidad de hacerlo lo mejor posible.

Si recién comienzas a programar, te invito al Curso de programación básica para empezar a implementar estos consejos en tus proyectos. Y si llevas ya tiempo programando sin hacer uso de ellos, compártenos cómo te va siguiendo estas recomendaciones. Estoy segura que los desarrolladores que se topen con tu código en el futuro te lo agradecerán.

Fannytaviles
Fannytaviles
@fannytaviles

13021Puntos

hace 3 meses

Todas sus entradas
Top
Nuevas
6
523Puntos
3 meses

En nuestra empresa, tenemos como “estándar” interno, los métodos ya sean de Javascript o bien propios del lenguaje de backend, poner el nombre que describa exactamente lo que hace, por ejemplo

defverificar_si_no_existe_despues_de(variable)
	...
end

Por más que sea largo, de esta forma ya todo el equipo sabe que hace y nos ahorramos estar averiguando que responsabilidad o que acción tiene ese método.

En el caso de las variables, tratamos siempre también que sean lo más descriptivas posibles pero acotar la cantidad de letras, por ejemplo:

let numDni
0
13021Puntos
14 días

Super! Y muy cierto, la longitud no importa, lo importante es que sea descriptivo 😃

4
27Puntos
3 meses

Muchas_gracias. ExcelenteConsejo

1
1205Puntos
3 meses

Gracias por los consejos, son sencillos pero muy útiles.

1
44Puntos
2 meses

Excelente artículo!

1
6072Puntos
3 meses

Conclusión: Nombra tus variables de una forma descriptiva pero no te pases.

0
13021Puntos
14 días

Descriptiva es lo importante 😃

1
11Puntos
3 meses

Ese es un primer paso importante. Luego está agrupar la declaración de variables, y colocarles para qué serán utilizadas

0
13021Puntos
14 días

Lo ideal es que el nombre sea tan descriptivo que no haya necesidad de colocar para qué será utilizada 😃

1

Muchas gracias por la información, siempre es bueno tener esta clase de puntos claves a la hora de desarrollar; hace que el proceso de aprendizaje (en mi caso) sea mucho más intuitivo, fácil y divertido. Simplemente eficiente.

1
681Puntos
2 meses

Muy buenos concejos, me ha tocado darle mantenimiento a programas realizados por programadores que ya no están en la empresa donde trabajo, y me he topado con variables que dificultan mucho en entender su función.

0
13021Puntos
14 días

Me ha pasado, dan ganas de hacerle algo a la persona 🌚

1
1986Puntos
3 meses

Me gusta eso del super poder, programar te da muchos 😆

1
2 meses

Hay un dicho de hace ya glum tiempo: “solo hay dos cosas muy difíciles en la programación: nombrar cosas e invalidar cache”

Estos tips para nombrar variables son claves y ayudan a que poco a poco deje de ser tan difícil 😁

0
13021Puntos
14 días

Parece simple pero es difícil 😦

1
67Puntos
3 meses

excelente muchas gracias por el articulo

1
5450Puntos
3 meses

yo antes hacia el error de abreviar nombres

0
13021Puntos
3 meses

Cuando recién comenzaba, me llegó a pasar también. Tenía la sensación de que un nombre largo estaba mal 😦

0
11Puntos
3 meses

A la grande le puse cuca