패키지, 저장소 및 앱 카테고리 검색

flip_board 표지
패키지 상세v1.0.0

flip_board

FlipBoards는 콘텐츠 변경을 뒤집기 애니메이션으로 애니메이트하는 FlipWidgets의 조합입니다. FlipFraseBoard, FlipMatrix, FlipClock 등이 포함됩니다.

AndroidiOSWebmacOSWindowsLinux
30일 다운로드
1.4천
좋아요
115
Pub 점수
150

패키지 설치

flutter pub add flip_board

패키지 개요

공개 정보를 바탕으로 생성한 선택 가이드입니다.

FlipBoard는 플립 애니메이션을 사용하여 애니메이티드 콘텐츠 전환을 가능하게 하는 Flutter 패키지입니다. 각각의 표시 콘텐츠 변경 사항을 부드럽게 애니메이션화하도록 설계된 재사용 가능한 위젯인 FlipFraseBoard, FlipMatrix, FlipClock를 제공합니다. Flutter의 애니메이션 시스템을 기반으로 하며, Android, iOS, Web, macOS, Windows, Linux 등 여러 플랫폼을 지원합니다. 상태 변경 시 시각적 피드백이 사용자 경험을 향상시키므로, 매력적인 UI를 만들기에 이상적입니다.

사용 사례

  • 애니메이션 디지털 시계
  • 동적 텍스트 표시
  • 인터랙티브 데이터 그리드
  • 사용자 인터페이스 전환
  • 게임 스코어 카운터
  • 양식 내 시각적 피드백

주요 기능

  • 부드러운 플립 애니메이션
  • 사전 구축된 전용 보드
  • 크로스 플랫폼 호환성
  • Flutter와의 간편한 통합
  • 사용자 정의 가능한 플립 방향 및 속도
  • 반응형 콘텐츠 업데이트

적합한 대상

  • 인터랙티브 대시보드를 구축하는 개발자
  • 동적 UI 요소를 찾는 디자이너
  • 시각적 상태 전환을 필요로 하는 앱
  • 교육용 또는 게임 애플리케이션
  • 실시간 데이터 시각화 도구

고려 사항

  • 저사양 기기에서 성능에 영향을 미칠 수 있습니다
  • 플립 효과를 넘어서는 사용자 정의가 제한되어 있음
  • Flutter 위젯 라이프사이클에 대한 이해가 필요합니다
  • 간단한 정적 콘텐츠에 적합하지 않습니다
  • 애니메이션은 미니멀리즘 디자인에서 방해가 될 수 있습니다
  • Flutter의 애니메이션 프레임워크 안정성에 의존합니다

원본 README

연결된 소스 저장소의 README 원문 스냅샷입니다. 최신 내용은 저장소에서 확인하세요.

Flip Board

pub package license

Widgets to build displays that resemble Mechanical Flip Boards.

The basic component is a stateful FlipWidget that renders flip transitions for a stream of items and an itemBuilder.

The package also includes other widgets that compose this basic component in useful Flip Boards:

Flip Widget

The most distinctive characteristic of a FlipWidget is its flip type to define the type of movement that will animate items rendering, either FlipType.middleFlip or FlipType.spinFlip.

This widget renders flip animations in a configured Axis and AxisDirection, animating the transition to each new item received in the given item stream. It is commonly used to display digits and letters but can actually render any widget you build through the given itemBuilder.

It is constructed with four required parameters (besides many optional parameters):

  • flipType: either FlipType.middleFlip or FlipType.spinFlip
  • itemStream: stream of items to be flipped as they are received
  • itemBuilder: builder to create a widget out of each item
  • flipDirection: AxisDirection to animate new items flip

Please check the class documentation to see all options.

Middle Flip

When we think of Mechanical Flip Boards as we used to see in airports and sport score boards we think on a Vertical MiddleFlip Widget or, most likely, on a composition (row) of them.

Its construction could look like:

FlipWidget({
  flipType: FlipType.middleFlip,
  itemStream: _stream,
  itemBuilder: _itemBuilder,
  flipDirection: AxisDirection.down,
});
Spin Flip

With FlipType.spinFlip this widget will render a Flip Card animation when new items arrive in the stream.

It has a similiar constructor, something like:

FlipWidget({
  flipType: FlipType.spinFlip,
  itemStream: _stream,
  itemBuilder: _itemBuilder,
  flipDirection: AxisDirection.right,
});

Example page that shows both types and all flipping directions (full code in examples folder):

  @override
  Widget build(BuildContext context) =>
    Center(
      child: Column(
        mainAxisAlignment: MainAxisAlignment.center,
        children: [
          _flipWheel,
          _spinWheel,
        ],
      ),
    );

  Widget get _flipWheel =>
    Center(
      child: Column(
        mainAxisSize: MainAxisSize.min,
        children: [
          _wheelTitle('Flip Widget'),
          _flipWidget(AxisDirection.up),
          Row(
            mainAxisSize: MainAxisSize.min,
            children: [
              _flipWidget(AxisDirection.left),
              _button,
              _flipWidget(AxisDirection.right),
            ],
          ),
          _flipWidget(AxisDirection.down),
        ],
      ),
    );

  Widget _flipWidget(AxisDirection direction) =>
    FlipWidget(
      flipType: FlipType.middleFlip,
      itemStream: _flipController.stream,
      itemBuilder: _itemBuilder,
      initialValue: _nextFlipValue,
      flipDirection: direction,
      hingeWidth: 1.0,
      hingeLength: 56.0,
      hingeColor: Colors.black,
    );

  Widget _itemBuilder(BuildContext context, int? value) =>
    Container(
      width: 64.0,
      height: 64.0,
      alignment: Alignment.center,
      decoration: BoxDecoration(
        borderRadius: const BorderRadius.all(Radius.circular(4.0)),
        border: Border.all(),
      ),
      child: Text(
        (value ?? 0).toString(),
        style: TextStyle(fontSize: 54.0),
      ),
    );

  void _flip() => _flipController.add(++_nextFlipValue % 10);

