# GF Appbar
An app bar consists of a toolbar and potentially other widgets, such as a GFTabBar and FlexibleSpaceBar. The GFAppBar displays the toolbar widgets, leading, title, and actions, above.
# Appbar Info
# Usage
The simple code of a basic GFAppbar is as shown below.
import 'package:getwidget/getwidget.dart';
GFAppBar(
leading: GFIconButton(
icon: Icon(
Icons.message,
color: Colors.white,
),
onPressed: () {},
type: GFButtonType.transparent,
),
title: Text("GF Appbar"),
actions: <Widget>[
GFIconButton(
icon: Icon(
Icons.favorite,
color: Colors.white,
),
onPressed: () {},
type: GFButtonType.transparent,
),
],
),
# GFAppbar with SearchBar
If searchBar is true, it displays search bar textfield in the title space of the appbar with leading, trailing options.
import 'package:getwidget/getwidget.dart';
GFAppBar(
leading: GFIconButton(
icon: Icon(
Icons.message,
color: Colors.white,
),
onPressed: () {},
type: GFButtonType.transparent,
),
searchBar: true,
title: Text("GF Appbar"),
actions: <Widget>[
GFIconButton(
icon: Icon(
Icons.favorite,
color: Colors.white,
),
onPressed: () {},
type: GFButtonType.transparent,
),
],
),
# GFAppbar with Segmented Tabs
Segmented tabs can also be used inside the Appbar. In the title field of the Appbar just define the Segmented tab code and the work will be done. Below code shows a simple segmented tab inside Appbar
import 'package:getwidget/getwidget.dart';
TabController tabController;
void initState() {
super.initState();
tabController = TabController(length: 3, vsync: this);
}
void dispose() {
tabController.dispose();
super.dispose();
}
return Scaffold(
appBar: GFAppBar(
backgroundColor: GFColors.getGFColor(GFColor.dark),
title: GFSegmentTabs(
tabController: tabController,
tabBarColor: GFColors.getGFColor(GFColor.light),
labelColor: GFColors.getGFColor(GFColor.white),
unselectedLabelColor: GFColors.getGFColor(GFColor.dark),
indicator: BoxDecoration(
color: GFColors.getGFColor(GFColor.dark),
),
indicatorPadding: EdgeInsets.all(8.0),
indicatorWeight: 2.0,
border: Border.all(color: Colors.white, width: 1.0),
initialIndex: 0,
length: 3,
tabs: <Widget>[
Text(
"Tab1",
),
Text(
"Tab2",
),
Text(
"Tab3",
),
],
),
),
body: GFTabBarView(controller: tabController, children: <Widget>[
Center(
child: Text('Tab 1'),
),
Center(
child: Text('Tab 2'),
),
Center(
child: Text('Tab 3'),
),
]),
);
Look and feel of the GFAppbar search bar can be customized using the GFAppbar properties.
# Custom Properties
Name | Description |
---|---|
searchBar | If true, displays search bar in the title space |
searchHintText | It takes text to displays the search bar hint text |
searchHintStyle | It styles the [searchHintText] |
searchTextStyle | It styles the search text |
searchBarColorTheme | It defines the search bar icons color theme |
searchController | Controls the text being edited. If null, this widget will create its own [TextEditingController] |
onChanged | Called when the user initiates a change to the TextField's value: when they have inserted or deleted text |
onSubmitted | Called when the user indicates that they are done editing the text in the field. |
onTap | Called for each distinct tap except for every second tap of a double tap. If the text field is created with enabled false, taps will not be recognized. |
Look and feel of the GFAppbar can be customized using the GFAppbar properties.
# Custom Properties
Name | Description |
---|---|
leading | A widget to display before the [title] |
automaticallyImplyLeading | Controls whether we should try to imply the leading widget if null. If true and [leading] is null, automatically try to deduce what the leading widget should be. If false and [leading] is null, leading space is given to [title]. If leading widget is not null, this parameter has no effect. |
title | The primary widget displayed in the app bar. Typically a [Text] widget containing a description of the current contents of the app. |
actions | Widgets to display after the [title] widget. Typically these widgets are [IconButton]s representing common operations. For less common operations, consider using a [PopupMenuButton] as the last action. |
flexibleSpace | This widget is stacked behind the toolbar and the tab bar. It's height will be the same as the app bar's overall height. |
bottom | This widget appears across the bottom of the app bar. Typically a [TabBar]. Only widgets that implement [PreferredSizeWidget] can be used at the bottom of an app bar. |
elevation | The z-coordinate at which to place this app bar relative to its parent. This controls the size of the shadow below the app bar. The value is non-negative. |
shape | The material's shape as well its shadow. A shadow is only displayed if the [elevation] is greater than zero. |
backgroundColor | The color to change background color of the app bar's material. |
brightness | The brightness of the app bar's material. Typically this is set along with [backgroundColor], [iconTheme], [textTheme]. |
iconTheme | The color, opacity, and size to use for app bar icons. Typically this is set along with [backgroundColor], [brightness], [textTheme]. |
actionsIconTheme | The color, opacity, and size to use for the icons that appear in the appbar's [actions]. This should only be used when the [actions] should be themed differently than the icon that appears in the app bar's [leading] widget. |
textTheme | The typographic styles to use for text in the app bar. Typically this is set along with [brightness] [backgroundColor], [iconTheme]. |
primary | Whether this app bar is being displayed at the top of the screen. If true, the app bar's toolbar elements and [bottom] widget will be padded on top by the height of the system status bar. The layout of the [flexibleSpace] is not affected by the [primary] property. |
centerTitle | Whether the title should be centered. Defaults to being adapted to the current [TargetPlatform]. |
titleSpacing | The spacing around [title] content on the horizontal axis. This spacing is applied even if there is no [leading] content or [actions]. If you want [title] to take all the space available, set this value to 0.0. |
toolbarOpacity | How opaque the toolbar part of the app bar is. A value of 1.0 is fully opaque, and a value of 0.0 is fully transparent. |
bottomOpacity | How opaque the bottom part of the app bar is. A value of 1.0 is fully opaque, and a value of 0.0 is fully transparent. |
preferredSize | A size whose height is the sum of [kToolbarHeight] and the [bottom] widget's preferred height. [Scaffold] uses this size to set its app bar's height. |
searchBar | If true, displays search bar in the title space |
← GF Alert GF SearchBar →