Comment puis-je écrire un commentaire à un article que je défini dans flex?

Question

Je veux ajouter un commentaire à certains éléments dans un document Flex, et traiter les commentaires à l'aide ASDoc. Je peux facilement le faire pour la partie de script, mais je me retrouve avec une tonne de laid « Cette propriété peut être utilisée comme source de liaison de données. » messages pour chaque élément que je déclarais dans Flex.

Est-il possible d'incorporer un commentaire dans un élément flexible afin qu'il puisse être lu par ASDoc? Je l'ai essayé d'utiliser la norme

<!-- --> 

notation, mais cela ne semble pas fonctionner.

EDIT: La notation semble être engloutie comme un commentaire HTML, je suppose que vous savez à quoi il ressemble ...

Answer 1

Vous essayez de mettre des commentaires dans le balisage?

D'après la documentation Flex « Parce que le format d'un commentaire ASDoc utilise la syntaxe ActionScript, vous ne pouvez insérer un commentaire ASDoc dans un bloc d'un fichier MXML. »

Answer 2

Sans voir votre code, il est un peu difficile de dire exactement ce qui se passe. Rien sur ASdocs devrait produire une erreur du compilateur bindable. Êtes-vous cette erreur du compilateur Flex ou le compilateur ASDoc? Essayez-vous de documenter un document MXML ou un document ActionScript?

Avez-vous lu ces documents?

ActionScript :

/**
* Your Comment Goes Here
*/
ActionScript Element

Et sur MXML ? MXML ASDoc commentaires doivent user trois tirets, pas 2 pour le premier marqueur de commentaire. Comme ceci:

<!--- Your comment goes here -->
MXML Element

Answer 3

Vous pouvez utiliser ces // et / * * / (dans les blocs ActionScript) Pour commenter un nœud MXML utilisation <!-- and end with -->