「译文」 design support library第一部分 – 浮动操作按钮

原文:http://davinci42.github.io/AndroidDesignSupportLibrary-1-FAB/ 

本文翻译自 Part 1 – Floating action button

作者 Paresh Mayani


Floating action button (FAB) 是一个带有环状阴影的圆形按键,位于 UI 之上,用于显示常用的操作,比如添加新条目、编写邮件等。

Android Reference 文档中关于 FloatingActionButton 的部分指出,floating button 有两种大小可选:1、普通(56dp);2、迷你(40dp)。

final int getSizeDimension() {
    switch(this.mSize) {
    case 0:
    default:
        return this.getResources().getDimensionPixelSize(dimen.fab_size_normal);
    case 1:
        return this.getResources().getDimensionPixelSize(dimen.fab_size_mini);
    }
}

注意 :

FloatingActionButton 只是一个扩展于 ImageView 的 view。

添加 Android design support library

首先,在 gradle 文件中添加如下一行以添加 Android support library:

compile 'com.android.support:design:22.2.0'

Step 1

在 xml 布局文件中添加 FloatingActionButton。此处假设以下

xmlns:app="http://schemas.android.com/apk/res-auto"

已经在布局文件的开头声明过。

<FrameLayout
    android:id="@+id/layoutInner"
    android:layout_width="match_parent"
    android:layout_height="match_parent">
    <android.support.design.widget.FloatingActionButton
        android:id="@+id/btnFloatingAction"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_gravity="bottom|right" />
</FrameLayout>

属性介绍

开发者文档中关于 FAB 的部分只包含 FAB 大小属性介绍,以下是其它一些可用属性:

  • FAB 默认使用应用主题中设置的浮起色作为按键背景。你可以使用 app:backgroundTint 属性,或者调用 setBackgroundTintList (ColorStateList tint) 方法改变 FAB 背景色;

  • 如上文中提到的,可以使用 app:fabSize 属性选择普通大小或者迷你大小;

  • 使用 android:src 改变 FAB 对应的 drawable;

  • 使用 app:rippleColor 设置 FAB 按下时的波纹效果;

  • 使用 app:borderWidth 设置 FAB 边框宽度;

  • 使用 app:elevation 设置闲置状态下 FAB 的景深(默认是 6dp);

  • 使用 app:pressedTranslationZ 设置 FAB 按下时的景深(默认是 12dp)。

Step 2

添加以下代码,用以显示带有图片和大小属性的 FAB。

<android.support.design.widget.FloatingActionButton
    android:id="@+id/btnFloatingAction"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:layout_gravity="bottom|right"
    android:src="@drawable/ic_plus"
    app:fabSize="normal"
    app:rippleColor="@android:color/background_dark"/>

Step 3

采用与 ImageView 或 Button 相同的方法,为 FAB 添加点击事件。

FloatingActionButton btnFab = (FloatingActionButton) findViewById(R.id.btnFloatingAction);
btnFab.setOnClickListener(new View.OnClickListener() {
    @Override
    public void onClick(View v) {
        Toast.makeText(MainActivity.this, "Hello FAB!", Toast.LENGTH_SHORT).show();
    }
});

以上!

Issues:

本文编写时,FAB 支持库仍然存在一些 bug,在 Kitkat 和 Lollipop 中分别运行示例代码,可以看到如下结果:

Lollipop 中的 FAB:

Kitkat 中的 FAB:

Issues 1: Android 4.4 和 5.0 中边缘显示

很容易看出,Lollipop 中存在边缘显示的问题。为了解决此问题,API21+ 的版本统一定义底部与右边缘空白为 16dp,Lollipop 以下版本统一设置为 0dp.

values/dimens.xml

<dimen name="fab_margin_right">0dp</dimen>
<dimen name="fab_margin_bottom">0dp</dimen>

values-v21/dimens.xml

<dimen name="fab_margin_right">16dp</dimen>
<dimen name="fab_margin_bottom">16dp</dimen>

布局文件的 FAB 中,也设置相应的值。

<android.support.design.widget.FloatingActionButton
    ...
    ...
    android:layout_marginBottom="@dimen/fab_margin_bottom"
    android:layout_marginRight="@dimen/fab_margin_right"/>

Issues 2: Android 5.0 中阴影显示 
再看一遍上面的截图,会发现 Kitkat 中有阴影显示,而 Lollipop 中并没有。在 Lollipop 上,可以直接在 FAB 中设置:

<android.support.design.widget.FloatingActionButton
    ...
    ...
    app:fabSize="normal"
    app:borderWidth="0dp"
    android:layout_marginBottom="@dimen/fab_margin_bottom"
    android:layout_marginRight="@dimen/fab_margin_right"/>

Issues 3: FAB 中没有旋转动画

Issue3 ID: #176116

Github 源代码下载