Orientação gerada a partir de informações públicas. Apenas para referência.
Rough Notation é um pacote Flutter que permite aos desenvolvedores adicionar anotações animadas com estilo de desenho à mão a widgets usando CustomPainter. Inspirado na biblioteca JavaScript Rough Notation, traz uma aparência esboçada e expressiva para texto e elementos da interface. Ideal para destacar partes importantes do conteúdo com linhas e formas dinâmicas e estilizadas. Suporta múltiplas plataformas, incluindo Android, iOS, Web, macOS, Windows e Linux, tornando-o versátil para aplicativos multiplataforma. O pacote se integra suavemente a editores de texto rico, Markdown e HTML.
Casos de uso
Destacando texto importante em aplicativos educacionais
Adicionando anotações expressivas em tutoriais interativos
Melhorando interfaces com efeitos de estilo desenhado à mão
Visualizando pontos de dados em painéis
Criando experiências de onboarding envolventes
Estilizando conteúdo em markdown com marcadores dinâmicos
Principais recursos
Linhas com estilo desenhadas à mão animadas
Propriedades personalizáveis de traço e preenchimento
Suporte a múltiplos tipos de anotação (sublinhado, caixa, círculo)
Integração embutida com CustomPainter
Compatibilidade multiplataforma
Configuração fácil por meio do comando pub add
Indicado para
Aplicações educacionais e de aprendizagem
Interfaces de usuário interativas com feedback visual
Designers procurando elementos de interface expressivos
Desenvolvedores construindo editores de texto rico
Aplicativos que exigem anotações lúdicas ou artísticas
Considerações
Pode afetar o desempenho com muitas anotações
Requer conhecimento básico sobre CustomPainter
Limitado à renderização de canvas 2D
Não ideal para animações de alto desempenho
Mais adequado para atualizações estáticas ou de baixa frequência
README original
Snapshot do README original do repositório-fonte vinculado. Consulte o repositório para o conteúdo mais recente.
RoughNotation Flutter
A lightweight Flutter package to create animated, hand-drawn-style annotations on widgets.
It uses Flutter’s CustomPainter to render the annotations, supporting config options for styling and animation — including manual triggers, sequencing via groups, and autoplay.
It doesn't matter where widgets are in the widget tree — grouped annotations can live inside deeply nested widgets or even different build scopes. The registry handles sequencing regardless of position.
From Flutter 3.16+, deferred or conditionally built widgets (e.g., in a ListView.builder) won’t throw errors but will skip animations until built.
Delays & Durations: Group sequencing introduces its own delays between elements. Avoid adding large delay values on individual annotations if part of a group.
Controllers & Autoplay: If using RoughAnnotationController(autoPlay: true), ensure the widget is built first. Internally, we use addPostFrameCallback to delay the trigger.
Multiple Controllers: You can reuse the same controller for multiple widgets, but only one annotation may render if others haven't mounted yet.
Lazy Lists / Builders: Widgets in a ListView.builder or similar builders that are not yet mounted will not animate. No crash, but no effect either.
Visual Misalignments: Styling mismatches may occur across platforms. Future updates will improve drawing precision and painter logic.
🧠 What's Next
We’re aiming to improve:
Core painter logic for smoother lines and curves (lib/src/painters)
Extend features and stability of annotation widgets (lib/src/annotations)
Also the controllers & grouped behaviour (lib/src/controllers)
The original JS library uses roughjs. Although there's a Flutter version (rough), it’s outdated and Dart 3 incompatible.
We’re considering reviving or reimplementing it in parts. All contributions are welcome!
If you're looking to contribute, ideal places to start are: