搜尋套件、儲存庫與 APP 分類

backdrop 封面
套件詳情v0.9.1

backdrop

Dart 中的背景實現。(https://material.io/design/components/backdrop.html)

AndroidiOSWebmacOSWindowsLinux
近 30 天下載
1.1萬
喜歡數
601
Pub 分數
150

安裝套件

flutter pub add backdrop

套件介紹

根據套件公開資料產生的選型評估,僅供參考。

Backdrop 是一個 Flutter 套件,實作了 Material Design Backdrop 元件,可讓主內容區域與次要面板(例如抽屜或彈出層)之間實現流暢過渡。它支援具有視差效果的互動式 backdrop 與可自訂動畫。此套件適用於 Android、iOS、Web、macOS、Windows 及 Linux,透過提供直覺導航與分層介面來增強使用者體驗。該套件可使用標準組件模式無縫整合至 Flutter 應用程式中。

適用情境

  • 建立滑動側邊面板
  • 實現帶有視差效果的互動式背景
  • 建構響應式導航抽屜
  • 透過分層佈局增強UI深度
  • 設計以行動裝置為首選的介面元件

主要特色

  • 視差滾動效果
  • 平滑過渡動畫
  • 可自訂的背景行為
  • 支援多個平台
  • 內建手勢處理
  • 可擴充的元件結構

適合對象

  • 行動應用程式開發者
  • 使用 Material Design 的 UI/UX 設計師
  • 需要層級導航的應用
  • 開發複雜底部表單的開發者
  • 專注於精緻使用者互動的團隊

使用建議

  • 需要了解 Flutter 的動畫系統
  • 可能影響低階裝置的效能
  • 需要仔細設計以避免雜亂
  • 超出基本設定的自訂功能有限
  • 最適合特定的佈局模式,而非一般使用

原始 README

以下為關聯原始碼儲存庫的 README 原文快照,最新內容請造訪原始碼儲存庫。

Flutter Community: backdrop

backdrop

pub.dev ci Demo Awesome Flutter Gitter All Contributors pub points popularity likes GitHub issues GitHub milestone GitHub stars GitHub forks Gitlab stars Gitlab forks

ARCHIVE NOTE: Backdrop was based on the Material 2 Backdrop specification, which is no longer actively maintained. Material 3 does not include a Backdrop specification. As a result, this package is no longer actively developed and is limited to maintenance and critical fixes.

Backdrop implementation in flutter.

This widget is in active development. Any contribution, idea, criticism or feedback is welcomed.

Quick links

Package https://pub.dev/packages/backdrop
API Docs https://pub.dev/documentation/backdrop/latest/backdrop/backdrop-library.html
Live Demo https://fluttercommunity.github.io/backdrop/demo/#/
Git Repo https://github.com/fluttercommunity/backdrop
Issue Tracker https://github.com/fluttercommunity/backdrop/issues
Chat Room https://gitter.im/flutter-backdrop

Usage

BackdropScaffold

Use BackdropScaffold instead of the standard Scaffold in your app. A backLayer and a frontLayer have to be defined for the backdrop to work.

BackdropScaffold(
  appBar: BackdropAppBar(
    title: Text("Backdrop Example"),
    actions: <Widget>[
      BackdropToggleButton(
        icon: AnimatedIcons.list_view,
      )
    ],
  ),
  backLayer: Center(
    child: Text("Back Layer"),
  ),
  frontLayer: Center(
    child: Text("Front Layer"),
  ),
)
BackdropScaffold example
Navigation with backdrop

To use backdrop for navigation, use the provided BackdropNavigationBackLayer as backLayer.

The BackdropNavigationBackLayer contains a property items representing the list elements shown on the back layer. The front layer has to be "manually" set depending on the current index, which can be accessed with the onTap callback.

int _currentIndex = 0;
final List<Widget> _pages = [Widget1(), Widget2()];

@override
Widget build(BuildContext context) {
  return MaterialApp(
    title: 'Backdrop Demo',
    home: BackdropScaffold(
      appBar: BackdropAppBar(
        title: Text("Navigation Example"),
        actions: <Widget>[
          BackdropToggleButton(
            icon: AnimatedIcons.list_view,
          )
        ],
      ),
      stickyFrontLayer: true,
      frontLayer: _pages[_currentIndex],
      backLayer: BackdropNavigationBackLayer(
        items: [
          ListTile(title: Text("Widget 1")),
          ListTile(title: Text("Widget 2")),
        ],
        onTap: (int position) => {setState(() => _currentIndex = position)},
      ),
    ),
  );
}
BackdropNavigationScaffold example
Accessing underlying backdrop functionalities

To access backdrop related functionalities, use Backdrop.of(context) to get underlying BackdropScaffoldState.

BackdropScaffoldState exposes various properties and methods like:

  • properties
    • animationController -> AnimationController
    • scaffoldKey -> GlobalKey<ScaffoldState>
    • isBackLayerConcealed -> bool
    • isBackLayerRevealed -> bool
  • methods
    • fling()
    • concealBackLayer()
    • revealBackLayer()

Note: Backdrop is an InheritedWidget and therefore like Scaffold.of, Theme.of and MediaQuery.of, the BuildContext context passed to Backdrop.of(context) should be of a Widget that is under the BackdropScaffold in the "widget tree". In other words, Backdrop.of called inside a widget where the BackdropScaffold is initalized will not work explicitly, since the context passed is of the widget that will build BackdropScaffold therefore above BackdropScaffold. This can be solved by either making a seperate Widget where Backdrop.of needs to be used and make it the "child" of BackdropScaffold or wrap the Backdrop.of usage around Builder widget so that the "correct" context (from Builder) is passed to Backdrop.of. This answere on SO and FWotW video on Builder gives a very good idea of how and why Builder works in later case.

For more information, check out sample code in the example directory, demo app with use-cases and code for it and API references generated by pub.dev.

Contribute

Check proposal documents for v1.0 and web&desktop milestones before you begin with any contibution.

  1. You'll need a GitHub account.
  2. Fork the repository.
  3. Pick an issue to work on from issue tracker.
  4. Implement it.
  5. Send merge request.
  6. Star this project.
  7. Become a hero!!

Features and bugs

Please file feature requests and bugs at the issue tracker.

Contributors ✨

Thanks goes to these wonderful people (emoji key):

Harsh Bhikadia
Harsh Bhikadia

💻 🤔 👀 📖 🚇 🚧
Felix
Felix

💻 📖 🐛 👀 💡 🚇 🚧
Bringmos
Bringmos

🐛
Greg Spencer
Greg Spencer

🐛
Jorge A Peroza M
Jorge A Peroza M

🐛 💻
Matt Newell
Matt Newell

🐛
Daniel Borges
Daniel Borges

🐛 💻
Felix Wortmann
Felix Wortmann

💻 👀 🐛
Pierre Grimaud
Pierre Grimaud

📖
Вадим
Вадим

💻
Danial Agh
Danial Agh

🐛
PembaTamang
PembaTamang

🐛
hassan
hassan

🐛
Yaroslav Pronin
Yaroslav Pronin

🐛 💻 👀
Enikuomehin Adejuwon
Enikuomehin Adejuwon

💻
Nwachi ifeanyichukwu Victor
Nwachi ifeanyichukwu Victor

💻
mockturtl
mockturtl

💻 📖 🐛
ritar
ritar

🐛
LorenzoVianello
LorenzoVianello

🐛
Scott
Scott

💻
Sachin Dahal
Sachin Dahal

📖
Jan Hendrych
Jan Hendrych

🐛
Pascal Wild
Pascal Wild

🐛
Jens Reinemuth
Jens Reinemuth

💻
tobolski
tobolski

🐛
Mahdi Pishguy
Mahdi Pishguy

🐛

This project follows the all-contributors specification. Contributions of any kind welcome!

所屬分類

原始碼儲存庫

使用此套件的專案