fab-speed-dial

To assign different colors to each mini FAB in the list:

1. Define an <integer-array> resource containing the desired colors.
2. In your menu.xml, ensure every <item> has an android:orderInCategory attribute assigned in the same 0-based order as your color array.
3. Use the app:miniFabTitleTextColorList and app:miniFabBackgroundTintList attributes in your FabSpeedDial XML declaration.

Note: If you use app:miniFabTitleTextColor or app:miniFabBackgroundTint (single values), they will be overridden by the list attributes.

Example color array:

<integer-array name="fab_menu_item_colors">
    <item>@android:color/holo_red_dark</item>
    <item>@android:color/holo_purple</item>
    <item>@android:color/holo_green_light</item>
</integer-array>

<integer-array name="fab_menu_item_colors">
    <!-- A dark Holo shade of red -->
    <item>@android:color/holo_red_dark</item>
    <!-- A Holo shade of purple -->
    <item>@android:color/holo_purple</item>
    <!-- A light Holo shade of green -->
    <item>@android:color/holo_green_light</item>
</integer-array>

To use FabSpeedDial, follow these three steps:

1. Define a menu resource in your res/menu/ directory using standard Android <menu> and <item> tags.
2. Add the FabSpeedDial view to your XML layout.
3. Assign an ID to the FabSpeedDial view. This is critical: if you do not define an ID, the menu's open/closed state will not be persisted during device rotation.

Note on positioning: Use standard Android layout attributes to position the view within its parent ViewGroup, and set the app:fabGravity attribute to ensure correct alignment.

Example XML implementation:

<io.github.yavski.fabspeeddial.FabSpeedDial
    android:id="@+id/fab_speed_dial"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:layout_gravity="bottom|end"
    app:fabGravity="bottom_end"
    app:fabMenu="@menu/menu_main"
    app:miniFabBackgroundTint="@android:color/white"
    app:miniFabDrawableTint="?attr/colorPrimaryDark"
    app:miniFabTitleTextColor="?attr/colorPrimaryDark" />

You can listen for menu preparation and item selection by using setMenuListener with a SimpleMenuListenerAdapter.

Prepare Menu

Use onPrepareMenu(NavigationMenu navigationMenu) to modify menu items or return false to prevent the menu from being displayed at all.

Item Selection

Use onMenuItemSelected(MenuItem menuItem) to respond when a user selects an item from the speed dial.

FabSpeedDial fabSpeedDial = (FabSpeedDial) findViewById(R.id.fab_speed_dial);
fabSpeedDial.setMenuListener(new SimpleMenuListenerAdapter() {
    @Override
    public boolean onPrepareMenu(NavigationMenu navigationMenu) {
        // Modify menu items or return false to hide menu
        return true;
    }

    @Override
    public boolean onMenuItemSelected(MenuItem menuItem) {
        // Handle the selection (e.g., start an activity)
        return false;
    }
});

FabSpeedDial fabSpeedDial = (FabSpeedDial) findViewById(R.id.fab_speed_dial);
fabSpeedDial.setMenuListener(new SimpleMenuListenerAdapter() {
    @Override
    public boolean onPrepareMenu(NavigationMenu navigationMenu) {
        // TODO: Do something with yout menu items, or return false if you don't want to show them
        return true;
    }
});

The following attributes are available for customizing the FabSpeedDial component. Attributes prefixed with fab apply to the main FAB, while those prefixed with miniFab apply to the items in the expanded menu.