Android 之 StateView(狀態(tài)頁面切換)

StateView 一個(gè)輕量級的控件, 繼承自 View, 吸收了 ViewStub 的一些特性, 初始狀態(tài)下是不可見的, 不占布局位置, 占用內(nèi)存少规婆。 當(dāng)進(jìn)行操作顯示空/重試/加載視圖后, 該視圖才會被添加到布局中。

使用方法

1.

//在 app 下的 build.gradle 中添加以下依賴
compile 'com.github.nukc.stateview:library:1.5.4'
// animator providers
compile 'com.github.nukc.stateview:animations:1.0.1'

2.

//將 StateView 控件添加到 xml 文件中
<com.github.nukc.stateview.StateView
        android:id="@+id/stateView"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:layout_below="@id/ll"
        tools:visibility="gone" />

3.

//在 Activity中實(shí)例化StateView
private StateView mStateView;
mStateView = (StateView) findViewById(R.id.stateView);

注入到 Activity

mStateView = StateView.inject(Activity activity);

注入到 ViewGroup

mStateView = StateView.inject(ViewGroup parent);
mStateView = StateView.inject(ViewGroup parent, boolean hasActionBar);
// 如果 View 不是 ViewGroup冯袍,則會注入到 View 的 parent 中
mStateView = StateView.inject(View view);
mStateView = StateView.inject(View view, boolean hasActionBar);

包裹指定的 View犬钢,這個(gè)會增加層次

mStateView = StateView.wrap(View view);

4.

//切換頁面
@Override
    public void onClick(View v) {
        switch (v.getId()){
            case R.id.btnInEmpty:
                //切換為 無數(shù)據(jù) 頁面
                mStateView.showEmpty();
                break;
            case R.id.btnInRetry:
                //切換為 刷新 頁面
                mStateView.showRetry();
                break;
            case R.id.btnRemove:
                //切換為 內(nèi)容 頁面
                mStateView.showContent();
                break;
            case R.id.btnRemove:
                //切換為 加載 頁面
                mStateView.showLoading();
                break;
        }
    }

顯示空視圖: mStateView.showEmpty();
顯示加載視圖: mStateView.showLoading();
顯示重試視圖: mStateView.showRetry();
顯示內(nèi)容: mStateView.showContent();

5.

//設(shè)置點(diǎn)擊事件
mStateView.setOnRetryClickListener(new StateView.OnRetryClickListener() {
        @Override
        public void onRetryClick() {
            //do something, no need to call showLoading()
            //不需要調(diào)用showLoading()方法, StateView自會調(diào)用
        }
    });

設(shè)置自定義視圖:

全局設(shè)置辦法:在自己項(xiàng)目的layout下新建, 名字跟StateView默認(rèn)layout一樣即可(也不用代碼設(shè)置). 默認(rèn)layout的名字:base_empty/base_retry/base_loading.
單頁面設(shè)置:layout名字不一樣, 然后再代碼設(shè)置.

setEmptyResource(@LayoutRes int emptyResource)
setRetryResource(@LayoutRes int retryResource)
setLoadingResource(@LayoutRes int loadingResource)

動(dòng)畫切換

// 默認(rèn) provider 是 null苍鲜,即默認(rèn)不提供動(dòng)畫切換
// 如果需要,設(shè)置一個(gè)就可以了
setAnimatorProvider(AnimatorProvider provider)

漸變縮放: FadeScaleAnimatorProvider
卡片翻轉(zhuǎn): FlipAnimatorProvider
左右滑動(dòng): SlideAnimatorProvider

兼容沉浸式全屏模式

/**
 * @return statusBarHeight
  對于是沉浸式全屏模式下的玷犹,可以使用此方法補(bǔ)上 statusBar 的 height混滔,從而不覆蓋 toolbar
 */
private int getStatusBarHeight() {
    int height = 0;
    int resId = getResources().getIdentifier("status_bar_height", "dimen", "android");
    if (resId > 0) {
        height = getResources().getDimensionPixelSize(resId);
    }
    return height;
}

ViewGroup.MarginLayoutParams layoutParams = (ViewGroup.MarginLayoutParams) mStateView.getLayoutParams();
layoutParams.topMargin += getStatusBarHeight()

參考文獻(xiàn)

源碼:https://github.com/nukc/StateView

?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末,一起剝皮案震驚了整個(gè)濱河市歹颓,隨后出現(xiàn)的幾起案子坯屿,更是在濱河造成了極大的恐慌,老刑警劉巖巍扛,帶你破解...
    沈念sama閱讀 222,681評論 6 517
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件愿伴,死亡現(xiàn)場離奇詭異,居然都是意外死亡电湘,警方通過查閱死者的電腦和手機(jī)隔节,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 95,205評論 3 399
  • 文/潘曉璐 我一進(jìn)店門鹅经,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人怎诫,你說我怎么就攤上這事瘾晃。” “怎么了幻妓?”我有些...
    開封第一講書人閱讀 169,421評論 0 362
  • 文/不壞的土叔 我叫張陵蹦误,是天一觀的道長。 經(jīng)常有香客問我肉津,道長强胰,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 60,114評論 1 300
  • 正文 為了忘掉前任妹沙,我火速辦了婚禮偶洋,結(jié)果婚禮上,老公的妹妹穿的比我還像新娘距糖。我一直安慰自己玄窝,他們只是感情好,可當(dāng)我...
    茶點(diǎn)故事閱讀 69,116評論 6 398
  • 文/花漫 我一把揭開白布悍引。 她就那樣靜靜地躺著恩脂,像睡著了一般。 火紅的嫁衣襯著肌膚如雪趣斤。 梳的紋絲不亂的頭發(fā)上俩块,一...
    開封第一講書人閱讀 52,713評論 1 312
  • 那天,我揣著相機(jī)與錄音浓领,去河邊找鬼典阵。 笑死,一個(gè)胖子當(dāng)著我的面吹牛镊逝,可吹牛的內(nèi)容都是我干的。 我是一名探鬼主播嫉鲸,決...
    沈念sama閱讀 41,170評論 3 422
  • 文/蒼蘭香墨 我猛地睜開眼撑蒜,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了玄渗?” 一聲冷哼從身側(cè)響起座菠,我...
    開封第一講書人閱讀 40,116評論 0 277
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎藤树,沒想到半個(gè)月后浴滴,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體,經(jīng)...
    沈念sama閱讀 46,651評論 1 320
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡岁钓,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 38,714評論 3 342
  • 正文 我和宋清朗相戀三年升略,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了微王。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點(diǎn)故事閱讀 40,865評論 1 353
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡品嚣,死狀恐怖炕倘,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情翰撑,我是刑警寧澤罩旋,帶...
    沈念sama閱讀 36,527評論 5 351
  • 正文 年R本政府宣布,位于F島的核電站眶诈,受9級特大地震影響涨醋,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜逝撬,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 42,211評論 3 336
  • 文/蒙蒙 一浴骂、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧球拦,春花似錦靠闭、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 32,699評論 0 25
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至谣光,卻和暖如春檩淋,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背萄金。 一陣腳步聲響...
    開封第一講書人閱讀 33,814評論 1 274
  • 我被黑心中介騙來泰國打工蟀悦, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留,地道東北人氧敢。 一個(gè)月前我還...
    沈念sama閱讀 49,299評論 3 379
  • 正文 我出身青樓日戈,卻偏偏與公主長得像,于是被迫代替她去往敵國和親孙乖。 傳聞我的和親對象是個(gè)殘疾皇子浙炼,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 45,870評論 2 361

推薦閱讀更多精彩內(nèi)容