• 设为首页
  • 点击收藏
  • 手机版
    手机扫一扫访问
    迪恩网络手机版
  • 关注官方公众号
    微信扫一扫关注
    公众号

leinardi/FloatingActionButtonSpeedDial: A Floating Action Button Speed Dial impl ...

原作者: [db:作者] 来自: 网络 收藏 邀请

开源软件名称(OpenSource Name):

leinardi/FloatingActionButtonSpeedDial

开源软件地址(OpenSource Url):

https://github.com/leinardi/FloatingActionButtonSpeedDial

开源编程语言(OpenSource Language):

Java 83.3%

开源软件介绍(OpenSource Introduction):

Floating Action Button Speed Dial

Maven Central Compose Maven Central View Travis GitHub license Stars

Android library providing an implementation of the Material Design Floating Action Button Speed Dial for both classic View and Compose.

Features

  • MinSdk 14 for Classic View and 21 for Compose
  • Highly customizable (label, icon, ripple, fab and label background colors, themes support)
  • Same animations as in Inbox by Gmail
  • Option to have different icons for open/close state
  • Optional overlay/touch guard layout
  • Support for bottom, left and right menu expansion (left and right have no labels)
  • Out-of-the box support for Snackbar behavior
  • Optional support for RecyclerView and NestedScrollView behavior
  • Support for VectorDrawable
  • Easy to use
  • Compose ready!

How to use

Gradle setup

Official releases

The library is available on Jcenter so no additional repository is required.

Dependencies entry (latest version on Maven Central Maven Central Compose Maven Central View):

// Compose only
implementation "com.leinardi.android:speed-dial.compose:1.0.0-alpha04"

// Classic View only
implementation "com.leinardi.android:speed-dial:3.3.0"

Snapshots (development branch)

You can use JitPack to test the latest master (remember that master is the development branch and can be unstable or completely broken).

Add the JitPack repository to your build file:

maven { url 'https://jitpack.io' }

Add the dependency

implementation 'com.github.leinardi:FloatingActionButtonSpeedDial:master-SNAPSHOT'

Basic use for Compose

SpeedDial

Add the SpeedDial() Composable to the floatingActionButton of your Scaffold:

var speedDialState by rememberSaveable { mutableStateOf(SpeedDialState.Collapsed) }
var overlayVisible: Boolean by rememberSaveable { mutableStateOf(speedDialState.isExpanded()) }
Scaffold(
    floatingActionButton = {
        SpeedDial(
            state = speedDialState,
            onFabClick = { expanded ->
                overlayVisible = !expanded
                speedDialState = SpeedDialState(!expanded)
            },
        ) {

        }
    }
) {
    SpeedDialOverlay(
        visible = overlayVisible,
        onClick = {
            overlayVisible = false
            speedDialState = speedDialState.toggle()
        },
    )
}

Action items

Add the FabWithLabel items to the SpeedDial:

 SpeedDial(
    state = speedDialState,
    onFabClick = { expanded ->
        overlayVisible = !expanded
        speedDialState = SpeedDialState(!expanded)
    },
) {
    item {
        FabWithLabel(
            onClick = { showToast(context, "Item 1 clicked!") },
            labelContent = { Text(text = "Item 1") },
        ) {
            Icon(Icons.Default.Share, null)
        }
    }
    item {
        FabWithLabel(
            onClick = { showToast(context, "Item 2 clicked!") },
            labelContent = { Text(text = "Item 2") },
        ) {
            Icon(Icons.Default.Share, null)
        }
    }
}

Basic use for Classic View

SpeedDialView

Add the SpeedDialView to your layout:

<com.leinardi.android.speeddial.SpeedDialView android:id="@+id/speedDial" android:layout_width="wrap_content" android:layout_height="wrap_content" android:layout_gravity="bottom|end" app:sdMainFabClosedSrc="@drawable/ic_add_white_24dp" />

Action items

Add the items to the SpeedDialView:

val speedDialView = findViewById<SpeedDialView>(R.id.speedDial)
speedDialView.addActionItem(
    SpeedDialActionItem.Builder(R.id.fab_no_label, R.drawable.ic_link_white_24dp)
        .create()
)

If the color customization is not requested, it is also possible to inflate the Action items form a Menu Resource:

speedDialView.inflate(R.menu.menu_speed_dial)

Only the attributes android:id, android:icon and android:title are supported.

Click listeners

Add the click listeners:

speedDialView.setOnActionSelectedListener(SpeedDialView.OnActionSelectedListener { actionItem ->
    when (actionItem.id) {
        R.id.fab_no_label -> {
            showToast("No label action clicked!\nClosing with animation")
            speedDialView.close() // To close the Speed Dial with animation
            return@OnActionSelectedListener true // false will close it without animation
        }
    }
    false
})

Optional steps

Add the main action click listener

speedDialView.setOnChangeListener(object : SpeedDialView.OnChangeListener {
    override fun onMainActionSelected(): Boolean {
        showToast("Main action clicked!")
        return false // True to keep the Speed Dial open
    }

    override fun onToggleChanged(isOpen: Boolean) {
        Log.d(TAG, "Speed dial toggle state changed. Open = $isOpen")
    }
})

Customizing the items

The SpeedDialActionItem.Builder provides several setters to customize the aspect of one item:

