MaterialDesign--(4)SnackBar的使用及其源码分析

Snackbars 与 Toasts

Snackbar 是一种针对操作的轻量级反馈机制,常以一个小的弹出框的形式,出现在手机屏幕下方或者桌面左下方。它们出现在屏幕所有层的最上方,包括浮动操作按钮。

它们会在超时或者用户在屏幕其他地方触摸之后自动消失。Snackbar 可以在屏幕上滑动关闭。当它们出现时,不会阻碍用户在屏幕上的输入,并且也不支持输入。屏幕上同时最多只能现实一个 Snackbar。

Android 也提供了一种主要用于提示系统消息的胶囊状的提示框 Toast。Toast 同 Snackbar 非常相似,但是 Toast 并不包含操作也不能从屏幕上滑动关闭。

SnackBar 的使用及玩转

使用

SnackBar 的基本使用很简单,和 Toast 差不多。

Snackbar.make(view, message_text, duration)
    .setAction(action_text, click_listener)
    .show();

玩转 SnackBar

要玩转 SnackBar,我们得先知道 SnackBar 提供了哪些可定制的方法。一张图看完 SnackBar结构~

SnackBar structure.png

那就根据上图类结构,一个一个分析吧

SnackBar.Callback、setCallback()、removeCallback()以及BaseTransientBottomBar.BaseCallback

/**
 * Callback class for {@link Snackbar} instances.
 *
 * Note: this class is here to provide backwards-compatible way for apps written before
 * the existence of the base {@link BaseTransientBottomBar} class.
 *
 * @see BaseTransientBottomBar#addCallback(BaseCallback)
 */
public static class Callback extends BaseCallback<Snackbar> {
    /** Indicates that the Snackbar was dismissed via a swipe.*/
    public static final int DISMISS_EVENT_SWIPE = BaseCallback.DISMISS_EVENT_SWIPE;
    /** Indicates that the Snackbar was dismissed via an action click.*/
    public static final int DISMISS_EVENT_ACTION = BaseCallback.DISMISS_EVENT_ACTION;
    /** Indicates that the Snackbar was dismissed via a timeout.*/
    public static final int DISMISS_EVENT_TIMEOUT = BaseCallback.DISMISS_EVENT_TIMEOUT;
    /** Indicates that the Snackbar was dismissed via a call to {@link #dismiss()}.*/
    public static final int DISMISS_EVENT_MANUAL = BaseCallback.DISMISS_EVENT_MANUAL;
    /** Indicates that the Snackbar was dismissed from a new Snackbar being shown.*/
    public static final int DISMISS_EVENT_CONSECUTIVE = BaseCallback.DISMISS_EVENT_CONSECUTIVE;

    @Override
    public void onShown(Snackbar sb) {
        // Stub implementation to make API check happy.
    }

    @Override
    public void onDismissed(Snackbar transientBottomBar, @DismissEvent int event) {
        // Stub implementation to make API check happy.
    }
}

SnackBar 继承自BaseTransientBottomBar;
SnackBar.Callback继承自BaseCallback;
就是一个 SnackBar 的 show()方法和 onDisMissed()回调,不多解释了。

Duration枚举和 setDuration()、getDuration()方法

设置 SnackBar 显示时长,有如下几种状态

  • LENGTH_INDEFINITE 一直显示,直到手动 dismissed 或者另一个 SnackBar show

  • LENGTH_SHORT 显示一段时间

  • LENGTH_LONG 显示一段长时间
    具体显示多长时间,我们在SnackBarManger 类里面可以找到一下两个常量

      private static final int SHORT_DURATION_MS = 1500;
      private static final int LONG_DURATION_MS = 2750;
    

即short 显示1.5秒,long 显示2.75秒

ContentViewCallback

SnackBar 在显示和隐藏时给执行相应的动画,make方法里面还会讲

/**
 * Interface that defines the behavior of the main content of a transient bottom bar.
 */
public interface ContentViewCallback {
    /**
     * Animates the content of the transient bottom bar in.
     *
     * @param delay Animation delay.
     * @param duration Animation duration.
     */
    void animateContentIn(int delay, int duration);

    /**
     * Animates the content of the transient bottom bar out.
     *
     * @param delay Animation delay.
     * @param duration Animation duration.
     */
    void animateContentOut(int delay, int duration);
}

make(View,CharSequence,int)方法

这是 SnackBar 的静态方法,用于创建一个 SnackBar 并且做一些默认操作

public static Snackbar make(@NonNull View view, @NonNull CharSequence text,
        @Duration int duration) {
    final ViewGroup parent = findSuitableParent(view);
    if (parent == null) {
        throw new IllegalArgumentException("No suitable parent found from the given view. "
                + "Please provide a valid view.");
    }

    final LayoutInflater inflater = LayoutInflater.from(parent.getContext());
    final SnackbarContentLayout content =
            (SnackbarContentLayout) inflater.inflate(
                    R.layout.design_layout_snackbar_include, parent, false);
    final Snackbar snackbar = new Snackbar(parent, content, content);
    snackbar.setText(text);
    snackbar.setDuration(duration);
    return snackbar;
}
private static ViewGroup findSuitableParent(View view) {
    ViewGroup fallback = null;
    do {
        if (view instanceof CoordinatorLayout) {
            // We've found a CoordinatorLayout, use it
            return (ViewGroup) view;
        } else if (view instanceof FrameLayout) {
            if (view.getId() == android.R.id.content) {
                // If we've hit the decor content view, then we didn't find a CoL in the
                // hierarchy, so use it.
                return (ViewGroup) view;
            } else {
                // It's not the content view but we'll use it as our fallback
                fallback = (ViewGroup) view;
            }
        }

        if (view != null) {
            // Else, we will loop and crawl up the view hierarchy and try to find a parent
            final ViewParent parent = view.getParent();
            view = parent instanceof View ? (View) parent : null;
        }
    } while (view != null);

    // If we reach here then we didn't find a CoL or a suitable content view so we'll fallback
    return fallback;
}