Flip Boards

Basic FlipWidgets are usually composed in a layout, this package provides a few configurable compositions of FlipWidgets of the same type and orientation, sometimes varying some elements direction within that axis orientation.

All these composed widgets are described below and explored in the examples folder.

Flip Matrix Board

There two classes of FlipMatrixBoard that animate the display in a matrix of FlipWidgets. The first class displays a single child, an image in the given example. The second class animates the display of a stream of items, also given as a stream of images in the example below.

The board is configured with the number of rows and columns, flipping orientation and animation speed and delays parameters.

  • FlipMatrixBoardSingleChild

    Widget get _flipImage =>
      Container(
        decoration: BoxDecoration(
          border: Border.all(width: 3.0, color: Colors.red[900]!),
        ),
        child: FlipMatrixBoardSingleChild.assetImage(
          imageName: 'assets/horizontal/dart-frog.jpg',
          backgroundColor: Colors.black,
          axis: Axis.vertical,
          width: 364.0,
          height: 205.0,
          columnCount: 8,
          rowCount: 4,
        ),
      );
  • FlipMatrixBoardStream

    Widget get _flipWidget =>
      Container(
        decoration: BoxDecoration(border: Border.all(color: Colors.blue)),
        child: FlipMatrixBoardStream<String>(
          itemStream: _controller.stream,
          itemBuilder: _itemBuilder,
          axis: Axis.vertical,
          width: 375.0,
          height: 200.0,
          columnCount: 8,
          rowCount: 4,
        ),
      );

Flip Clock

FlipClock will default to Theme colors but can be further customized through constructor parameters.

The default flip direction is AxisDirection.down and the default animation curve is a custom curve that acceletares like gravity and bounces back at the end (like a mechanical bang).

In the example below some colors are inherited by a parent ThemeData from the amber color scheme. While some colors are defined in the constructor invocation:

  Widget _flipClock(ColorScheme colors) =>
    Container(
      decoration: BoxDecoration(
        color: colors.onPrimary,
        borderRadius: const BorderRadius.all(Radius.circular(8.0)),
      ),
      padding: const EdgeInsets.all(16.0),
      child: FlipClock(
        digitSize: 54.0,
        width: 46.0,
        height: 62.0,
        separatorColor: colors.primary,
        hingeColor: Colors.black,
        showBorder: true,
      ),
    );

Flip Countdown Clock

FlipCountdownClock is similar, it requires a duration parameter and may be configured with an onDone callback function.

Countdown default flip direction is AxisDirection.up, the opposite of FlipClock, with no panel bang animation.

In the following example most colors are configured with constructor parameters:

  Widget _flipCountdown(ColorScheme colors) => 
    Container(
      decoration: BoxDecoration(
        color: colors.secondary,
        borderRadius: BorderRadius.circular(8.0),
      ),
      padding: const EdgeInsets.all(24.0),
      child: FlipCountdownClock(
        duration: const Duration(minutes: 1),
        digitSize: 54.0,
        width: 46.0,
        height: 62.0,
        digitColor: colors.surface,
        backgroundColor: colors.onSurface,
        separatorColor: colors.onSurface,
        borderColor: colors.primary,
        hingeColor: colors.surface,
        borderRadius: const BorderRadius.all(Radius.circular(8.0)),
        onDone: () => print('Buzzzz!'),
      ),
    );

Flip Frase Board

This composed widget displays a Frase Board that will animate each letter up to the the given frase letters.

Flip type, initial and end colors, delays and more are all customized at constructor level. Check the class documentation for a run over all configurations.

The provided example looks like this:

This page displays a variety of frase boards, one of them would be constructed like this:

  Widget _flipFraseBoard(FlipType type, Axis axis, String frase) =>
    FlipFraseBoard(
      flipType: type,
      axis: axis,
      startLetter: 'A',
      endFrase: frase,
      fontSize: 30.0,
      hingeWidth: 0.6,
      hingeColor: Colors.black,
      borderColor: Colors.black,
      endColors: _flipEndColors,
      letterSpacing: 2.0,
    );

Game

We created a simple game to use a FlipWidget in a more complex context. Check the code in the example folder to see the complete implementation.

Uhaaa! Flip Game

Flip cards untill you make all three cards match the same painting.

There are two valid actions:

  • a first tap on a card: will flip that card
  • a second consecutive tap on a card: wil flip the other two cards
Can you win? Good luck!

카테고리

의존성

의존성 목록 1 개

소스 저장소

이 패키지를 사용하는 프로젝트