speedDialView.addActionItem(
    SpeedDialActionItem.Builder(R.id.fab_custom_color, drawable)
        .setFabBackgroundColor(ResourcesCompat.getColor(getResources(), R.color.material_white_1000, getTheme()))
        .setFabImageTintColor(ResourcesCompat.getColor(getResources(), R.color.inbox_primary, getTheme()))
        .setLabel(getString(R.string.label_custom_color))
        .setLabelColor(Color.WHITE)
        .setLabelBackgroundColor(ResourcesCompat.getColor(getResources(), R.color.inbox_primary, getTheme()))
        .setLabelClickable(false)
        .create()
)

Is is also possible to specify a theme to easily change the FAB background and ripple effect color:

speedDialView.addActionItem(
    SpeedDialActionItem.Builder(R.id.fab_custom_theme, R.drawable.ic_theme_white_24dp)
        .setLabel(getString(R.string.label_custom_theme))
        .setTheme(R.style.AppTheme_Purple)
        .create()
)
<style name="AppTheme.Purple" parent="AppTheme">
    <item name="colorPrimary">@color/material_purple_500</item>
    <item name="colorPrimaryDark">@color/material_purple_700</item>
    <item name="colorAccent">@color/material_purple_a700</item>
    <item name="colorControlHighlight">@color/material_purple_200</item>
</style>

Adding an overlay/touch guard when the menu is open (like Inbox by Gmail)

You simply need to add the SpeedDialOverlayLayout to your layout:

<com.leinardi.android.speeddial.SpeedDialOverlayLayout android:id="@+id/overlay" android:layout_width="match_parent" android:layout_height="match_parent" />

and then provide the instance of that layout to the SpeedDialView:

<com.leinardi.android.speeddial.SpeedDialView android:id="@+id/speedDial" android:layout_width="wrap_content" android:layout_height="wrap_content" app:sdMainFabClosedSrc="@drawable/ic_add_white_24dp" app:sdOverlayLayout="@id/overlay" />

or

val overlayLayout = findViewById<SpeedDialOverlayLayout>(R.id.overlay)
speedDialView.setSpeedDialOverlayLayout(overlayLayout)

Hiding the FAB when scrolling a RecyclerView or a NestedScrollView

Just apply the ScrollingViewSnackbarBehavior to the SpeedDialView. This can be done via XML using the convenience string resource @string/speeddial_scrolling_view_snackbar_behavior:

<com.leinardi.android.speeddial.SpeedDialView android:id="@+id/speedDial" android:layout_width="wrap_content" android:layout_height="wrap_content" app:layout_behavior="@string/speeddial_scrolling_view_snackbar_behavior" />

Or programmatically:

val params = speedDialView.layoutParams as CoordinatorLayout.LayoutParams
params.behavior = SpeedDialView.ScrollingViewSnackbarBehavior()
speedDialView.requestLayout()

NB: for the behaviors to work, SpeedDialView needs to be a direct child of CoordinatorLayout

Disabling SnackbarBehavior

Since the SnackbarBehavior is enabled by default and, afaik, it is not possible to remove a Behavior, simply use apply the SpeedDialView.NoBehavior instead:

val params = speedDialView.layoutParams as CoordinatorLayout.LayoutParams
params.behavior = SpeedDialView.NoBehavior()
speedDialView.requestLayout()

Sample project

A fully working example is available here.

Demo

Video

https://www.youtube.com/watch?v=tWowiF5ElAg

Sample app

Get it on the Play Store

Screenshots

API 27, API 16, bottom and left expansion

FAQ

How can I create a new resource ID, required by the SpeedDialActionItem.Builder?

It can be done in XML using the <item type="id" />:

<resources>
    <item name="fab_action1" type="id" />
    <item name="fab_action2" type="id" />
    <item name="fab_action3" type="id" />
    <item name="fab_action4" type="id" />
</resources>

How can I change the maximum length of the label?

You can set a different value for the max length of the label overriding sd_label_max_width:

<dimen name="sd_label_max_width">240dp</dimen>

More info here.

How can I change the color of the overlay / touch guard layout?

The color of the SpeedDialOverlayLayout can be changed simply using the android:background attribute or, programmatically, using the equivalent setter like any other view.

How can I prevent the overlay / touch guard layout from going over the Toolbar inside a CoordinatorLayout?

It can be done using the attribute app:layout_behavior="@string/appbar_scrolling_view_behavior":

<com.leinardi.android.speeddial.SpeedDialOverlayLayout android:id="@+id/overlay" android:layout_width="match_parent" android:layout_height="match_parent" app:layout_behavior="@string/appbar_scrolling_view_behavior" />

Changelog

See the CHANGELOG.md

Credits

This project is based on floating-action-menu by ArthurGhazaryan.

Licenses

Copyright 2021 Roberto Leinardi.

Licensed to the Apache Software Foundation (ASF) under one or more contributor
license agreements.  See the NOTICE file distributed with this work for
additional information regarding copyright ownership.  The ASF licenses this
file to you 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.



鲜花

握手

雷人

路过

鸡蛋
该文章已有0人参与评论

请发表评论

全部评论

专题导读
上一篇:
Material Design发布时间:2022-08-17
下一篇:
dbtek/paper: A gentle theme for Jekyll utilising material design.发布时间:2022-08-17
热门推荐
阅读排行榜

扫描微信二维码

查看手机版网站

随时了解更新最新资讯

139-2527-9053

在线客服(服务时间 9:00~18:00)

在线QQ客服
地址:深圳市南山区西丽大学城创智工业园
电邮:jeky_zhao#qq.com
移动电话:139-2527-9053

Powered by 互联科技 X3.4© 2001-2213 极客世界.|Sitemap