Home

Awesome

Floating Action Button

Build Status

A circular button made of paper that lifts and emits ink reactions on press.

This widget supports two sizes according to Promoted Actions pattern: normal and mini.

Like an ImageView this widget require android:src attribute. According to official documentation this drawable should be not more than 24dp.

JavaDoc is here.

Gradle dependency

dependencies {
    compile 'com.shamanland:fab:0.0.8'
}

Screenshots

light dark between

Show/hide when user scrolls down/up

Set custom OnTouchListener for scrollable view:

import com.shamanland.fab.FloatingActionButton;
import com.shamanland.fab.ShowHideOnScroll;

// ...

FloatingActionButton fab = (FloatingActionButton) findViewById(R.id.fab);

ListView listView = (ListView) findViewById(android.R.id.list);
listView.setOnTouchListener(new ShowHideOnScroll(fab));

With custom animations:

listView.setOnTouchListener(new ShowHideOnScroll(fab, R.anim.custom_show, R.anim.custom_hide));

Customizing

Use theme to customize all floating buttons in your app:

Declare own style:

<style name="AppTheme.Fab" parent="FloatingActionButton">
    <item name="floatingActionButtonColor">@color/my_fab_color</item>
</style>

Link this style in your theme:

<style name="AppTheme" parent="android:Theme">
    <item name="floatingActionButtonStyle">@style/AppTheme.Fab</item>
</style>

Customizing in layout.xml:

<com.shamanland.fab.FloatingActionButton
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:src="@drawable/ic_action_my"
    app:floatingActionButtonColor="@color/my_fab_color"
    app:floatingActionButtonSize="mini"
    />

Customizing in java-code:

FloatingActionButton fab = (FloatingActionButton) findViewById(R.id.fab);
fab.setSize(FloatingActionButton.SIZE_MINI);
fab.setColor(Color.RED);
// NOTE invoke this method after setting new values!
fab.initBackground();
// NOTE standard method of ImageView
fab.setImageResource(R.drawable.ic_action_my);

Using of android:elevation attribute

By default FloatingActionButton sets elevation implicitly for API level 21 and higher.

In order to disable implicit behavior use attribute app:floatingActionButtonImplicitElevation="false".

<com.shamanland.fab.FloatingActionButton
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:src="@drawable/ic_action_my"
    android:elevation="5dp"
    app:floatingActionButtonImplicitElevation="false"
    />

License

Copyright 2014 ShamanLand.Com

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.