Écrire des annotations personnalisées
Associer des métadonnées à vos déclarations
Écrire des annotations personnalisées est une leçon Dart Academy gratuite sur CoddyKit. Ceci est la leçon 2 sur 4. Tu peux lire la leçon complète ci-dessous gratuitement — puis la pratiquer en direct dans le navigateur avec un éditeur de code intégré et un tuteur IA 24/7. Elle fait partie du parcours d'apprentissage Dart Academy, et ta progression se synchronise sur le web et l'application CoddyKit. Le cours Dart Academy comprend 4 leçons au total.
Les annotations sont des classes
Une annotation personnalisée n'est qu'une classe ordinaire. Lorsque vous écrivez @MyTag, vous faites référence à une instance de cette classe en tant que métadonnée. 🏷️
Déclarer la classe
Commencez par déclarer une classe normale destinée à contenir vos métadonnées. Ici, une simple annotation Todo contiendra ensuite un message et un responsable.
class Todo {
final String message;
const Todo(this.message);
}La règle du constructeur const
Les valeurs d'annotation doivent être des constantes connues à la compilation ; le constructeur doit donc être const. Sans cela, vous ne pouvez pas utiliser la classe comme annotation.
Appliquer votre annotation
Utilisez le préfixe @ avec une construction const. Cette balise @Todo documente le travail qui reste à effectuer sur la méthode ci-dessous.
@Todo('Add validation')
void saveForm() {}Transporter plusieurs champs
Votre annotation peut contenir autant de champs que vous le souhaitez. Donnez au constructeur des paramètres nommés pour obtenir des balises plus claires et explicites.
class Todo {
final String task;
final String who;
const Todo(this.task, this.who);
}Uniquement des arguments constants
Chaque argument transmis doit lui-même être une constante. Les littéraux, les objets const et les valeurs d'énumération fonctionnent ; une variable d'exécution, non.
Un marqueur sans argument
Parfois, vous avez seulement besoin d'un indicateur. Une instance const sans donnée agit comme un simple marqueur attaché aux déclarations.
class Experimental {
const Experimental();
}
const experimental = Experimental();Des constantes pratiques en minuscules
Exposer une instance const en minuscules permet aux appelants d'écrire @experimental au lieu de @Experimental() à chaque fois.
@experimental
void betaFeature() {}Elles ne font toujours rien seules
Comme les annotations intégrées, votre annotation personnalisée n'a aucun comportement par elle-même. Quelque chose doit la lire pour la rendre utile ; nous verrons cela ensuite.
Qui lit les annotations ?
Deux types de lecteurs comptent : les générateurs de code lors de la compilation et les outils de type réflexion. Tous deux inspectent vos balises et exploitent les métadonnées trouvées.
Garder les annotations simples
Les bonnes annotations restent petites et déclaratives. Stockez des données simples, pas de logique, afin que tout outil puisse les lire de manière prévisible et sûre.
Vérification rapide
Que doit posséder une classe pour pouvoir être utilisée comme annotation ?
Récapitulatif
Une annotation personnalisée est une classe dotée d'un constructeur const. Appliquez-la avec @, transmettez des arguments constants et laissez les outils lire les métadonnées plus tard. 🎉
Questions Fréquemment Posées
La leçon « Écrire des annotations personnalisées » est-elle gratuite ?
Oui — le texte complet de « Écrire des annotations personnalisées » est gratuit à lire ici sur le web. Pour la pratiquer de manière interactive (un éditeur de code intégré et un tuteur IA 24/7) et déverrouiller le reste du cours Dart Academy, passe à CoddyKit PRO. Le cours Dart Academy comprend 4 leçons au total.
Qu'est-ce que j'apprendrai dans « Écrire des annotations personnalisées » ?
Associer des métadonnées à vos déclarations Tu pratiques Dart Academy avec du code pratique que tu exécutes directement dans le navigateur, et un tuteur IA 24/7 répond à tes questions au fur et à mesure que tu avances dans la leçon.
Dois-je avoir de l'expérience pour commencer Dart Academy ?
Aucune expérience préalable n'est requise. Dart Academy sur CoddyKit est structuré pour les débutants jusqu'aux apprenants avancés, donc tu peux commencer ici ou depuis le début et avancer à ton rythme. Ceci est la leçon 2 sur 4.
Combien de temps prend la leçon « Écrire des annotations personnalisées » ?
La plupart des leçons CoddyKit prennent environ 5–10 minutes. Chacune est courte et interactive, tu progresses régulièrement et tu repiques exactement où tu t'es arrêté sur le web et l'app.
Peux-tu écrire et exécuter du code dans cette leçon Dart Academy ?
Oui. Chaque leçon Dart Academy inclut un éditeur de code intégré, tu écris et exécutes du vrai code directement dans ton navigateur et tu reçois des retours IA instantanés — aucune configuration locale requise.
Toutes les leçons de ce cours
- Annotations intégrées : override, deprecated
- Écrire des annotations personnalisées
- Génération de code avec build_runner
- json_serializable en action