Escrevendo Anotações Personalizadas
Anexe metadados às suas declarações.
Escrevendo Anotações Personalizadas é uma aula grátis de Dart Academy no CoddyKit. Esta é a aula 2 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de Dart Academy, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de Dart Academy inclui 4 aulas no total.
Anotações são classes
Uma anotação personalizada é apenas uma classe comum. Quando você escreve @MyTag, está fazendo referência a uma instância dessa classe como metadado. 🏷️
Definir a classe
Comece declarando uma classe normal para armazenar seus metadados. Aqui, uma anotação simples Todo posteriormente conterá uma mensagem e um responsável.
class Todo {
final String message;
const Todo(this.message);
}A regra do construtor const
Os valores das anotações precisam ser constantes em tempo de compilação, portanto o construtor deve ser const. Sem isso, você não poderá usar a classe como anotação.
Aplicar sua anotação
Use o prefixo @ com uma construção const. Esta marca @Todo documenta um trabalho que ainda precisa ser realizado no método abaixo.
@Todo('Add validation')
void saveForm() {}Armazenar vários campos
Sua anotação pode conter quantos campos você quiser. Use parâmetros nomeados no construtor quando desejar marcas mais claras e autoexplicativas.
class Todo {
final String task;
final String who;
const Todo(this.task, this.who);
}Somente argumentos constantes
Cada argumento fornecido também deve ser uma constante. Literais, objetos const e valores de enumeração funcionam; uma variável de execução não.
Um marcador sem argumentos
Às vezes, você precisa apenas de uma sinalização. Uma instância const sem dados funciona como um marcador puro anexado às declarações.
class Experimental {
const Experimental();
}
const experimental = Experimental();Constantes convenientes em minúsculas
Expor uma instância const em minúsculas permite que quem chama o código escreva um @experimental simples em vez de @Experimental() todas as vezes.
@experimental
void betaFeature() {}Elas continuam sem fazer nada sozinhas
Assim como as integradas, sua anotação personalizada não tem comportamento por si só. Algo precisa lê-la para torná-la útil, como veremos a seguir.
Quem lê as anotações
Dois leitores são importantes: geradores de código durante a compilação e ferramentas no estilo de reflexão. Ambos examinam suas marcas e agem sobre os metadados encontrados.
Mantenha as anotações pequenas
Boas anotações são pequenas e declarativas. Armazene dados simples, não lógica, para que qualquer ferramenta possa lê-las de modo previsível e seguro.
Verificação rápida
O que uma classe precisa ter para ser usada como anotação?
Recapitulação
Uma anotação personalizada é uma classe com um construtor const. Aplique-a com @, passe argumentos constantes e deixe que as ferramentas leiam os metadados mais tarde. 🎉
Aprenda Dart com um tutor de IA — grátis
Escreva e execute código real no seu navegador, obtenha ajuda instantânea de um tutor de IA 24/7 e continue de onde parou na web ou no app.
- Cursos
- 30
- Aulas
- 120
Perguntas Frequentes
A aula “Escrevendo Anotações Personalizadas” é grátis?
Sim — o texto completo de “Escrevendo Anotações Personalizadas” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de Dart Academy, atualize para CoddyKit PRO. O curso de Dart Academy inclui 4 aulas no total.
O que vou aprender em “Escrevendo Anotações Personalizadas”?
Anexe metadados às suas declarações. Você pratica Dart Academy com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.
Preciso ter experiência prévia para começar Dart Academy?
Nenhuma experiência prévia é necessária. Dart Academy no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 2 de 4.
Quanto tempo leva a aula “Escrevendo Anotações Personalizadas”?
A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.
Posso escrever e executar código nesta aula de Dart Academy?
Sim. Cada aula de Dart Academy inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.
Todas as aulas deste curso
- Anotações Integradas: override, deprecated
- Escrevendo Anotações Personalizadas
- Geração de Código com build_runner
- json_serializable em Ação