FLUTTER ECOSYSTEM

Jellepepe/inkblob_navigation_bar

スムーズでダイナミックなインクブロブ遷移効果を備えたカスタムナビゲーションバー。

inkblob_navigation_bar のプロジェクト画像
Stars
2
Forks
4
最終プッシュ(UTC)
2024/07/15
プロジェクト状態
公開中
Jellepepe GitHub avatar
GITHUB User

Jellepepe ↗

byme.dev
言語DartHTMLJava

このリポジトリが公開するパッケージ

使用している依存関係

依存関係一覧 3 件
  • flutter{"sdk":"flutter"}
  • flutter_test開発用{"sdk":"flutter"}
  • flutter_lints開発用^2.0.0

元の README

以下は英語原文のスナップショットです。最新版は GitHub をご覧ください。

README を開く / 閉じる

Inkblob_navigation_bar

A custom navigation bar with smooth & dynamic ink blob transition effect.

Overview

This packages was inspired by this post from Dribbble

Implemented:
https://raw.githubusercontent.com/jellepepe/inkblob_navigation_bar/master/screenshot/1.gif

Gallery

Dynamic Movement
https://raw.githubusercontent.com/jellepepe/inkblob_navigation_bar/master/screenshot/2.gif
Customizable Curve
https://raw.githubusercontent.com/jellepepe/inkblob_navigation_bar/master/screenshot/3.gif
Custom Colors
https://raw.githubusercontent.com/jellepepe/inkblob_navigation_bar/master/screenshot/4.gif
Optional Titles
https://raw.githubusercontent.com/jellepepe/inkblob_navigation_bar/master/screenshot/5.gif
Works with any widgets
https://raw.githubusercontent.com/jellepepe/inkblob_navigation_bar/master/screenshot/6.gif

How to install

Simply add the package to your dependencies! No other steps required :)

Documentation

To use the InkblobNavigationBar you can simply use it in the bottomNavigationBar field of your material scaffold:

Scaffold(
  ...
  bottomNavigationBar: InkblobNavigationBar(
    ...
  )
)
You can customize these attributes in the navigation bar.
Attributes Type Description Default
showElevation bool Enable subtle shadow effect true
items List<InkblobBarItem> Item data for NavigationBar required
onItemSelected Function(int) Callback function when item tapped null
selectedIndex int Selected item index of navigation bar. required
previousIndex int Previously selected item index of navigation bar. selectedIndex
iconSize double Size of icons. 24.0
backgroundColor Color Background color of [CustomNavigationBar] Theme.bottomAppBarColor
containerHeight double Height of the NavigationBar 60
itemWidth double Total width of each item 2*containerHeight
curve Curve Animation curve of scale effect Curves.easInOutExpo
animationDuration Duration Duration of the total animation Duration(milliseconds: 270)

Attention: Both the selectedIndex and previousIndex are required for the animation to perform, an example of how to implement this is shown in the provided example app.

To customize the items in the navigation bar, just supply a list of InkblobBarItem like this.

InkblobNavigationBar(
  ...
  items: [
    // Simple Icon with a Title & Color
    InkblobBarItem(
      title: const Text('User'),
      filledIcon: const Icon(SpiriIcons.fi_sr_user),
      emptyIcon: const Icon(SpiriIcons.fi_rr_user),
      color: Colors.blue,
    ),
    // Custom Containers
    InkblobBarItem(
      filledIcon: Container(
        decoration: BoxDecoration(
          color: Colors.black,
          borderRadius: BorderRadius.circular(12),
        ),
      ),
      emptyIcon: Container(
        decoration: BoxDecoration(
          borderRadius: BorderRadius.circular(12),
          border: Border.all(color: Colors.black, width: 2),
        ),
      ),
    ),
    // Even Text Widgets
    InkblobBarItem(
      filledIcon: const Text('❤️', style: TextStyle(fontSize: 20)),
      emptyIcon: const Text('🖤', style: TextStyle(fontSize: 20)),
      color: Colors.red,
    ),
  ],
)

Example

Check the example app for a full implementation example.

Contribute

Issues and pull requests are always welcome!
If you found this project helpful, consider buying me a cup of :coffee: