Xamarin-SmoothBottomBar 1.7.9

dotnet add package Xamarin-SmoothBottomBar --version 1.7.9

NuGet\Install-Package Xamarin-SmoothBottomBar -Version 1.7.9

This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.

<PackageReference Include="Xamarin-SmoothBottomBar" Version="1.7.9" />

For projects that support PackageReference, copy this XML node into the project file to reference the package.

paket add Xamarin-SmoothBottomBar --version 1.7.9

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

#r "nuget: Xamarin-SmoothBottomBar, 1.7.9"

#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.

// Install Xamarin-SmoothBottomBar as a Cake Addin
#addin nuget:?package=Xamarin-SmoothBottomBar&version=1.7.9

// Install Xamarin-SmoothBottomBar as a Cake Tool
#tool nuget:?package=Xamarin-SmoothBottomBar&version=1.7.9

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

Preview

alternate text is missing from this package README image

Design Credits

All design and inspiration credits belong to Alejandro Ausejo.

Usage

Create menu.xml under your res/menu/ folder

<?xml version="1.0" encoding="utf-8"?>
<menu xmlns:android="http://schemas.android.com/apk/res/android">

    <item
        android:id="@+id/item0"
        android:title="@string/menu_dashboard"
        android:icon="@drawable/ic_dashboard_white_24dp"/>

    <item
        android:id="@+id/item1"
        android:title="@string/menu_leaderboard"
        android:icon="@drawable/ic_multiline_chart_white_24dp"/>

    <item
        android:id="@+id/item2"
        android:title="@string/menu_store"
        android:icon="@drawable/ic_store_white_24dp"/>

    <item
        android:id="@+id/item3"
        android:title="@string/menu_profile"
        android:icon="@drawable/ic_person_outline_white_24dp"/>

</menu>

Add view into your layout file

<me.ibrahimsn.lib.SmoothBottomBar
    android:id="@+id/bottomBar"
    android:layout_width="match_parent"
    android:layout_height="70dp"
    app:backgroundColor="@color/colorPrimary"
    app:menu="@menu/menu_bottom"/>

Coupled with the Navigation Component from the Android Jetpack, SmoothBottomBar offers easier navigation within your application by designating navigation to the Navigation Component. This works best when using fragments, as the Navigation component helps to handle your fragment transactions.

Setup Navigation Component i.e. Add dependency to your project, create a Navigation Graph, etc.
For each Fragment in your Navigation Graph, ensure that the Fragment's id is the same as the MenuItems in your Menu i.e res/menu/ folder

<?xml version="1.0" encoding="utf-8"?>
<menu xmlns:android="http://schemas.android.com/apk/res/android">

    <item
        android:id="@+id/first_fragment"
        android:title="@string/menu_dashboard"
        android:icon="@drawable/ic_dashboard_white_24dp"/>

    <item
        android:id="@+id/second_fragment"
        android:title="@string/menu_leaderboard"
        android:icon="@drawable/ic_multiline_chart_white_24dp"/>

    <item
        android:id="@+id/third_fragment"
        android:title="@string/menu_store"
        android:icon="@drawable/ic_store_white_24dp"/>

    <item
        android:id="@+id/fourth_fragment"
        android:title="@string/menu_profile"
        android:icon="@drawable/ic_person_outline_white_24dp"/>

</menu>

Navigation Graph i.e res/navigation/ folder

<?xml version="1.0" encoding="utf-8"?>
<navigation xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:id="@+id/nav_graph"
    app:startDestination="@id/first_fragment">

    <fragment
        android:id="@+id/first_fragment"
        android:name="[YOUR_NAMESPACE].FirstFragment"
        android:label="First Fragment"
        tools:layout="@layout/fragment_first" />
    <fragment
        android:id="@+id/second_fragment"
        android:name="[YOUR_NAMESPACE].SecondFragment"
        android:label="Second Fragment"
        tools:layout="@layout/fragment_second" />
    <fragment
        android:id="@+id/third_fragment"
        android:name="[YOUR_NAMESPACE].ThirdFragment"
        android:label="Third Fragment"
        tools:layout="@layout/fragment_third" />
    <fragment
        android:id="@+id/fourth_fragment"
        android:name="[YOUR_NAMESPACE].FourthFragment"
        android:label="Fourth Fragment"
        tools:layout="@layout/fragment_fourth" />
</navigation>

In your activity i.e MainActivity, override onCreateOptionsMenu, get a reference to your SmoothBottomBar and call setupWithNavController() which takes in a Menu and NavController on the SmoothBottomBar.

public override bool OnCreateOptionsMenu(IMenu menu)
{
	MenuInflater.Inflate(Resource.Menu.menu_bottom, menu);
	if (menu != null)
	{
		BottomBar.SetupWithNavController(menu, NavController);
	}

	return true;
}

You can also set up your ActionBar with the Navigation Component

private NavController NavController;
private SmoothBottomBar BottomBar;
protected override void OnCreate(Bundle savedInstanceState)
{
	try
	{
		base.OnCreate(savedInstanceState);
		Xamarin.Essentials.Platform.Init(this, savedInstanceState);
		// Set our view from the "main" layout resource
		SetContentView(Resource.Layout.activity_main);
		BottomBar = FindViewById<SmoothBottomBar>(Resource.Id.bottomBar);
		NavController = Navigation.FindNavController(this, Resource.Id.main_fragment);
	}
	catch (System.Exception ex)
	{

	}
}

Result:

alternate text is missing from this package README image

Customization

<me.ibrahimsn.lib.SmoothBottomBar
        android:id="@+id/bottomBar"
        android:layout_width="match_parent"
        android:layout_height="70dp"
        app:menu=""
        app:backgroundColor=""
        app:indicatorColor=""
        app:indicatorRadius=""
        app:sideMargins=""
        app:itemPadding=""
        app:textColor=""
        app:itemFontFamily=""
        app:textSize=""
        app:iconSize=""
        app:iconTint=""
        app:iconTintActive=""
        app:activeItem=""
        app:duration="" />