搜索插件、代码仓与 APP 分类

convex_bottom_bar 封面
插件详情v3.2.0

convex_bottom_bar

一个 Flutter 包,用于实现 ConvexAppBar,在底部栏中显示凸形标签。支持主题设置。

AndroidiOSWebmacOSWindowsLinux
近 30 天下载
1.8万
喜欢数
2950
Pub 分数
150

安装插件

flutter pub add convex_bottom_bar

插件介绍

基于插件公开信息、社区数据与项目使用情况整理的选型参考。

ConvexBottomBar 是一个 Flutter 包,提供一种视觉上独特的凸形底部导航栏,具有平滑的动画效果和可自定义的主题。它通过提供圆润、动态的标签设计,增强了标准底部导航体验,使其在 Android、iOS、Web、macOS、Windows 和 Linux 平台上脱颖而出。该包支持主题自定义,使开发者能够将栏目的外观与应用的设计语言保持一致。非常适合追求现代、引人入胜的导航界面的应用。

适合场景

  • 现代移动应用导航
  • 可自定义的底部标签
  • 跨平台 UI 一致性
  • 通过视觉设计提升用户参与度
  • 注重美学吸引力的应用程序

主要特点

  • 凸形标签设计
  • 内置动画效果
  • 主题支持
  • 跨平台兼容性
  • 与 Flutter 应用轻松集成
  • 响应式标签交互

适合对象

  • 注重设计的 Flutter 应用程序
  • 旨在实现独特导航的移动应用
  • 想要动画底部栏的开发者
  • 针对多个平台的项目
  • 使用 Flutter 的 UI/UX 设计师

使用建议

  • 可能需要为复杂主题添加额外的样式
  • 对低端设备的性能影响
  • 超出内置选项的自定义功能有限
  • 不适合极简设计
  • 与其他小部件可能存在布局冲突

原始 README

以下为关联源码仓库的 README 原文快照,最新内容请访问源码仓库。

appBar preview

pub.dev github coverage likes popularity build status license

English | 简体中文


The official BottomAppBar can only display a notch FAB with an app bar, and sometimes we need a convex FAB. BottomAppBar and NotchShape's implementation inspires this ConvexAppBar.

Online example can be found at https://appbar.codemagic.app.

convex_bottom_bar is now a Flutter Favorite package!

Here are some supported style:

fixed react badge chip
fixedCircle reactCircle flip
textIn titled tab image
button fixed corner

How to use

Typically ConvexAppBar can work with Scaffold by setup its bottomNavigationBar.

The ConvexAppBar has two constructors. The ConvexAppBar() will use the default style to simplify the tab creation.

Add this to your package's pubspec.yaml file, use the latest version Pub:

dependencies:
  convex_bottom_bar: ^latest_version
import 'package:convex_bottom_bar/convex_bottom_bar.dart';

Scaffold(
  bottomNavigationBar: ConvexAppBar(
    items: [
      TabItem(icon: Icons.home, title: 'Home'),
      TabItem(icon: Icons.map, title: 'Discovery'),
      TabItem(icon: Icons.add, title: 'Add'),
      TabItem(icon: Icons.message, title: 'Message'),
      TabItem(icon: Icons.people, title: 'Profile'),
    ],
    onTap: (int i) => print('click index=$i'),
  )
);

Flutter Version Support
As Flutter is developing fast. There can be breaking changes. We will be trying to support the stable version and beta version through different package versions.

Stable Flutter Version Package Version More
>=3.7.0 >=3.2.0 Since v3.7.0, the stable version changed the DefaultTabController api
>=1.20 >=2.4.0 Since v1.20, the stable version changed the Stack api
<1.20 <=2.3.0 Support for stable version such as v1.17, v1.12 is not going to be updated

Features

  • Provide multiple internal styles
  • Ability to change the theme of AppBar
  • Provide builder API to customize a new style
  • Add badge on the tab menu
  • Elegant transition animation
  • Provide hook API to override some of the internal styles
  • RTL support

Table of contents

Theming

The bar will use default style, you may want to theme it. Here are some supported attributes:

Attributes Description
backgroundColor AppBar background
gradient gradient will override backgroundColor
height AppBar height
color tab icon/text color
activeColor tab icon/text color when selected
curveSize size of the convex shape
top top edge of the convex shape relative to AppBar
cornerRadius draw the background with topLeft and topRight corner; Only work with fixed tab style
style style to describe the convex shape: fixed, fixedCircle, react, reactCircle, ...
chipBuilder custom badge builder, use ConvexAppBar.badge for default badge

Badge

If you need to add a badge on the tab, use the ConvexAppBar.badge to get it done.

badge demo

ConvexAppBar.badge({0: '99+', 1: Icons.assistant_photo, 2: Colors.redAccent},
  items: [
    TabItem(icon: Icons.home, title: 'Home'),
    TabItem(icon: Icons.map, title: 'Discovery'),
    TabItem(icon: Icons.add, title: 'Add'),
  ],
  onTap: (int i) => print('click index=$i'),
);

The badge() method accepts an array of badges; The badges is a map with tab items. Each value of entry can be either String, IconData, Color or Widget.

Single Button

If you only need a single button, checkout the ConvexButton.

button

Scaffold(
  appBar: AppBar(title: const Text('ConvexButton Example')),
  body: Center(child: Text('count $count')),
  bottomNavigationBar: ConvexButton.fab(
    onTap: () => setState(() => count++),
  ),
);

Style Hook

Hook for internal tab style. Unlike the ConvexAppBar.builder, you may want to update the tab style without defining a new tab style.

Warning:
This hook is limited and can lead to overflow broken if the size you provide does not match with internal style.

StyleProvider(
  style: Style(),
  child: ConvexAppBar(
    initialActiveIndex: 1,
    height: 50,
    top: -30,
    curveSize: 100,
    style: TabStyle.fixedCircle,
    items: [
      TabItem(icon: Icons.link),
      TabItem(icon: Icons.import_contacts),
      TabItem(title: "2020", icon: Icons.work),
    ],
    backgroundColor: _tabBackgroundColor,
  ),
)
class Style extends StyleHook {
  @override
  double get activeIconSize => 40;

  @override
  double get activeIconMargin => 10;

  @override
  double get iconSize => 20;

  @override
  TextStyle textStyle(Color color) {
    return TextStyle(fontSize: 20, color: color);
  }
}

RTL Support

RTL is supported internally, and if you define the TextDirection inside the app, the AppBar should work fine. Both RTL and LTR can be configured through Directionality:

Directionality(
  textDirection: TextDirection.rtl,
  child: Scaffold(body:ConvexAppBar(/*TODO ...*/)),
)

Custom Example

If the default style does not match your situation, try with ConvexAppBar.builder(), allowing you to custom nearly all the tab features.

Scaffold(
  bottomNavigationBar: ConvexAppBar.builder(
    count: 5,
    backgroundColor: Colors.blue,
    itemBuilder: Builder(),
  )
);

// user defined class
class Builder extends DelegateBuilder {
  @override
  Widget build(BuildContext context, int index, bool active) {
    return Text('TAB $index');
  }
}

Full custom example can be found at example.

FAQ

Please file feature requests and bugs at the issue tracker.

Donate

You like the package ? Buy me a coffee :)

ko-fi

所属分类

源码仓库

使用此插件的项目

所在榜单