Buscar pacotes, repositórios e categorias de apps

ducafecatGuia do ecossistema Flutter
Capa de scratcher
Detalhes do pacotev2.5.0

scratcher

Widget de cartão de raspar que oculta temporariamente o conteúdo do usuário.

AndroidiOSWebmacOSWindowsLinux
pub.dev Documentação da API Código-fonte
Downloads em 30 dias
14,9 mil
Curtidas
501
Pontos Pub
140

Instalar pacote

flutter pub add scratcher

Visão geral do pacote

Orientação gerada a partir de informações públicas. Apenas para referência.

O pacote scratcher fornece um widget do Flutter que simula a experiência de um cartão de raspar, ocultando temporariamente o conteúdo até que o usuário o 'raspe'. É ideal para interfaces gamificadas, sistemas de recompensas ou revelações surpresa em aplicativos. O widget suporta interações por toque em todas as principais plataformas, incluindo móvel, web e desktop. Efeitos de raspagem personalizáveis e feedback visual aumentam o engajamento do usuário. Desenvolvido com foco em desempenho e facilidade de integração, é perfeito para desenvolvedores que querem adicionar elementos interativos sem implementação complexa.

Casos de uso

  • Recompensas de aplicativo gamificado
  • Conteúdo oculto é revelado
  • Promoções interativas
  • Cartões de raspar digitais
  • Recursos de engajamento do usuário

Principais recursos

  • Suporte multiplataforma
  • Efeito de riscar personalizável
  • Manipulação de interação por toque
  • Animação suave
  • Integração fácil com o Flutter
  • Opacidade de riscar configurável

Indicado para

  • Desenvolvedores de aplicativos procurando interfaces interativas
  • Projetos de gamificação
  • Campanhas de marketing com elementos surpresa
  • Aplicativos educacionais com mecanismos de revelação
  • Aplicações simples baseadas em recompensas

Considerações

  • Pode afetar o desempenho em dispositivos de baixa gama
  • Personalização limitada para padrões avançados de raspagem
  • Não adequado para ocultação de conteúdo de alta segurança
  • Requer um design cuidadoso para acessibilidade
  • Melhor usado com conteúdo leve

README original

Snapshot do README original do repositório-fonte vinculado. Consulte o repositório para o conteúdo mais recente.

scratcher

Scratch card widget which temporarily hides content from the user.

Version

Demo

Features

  • Supported platforms:
    • Android
    • iOS
    • Web (CanvasKit only)
  • Cover content with full color or custom image
  • Track the scratch progress and threshold
  • Fully configurable

Getting started

  1. First thing you need to do is adding the scratcher as a project dependency in pubspec.yaml:
dependencies:
 scratcher: "^2.5.0"
  1. Now you can install it by running flutter pub get or through code editor.

Setting up

  1. Import the library:
import 'package:scratcher/scratcher.dart';
  1. Cover desired widget with the scratch card:
Scratcher(
  brushSize: 30,
  threshold: 50,
  color: Colors.red,
  onChange: (value) => print("Scratch progress: $value%"),
  onThreshold: () => print("Threshold reached, you won!"),
  child: Container(
    height: 300,
    width: 300,
    color: Colors.blue,
  ),
)

Properties

Property Type Description
child Widget Widget rendered under the scratch area.
enabled bool Whether new scratches can be applied.
threshold double Percentage level of scratch area which should be revealed to complete.
brushSize double Size of the brush. The bigger it is the faster user can scratch the card.
accuracy ScratchAccuracy Determines how accurate the progress should be reported. Lower accuracy means higher performance.
color Color Color used to cover the child widget.
image Image Image widget used to cover the child widget.
rebuildOnResize bool Determines if the scratcher should rebuild itself when space constraints change (resize).
onChange Function Callback called when new part of area is revealed (min 0.1% difference).
onThreshold Function Callback called when threshold is reached (only when defined).
onScratchStart Function Callback called when scratching starts.
onScratchUpdate Function Callback called during scratching.
onScratchEnd Function Callback called when scratching ends.

Programmatic access

You can control the Scratcher programmatically by assigning the GlobalKey to the widget.

final scratchKey = GlobalKey<ScratcherState>();

Scratcher(
  key: scratchKey,
  // remaining properties
)

After assigning the key, you can call any exposed methods e.g.:

RaisedButton(
  child: const Text('Reset'),
  onPressed: () {
    scratchKey.currentState.reset(duration: Duration(milliseconds: 2000));
  },
);
Method Description
reset Resets the scratcher state to the initial values.
reveal Reveals the whole scratcher, so than only original child is displayed.

Example Project

There is a crazy example project in the example folder. Check it out to see most of the available options.

Resources

Categorias

Jogos e Recompensas

Repositório-fonte

Projetos que usam este pacote