这个方法是SnackBar 的重点,需要重点掌握
首先我来看前几第一行代码:用方法参数里面传进来的 view 做为参数,去调用了findSuitableParent()方法。这个方法很简单,根据所给的 view 不断去寻找 parent,直到找到DecorView里面的 contentView 即Activity 里面 setContentView 的父节点 FrameLayout 或者找到CoordinatorLayoutView,如果没找到则返回 null,在 make()方法里面抛出异常。
1.为什么要寻找这个 parent?因为这个 parent 是 SnackBar 构造方法的必要参数,并且SnackBar 在 show 的时候需要依附在一个 view 上并且显示在屏幕底部。
2.为什么CoordinatorLayoutView也可以并且优先使用。CoordinatorLayoutView是一个协调 ViewGroup,配合 Behavior 可以显示很多动画。这里的父节点如果是CoordinatorLayoutView可以让 SnackBar 在弹出的时候不会遮住FloatActionBar。不要问我为什么知道的,SnackBar的构造方法上已经告诉我们了。

刚刚我们拿到了用于SnackBar 显示在屏幕底部的 parentView,继续往下走

final SnackbarContentLayout content =
        (SnackbarContentLayout) inflater.inflate(
                R.layout.design_layout_snackbar_include, parent, false);

这里我们从 xml 里面 inflate 了一个SnackbarContentLayout,它集成自 LinearLayout 并且实现了BaseTransientBottomBar.ContentViewCallback接口,并实现了 SnackBar 在显示和隐藏的回调动画。

然后通过 private 的构造方法Snackbar(ViewGroup parent, View content, ContentViewCallback contentViewCallback)创建了一个 SnackBar 实例。

setText(CharSequence)方法

public Snackbar setText(@NonNull CharSequence message) {
    final SnackbarContentLayout contentLayout = (SnackbarContentLayout) mView.getChildAt(0);
    final TextView tv = contentLayout.getMessageView();
    tv.setText(message);
    return this;
}   

这里取到了一个SnackbarContentLayout,不用想,肯定就是我们刚刚在 make 方法里面创建的那个SnackbarContentLayout。于是可以得出结论,SnackBar 里面的布局就是SnackbarContentLayout。

setAction(CharSequence,OnclickListener)方法

public Snackbar setAction(CharSequence text, final View.OnClickListener listener) {
    final SnackbarContentLayout contentLayout = (SnackbarContentLayout) mView.getChildAt(0);
    final TextView tv = contentLayout.getActionView();

    if (TextUtils.isEmpty(text) || listener == null) {
        tv.setVisibility(View.GONE);
        tv.setOnClickListener(null);
    } else {
        tv.setVisibility(View.VISIBLE);
        tv.setText(text);
        tv.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View view) {
                listener.onClick(view);
                // Now dismiss the Snackbar
                dispatchDismiss(BaseCallback.DISMISS_EVENT_ACTION);
            }
        });
    }
    return this;
}

方法很简单,取到SnackbarContentLayout里面的 ActionView,设置显示文本和点击事件,并且这里再次证实了上面的猜想。

SetActionTextColor(int)

设置SnackbarContentLayout里面 ActionView 的字体颜色

getContext()

。。。跳过

getView()方法

public View getView() {
    return mView;
}

返回 mView,好像没什么卵用,仔细想想~~
还记得 setAction、setText等方法么,里面的SnackbarContentLayout是通过mView.getChildAt(0)获取到的,那么我们拿到了这个 View 的引用,SnackBar 的样式还不随我们自由修改?
甚至可以SnackbarContentLayout.removeAllViews();然后再SnackbarContentLayout.addView(任意 view)。

show()方法

这就是 SnackBar 显示到屏幕上的方法,里面调用了SnackBarManger。

public void show(int duration, Callback callback) {
    synchronized (mLock) {
        if (isCurrentSnackbarLocked(callback)) {
            // Means that the callback is already in the queue. We'll just update the duration
            mCurrentSnackbar.duration = duration;

            // If this is the Snackbar currently being shown, call re-schedule it's
            // timeout
            mHandler.removeCallbacksAndMessages(mCurrentSnackbar);
            scheduleTimeoutLocked(mCurrentSnackbar);
            return;
        } else if (isNextSnackbarLocked(callback)) {
            // We'll just update the duration
            mNextSnackbar.duration = duration;
        } else {
            // Else, we need to create a new record and queue it
            mNextSnackbar = new SnackbarRecord(duration, callback);
        }

        if (mCurrentSnackbar != null && cancelSnackbarLocked(mCurrentSnackbar,
                Snackbar.Callback.DISMISS_EVENT_CONSECUTIVE)) {
            // If we currently have a Snackbar, try and cancel it and wait in line
            return;
        } else {
            // Clear out the current snackbar
            mCurrentSnackbar = null;
            // Otherwise, just show it now
            showNextSnackbarLocked();
        }
    }
}

SnackBarManger是一个单例,并且使用了同步锁,因此保证了 SnackBar 在屏幕上不会同时显示连个.

Over~~~

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 200,612评论 5 471
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 84,345评论 2 377
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 147,625评论 0 332
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,022评论 1 272
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 62,974评论 5 360
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,227评论 1 277
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,688评论 3 392
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,358评论 0 255
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,490评论 1 294
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,402评论 2 317
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,446评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,126评论 3 315
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,721评论 3 303
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,802评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,013评论 1 255
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,504评论 2 346
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,080评论 2 341

推荐阅读更多精彩内容