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

floating_overlay 표지
패키지 상세v1.2.1

floating_overlay

부유형 위젯을 드래그하고 확대/축소할 수 있도록 해주는 위젯 래퍼입니다.

AndroidiOSWebmacOSWindowsLinux
30일 다운로드
447
좋아요
47
Pub 점수
150

패키지 설치

flutter pub add floating_overlay

패키지 개요

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

floating_overlay 패키지는 부유하는 위젯을 상호작용적으로 드래그하고 크기를 조절할 수 있도록 해주는 위젯 래퍼를 제공합니다. 팝업 패널, 드래그 가능한 도구 또는 플로팅 액션 영역과 같은 이동 가능한 UI 요소를 만들기에 이상적입니다. 이 패키지는 Android, iOS, Web, macOS, Windows, Linux 등 여러 플랫폼을 지원하며 장치 간 일관된 동작을 보장합니다. Flutter로 구축되어 기존 레이아웃에 원활하게 통합되며 반응형 터치 및 포인터 인터랙션을 제공합니다. 불필요한 종속성 없이 핵심 기능에 집중하는 가벼운 설계입니다.

사용 사례

  • 드래그 가능한 팝업 패널
  • 플로팅 도구 모음
  • 인터랙티브 오버레이
  • 크기 조절 가능한 UI 컴포넌트
  • 사용자 지정 플로팅 창

주요 기능

  • 드래그 가능한 위치 지정
  • 확장 가능한 콘텐츠
  • 크로스 플랫폼 지원
  • 간단한 API 통합
  • 포인터 상호작용 처리

적합한 대상

  • 인터랙티브 UI를 구축하는 개발자
  • 이동 가능한 오버레이가 필요한 앱
  • 디자이너가 부유하는 요소를 프로토타이핑하고 있습니다
  • 다중 플랫폼 플러터 앱
  • 사용자 조작이 필요한 UI 컴포넌트

고려 사항

  • 모서리 제약 조건을 수동으로 처리해야 합니다
  • 충돌 감지에 추가 로직이 필요할 수 있습니다
  • 성능은 오버레이의 복잡도에 따라 달라집니다
  • 정적 오버레이에 적합하지 않습니다
  • 제한된 내장 애니메이션

원본 README

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

A widget wrapper that allows a floating widget be dragged and rescaled.

Features

  • Floating widget on top of the screen
  • Resizing and repositioning the floating widget
  • Constrainable space to float inside the tree (optional)
  • Limiting borders with padding
  • State managment when pushing and poping screens (needs the RouteObserver for managing push)

FloatingOverlay

Getting started

Add to your pubspec.yaml file:

dependencies:
  flutter:
    sdk: flutter
  floating_overlay: ^1.2.1

Import the package

import 'package:floating_overlay/floating_overlay.dart';

Usage

Create a FloatingOverlayController

final controller = FloatingOverlayController.absoluteSize(
  maxSize: const Size(200, 200),
  minSize: const Size(100, 100),
  start: Offset.zero,
  padding: const EdgeInsets.all(20.0),
  constrained: true,
);

or

final controller = FloatingOverlayController.relativeSize(
  maxScale: 2.0,
  minScale: 1.0,
  start: Offset.zero,
  padding: const EdgeInsets.all(20.0),
  constrained: true,
);

Insert the FloatingOverlay widget inside your widget tree and give it the controller, a child and a floatingChild.

FloatingOverlay(
  controller: controller,
  floatingChild: SizedBox.square(
    dimension: 100.0,
    child: Container(
      decoration: BoxDecoration(
        color: Theme.of(context).primaryColor,
        border: Border.all(
          color: Colors.black,
          width: 5.0,
        ),
      ),
    ),
  ),
  child: Container(),
);

Then use the controller to make the floating child show or hide.

controller.hide();
controller.isFloating;
controller.show();
controller.toggle();

카테고리

의존성

의존성 목록 3 개

소스 저장소

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

아직 데이터가 없습니다.