¿cómo comentar en jsx?

Lista de comentarios de react

Aunque yo recomendaría usar babel-sublime para resaltar la sintaxis en Sublime Text 3, como puedes ver aquí hay varios problemas con los comentarios JSX. Sin embargo se puede lograr, citando a @zertosh:

Desafortunadamente hay una combinación de problemas que hacen que esto no se pueda arreglar. No hay tal cosa como un comentario JSX. Puedes tener expresiones JSX (llaves) con comentarios JS – pero eso es una falsificación de babel-sublime como una conveniencia. Esa falsificación te muerde cuando tratas de descomentar – como has notado. Hay una ambigüedad. Como las llaves no son parte del comentario, Sublime las deja atrás.

Desafortunadamente comentar en código que tiene una mezcla de JS/JSX no es tan sencillo como debería, me las arreglé para añadirlo a https://github.com/borela/naomi pero requirió muchas soluciones, meta scopes y un plugin.

Ejemplo de react-native-comments

Uno de los aspectos más importantes de la documentación del software es escribir comentarios en el código. Los comentarios son líneas que existen en los programas informáticos que son ignoradas por los intérpretes y compiladores, y que están pensadas para ser leídas por los humanos.

Escribir comentarios te permite hacer tu código más legible y explicar lo que hacen partes específicas de un programa. Por ejemplo, si estás escribiendo un programa largo, puedes utilizar los comentarios para seguir la pista de ciertas funciones o líneas de código.

En este tutorial, vamos a explorar cómo escribir comentarios en HTML. Empezaremos por ver por qué se utilizan los comentarios en la programación. Luego, veremos los dos tipos principales de comentarios: comentarios de una línea y de varias líneas.

Los comentarios se escriben para que los humanos los lean y ayudan a que el código sea más fácil de entender. Cuando estás trabajando en un proyecto solo, es fácil pasar por alto los comentarios porque eres la única persona que lee tu código. Sin embargo, si estás trabajando en un proyecto grande que incluye código complejo, entonces puedes perder fácilmente la pista del propósito de tu código.

Como crear una caja de comentarios en react native

Para representar los comentarios en React (que es lo que supongo que la mayoría de la gente está buscando cuando llegan a esta pregunta), utilizo un componente de React que tengo en un gist. Se basa en la respuesta de Alex Zinkevych, pero con las siguientes mejoras:

He enlazado al gist más arriba, pero también he copiado el contenido en el momento de escribir esto más abajo, pero es posible que quieras ver si hay alguna revisión en el gist, ya que arreglaré cualquier error que pueda encontrar y lo publicaré como revisiones en el Gist.

Sin embargo, como el OP señaló en un comentario en el post de Alex, esto no responde realmente a la pregunta. Para un único componente que muestra los comentarios antes y después de los hijos, podemos utilizar el componente HTMLComment definido anteriormente y componer un nuevo componente:

Ahora, podemos juntar todo esto en un script. Aquí está el código fuente en el patio de juegos de Typescript, así como un Gist (es grande y repite los componentes detallados anteriormente, así que no voy a copiar ese código directamente en esta respuesta.

He visto algunas respuestas aquí que dicen que hay que usar una sintaxis similar a {‘<!– comment –>’} que simplemente mostraría <!– comment –> como un <p> en tu navegador, puede funcionar si haces lo mismo con un ref y luego estableces el ref.current.outerHTML = ‘<!– comment –>’, pero eso es extremadamente tedioso y requiere useEffect, useRef y un montón de código extra. Y todavía tienes que crear un div que se reemplaza con el comentario, así que a menos que estés tratando de engañar a los usuarios para que piensen que has añadido un comentario (que si saben cómo inspeccionar una página y ver los comentarios, entonces lo más probable es que también sepan cómo leer el React JS que estás enviando)

Comentario jsx en vscode

Tiene la ventaja de que vincula el comentario al atributo individual, en lugar de a la etiqueta en su conjunto. Creo que es más claro; si realmente querías comentar la etiqueta harías mejor en moverla al principio.

Estás intentando usar una expresión JSX inline como si estuvieras pasando props dentro de la etiqueta de apertura, esto NO está permitido. Cuando tienes un elemento, la etiqueta de apertura sólo puede contener objetos deconstruidos o valores prop=value de ahí que se espere … para deconstruir un objeto con props y valores, por ejemplo: