Dart Academy · Les

Aangepaste annotaties schrijven

Metadata aan uw declaraties koppelen

Les 2 van 413 stappen

Aangepaste annotaties schrijven is een gratis Dart Academy-les op CoddyKit. Dit is les 2 van 4. Je kunt de volledige les hieronder gratis lezen en daarna in de browser praktisch oefenen met een ingebouwde code-editor en een AI-begeleider die 24/7 beschikbaar is. Deze les maakt deel uit van het leertraject Dart Academy. Je voortgang wordt gesynchroniseerd op het web en in de CoddyKit-app. De cursus Dart Academy bevat in totaal 4 lessen.

Annotaties zijn classes

Een aangepaste annotation is gewoon een gewone class. Wanneer je @MyTag schrijft, verwijs je als metadata naar een instantie van die class. 🏷️

De class definiëren

Begin met het declareren van een normale class voor je metadata. Hier zal een eenvoudige annotatie Todo later een bericht en een eigenaar bevatten.

class Todo {
  final String message;
  const Todo(this.message);
}

De regel voor de const-constructor

Waarden van annotaties moeten constanten tijdens het compileren zijn, dus de constructor moet const zijn. Zonder const kun je de class niet als annotatie gebruiken.

Je annotatie toepassen

Gebruik het voorvoegsel @ met een const-constructie. Deze tag @Todo documenteert werk dat nog moet worden gedaan in de onderstaande methode.

@Todo('Add validation')
void saveForm() {}

Meerdere velden meenemen

Je annotatie mag zoveel fields bevatten als je wilt. Geef de constructor benoemde parameters wanneer je duidelijkere, zelfbeschrijvende tags wilt.

class Todo {
  final String task;
  final String who;
  const Todo(this.task, this.who);
}

Alleen constante argumenten

Elk argument dat je doorgeeft moet zelf een constant zijn. Letterlijke waarden, const-objecten en enumwaarden werken; een runtimevariabele niet.

Een markering zonder argumenten

Soms heb je alleen een vlag nodig. Een const-instantie zonder gegevens werkt als een pure marker die je aan declaraties koppelt.

class Experimental {
  const Experimental();
}
const experimental = Experimental();

Handige constanten met kleine letters

Door een const-instantie met een kleine naam beschikbaar te maken, kunnen aanroepers telkens netjes @experimental schrijven in plaats van @Experimental().

@experimental
void betaFeature() {}

Ze doen nog steeds niets uit zichzelf

Net als ingebouwde annotaties heeft je aangepaste annotatie zelf geen gedrag. Iets moet haar readen om haar nuttig te maken; dat behandelen we hierna.

Wie annotaties leest

Twee lezers zijn belangrijk: code generators tijdens het bouwen en hulpmiddelen in de stijl van reflection. Beide onderzoeken je tags en handelen op basis van de gevonden metadata.

Houd annotaties klein

Goede annotaties blijven klein en declarative. Sla gewone gegevens op, geen logica, zodat elk hulpmiddel ze voorspelbaar en veilig kan lezen.

Snelle controle

Wat moet een class hebben om als annotatie te kunnen worden gebruikt?

Samenvatting

Een aangepaste annotatie is een class met een const-constructor. Pas haar toe met @, geef constante argumenten door en laat hulpmiddelen de metadata later lezen. 🎉

Gratis beginnen

Leer Dart met een AI-tutor — gratis

Schrijf echte code en voer die uit in je browser, krijg direct hulp van een AI-tutor die 24/7 beschikbaar is en ga verder waar je gebleven bent op het web of in de app.

Cursussen
30
Lessen
120

Veelgestelde vragen

Is de les “Aangepaste annotaties schrijven” gratis?

Ja — de volledige tekst van “Aangepaste annotaties schrijven” kun je hier gratis op het web lezen. Als je interactief wilt oefenen met een ingebouwde code-editor en een AI-begeleider die 24/7 beschikbaar is, en de rest van de cursus Dart Academy wilt ontgrendelen, kun je upgraden naar CoddyKit PRO. De cursus Dart Academy bevat in totaal 4 lessen.

Wat leer ik in “Aangepaste annotaties schrijven”?

Metadata aan uw declaraties koppelen Je oefent met Dart Academy door code rechtstreeks in de browser uit te voeren. Een AI-begeleider die 24/7 beschikbaar is beantwoordt je vragen terwijl je de les doorwerkt.

Heb ik ervaring nodig om met Dart Academy te beginnen?

Ervaring vooraf is niet nodig. Dart Academy op CoddyKit is opgebouwd voor beginners tot gevorderden, zodat je hier of bij het begin kunt starten en in je eigen tempo kunt leren. Dit is les 2 van 4.

Hoe lang duurt de les “Aangepaste annotaties schrijven”?

De meeste lessen van CoddyKit duren ongeveer 5–10 minuten. Elke les is kort en interactief, zodat je gestaag vooruitgaat en op het web en in de app precies verdergaat waar je was gebleven.

Kan ik code schrijven en uitvoeren in deze les over Dart Academy?

Ja. Elke les over Dart Academy bevat een ingebouwde code-editor, zodat je rechtstreeks in je browser echte code kunt schrijven en uitvoeren en direct feedback van AI krijgt — lokale installatie is niet nodig.

Alle lessen in deze cursus

  1. Ingebouwde annotaties: override, deprecated
  2. Aangepaste annotaties schrijven
  3. Code genereren met build_runner
  4. json_serializable in actie
← Terug naar Dart Academy