Android 自定義空資料提示介面 EmptyView

570622566發表於2017-12-14

Android 自定義空資料提示介面 EmptyView

關於Fastandrutils

Fastandrutils 是一套整理修改整合的android開發常用的工具類,常用的自定義view控制元件等。 這樣可以減少複製貼上程式碼,從而減少重複程式碼,也不用為了一個常用的功能去谷歌百度,讓程式碼更簡潔,讓開發更高效。 同時希望您的新增完善,讓android開發變得更簡單。

github地址,感興趣的話,不妨點贊支援下

個人部落格

打完廣告,進入正題

不多說,先上圖

在開發過程中,最常的就是資料和介面間的互動,例如無資料時的介面展示,網路不通時的介面展示,對於這些不是正常的資料,我們都要做一些異常的展示介面,而不是一個空白介面,這樣做一些異常介面的處理,使用者體驗上會更好點。 原始碼地址

功能

  1. 顯示載入介面
  2. 顯示失敗介面
  3. 可自定義空介面

FEmptyView說明

程式碼有點多,就貼些關鍵的

  • FEmptyView 繼承 FrameLayout
  • FEmptyView裡的屬性
    private LinearLayout setdataLay;//設定資料佈局
    private View emptyView;//空佈局
    private ImageView emptyImg;//空佈局的ImageView
    private TextView emptyTv;//空佈局的TextView
    private Button emptyBt;//空佈局的Button
    private Context context;
複製程式碼
  • 為了自定義介面可配置,新增自定義屬性attrs
<?xml version="1.0" encoding="utf-8"?>
<resources>
    <declare-styleable name="EmptyLayout">
        <attr name="empty_layout" format="reference" />//空介面的layout檔案
        <attr name="empty_imageView" format="reference" />//空介面imageView的id
        <attr name="empty_textView" format="reference" />//空介面textView的id
        <attr name="empty_button" format="reference" />//空介面button的id
        <attr name="include_layout" format="reference" />//資料展示介面的layout檔案
    </declare-styleable>
</resources>
複製程式碼
  • FEmptyView 初始化介面佈局
 private void initView(TypedArray array) {
        int emptyViewId = array.getResourceId(FResourcesUtils.getStyleable("EmptyLayout_empty_layout"), FResourcesUtils.getLayoutResources("f_empty_layout"));
        int emptyImgId = array.getResourceId(FResourcesUtils.getStyleable("EmptyLayout_empty_imageView"), FResourcesUtils.getIdResources("empty_img"));
        int emptyTvId = array.getResourceId(FResourcesUtils.getStyleable("EmptyLayout_empty_textView"), FResourcesUtils.getIdResources("empty_tv"));
        int emptyBtId = array.getResourceId(FResourcesUtils.getStyleable("EmptyLayout_empty_button"), FResourcesUtils.getIdResources("empty_bt"));
        int dataViewId = array.getResourceId(FResourcesUtils.getStyleable("EmptyLayout_include_layout"), 0);
        //獲取空佈局View
        emptyView = View.inflate(context, emptyViewId, null);
        //獲取空佈局的imageView
        emptyImg = (ImageView) emptyView.findViewById(emptyImgId);
        emptyTv = (TextView) emptyView.findViewById(emptyTvId);
        emptyBt = (Button) emptyView.findViewById(emptyBtId);
        setdataLay = new LinearLayout(context);//先新增一個LinearLayout
        setdataLay.setOrientation(LinearLayout.VERTICAL);
        setdataLay.setVisibility(GONE);
        if (dataViewId != 0) {
            addChildViewid(dataViewId);//把資料介面新增到LinearLayout裡
        }
        addView(setdataLay);
        addView(emptyView);
    }
複製程式碼
  • 預設空介面佈局 有一個ImageView,一個TextView,Button
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:background="@android:color/white"
    android:gravity="center"
    android:orientation="vertical">

    <ImageView
        android:id="@+id/empty_img"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:maxHeight="200dp"
        android:maxWidth="200dp" />

    <TextView
        android:id="@+id/empty_tv"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_marginTop="8dp"
        android:textSize="16sp" />

    <Button
        android:id="@+id/empty_bt"
        android:layout_width="120dp"
        android:layout_height="40dp"
        android:layout_marginTop="6dp" />

</LinearLayout>
複製程式碼
  • FEmptyView 的一些方法 void loadding()//顯示載入介面 void loaddingSuccess() 成功獲取到資料把EmptyView隱藏 void loaddingFail() 載入失敗介面 ...

省略了比較多方法,詳細看原始碼

  • ImagView 回撥 為了更好的展示ImagView 就寫了個回撥方法,自行解決ImagView的動畫等
/**
 * ImagView 回撥
 */
    public interface ImgCallBack {
        void setImg(ImageView img, int emptyType);
    }
複製程式碼
  • emptyView 回撥 如果要做更深度自定義emptyView,這裡也返回了emptyView,這樣就可以獲取所有emptyView的控制元件
/**
     * emptyView 回撥
     */
    public interface ViewCallBack {
        void emptyViewCallBack(View view);
    }
複製程式碼

FEmptyView使用

第一種使用方法

  1. 在需要使用的xml新增
 <cn.hotapk.fastandrutils.widget.FEmptyView
        android:id="@+id/empty_lay"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        app:include_layout="@+layout/data_layout" />
複製程式碼

FEmptyView 不能在xml下加子View 只能這樣新增資料介面

  app:include_layout="@+layout/data_layout"
複製程式碼

在oncreat() 方法中

 empty_lay = (FEmptyView) findViewById(R.id.empty_lay);
 empty_lay.loadding("正在載入資料。。。");
 empty_lay.loaddingFail("載入資料失敗。。。", "點選重新整理", new View.OnClickListener() {
                    @Override
                    public void onClick(View v) {
                        loadding();
                    }
                }, new FEmptyView.ImgCallBack() {
                    @Override
                    public void setImg(ImageView img, int emptyType) {
                        img.setBackgroundResource(R.mipmap.loaddingfail);
                        if (img.getAnimation() != null)
                            img.getAnimation().cancel();
                    }
                });
複製程式碼

第二種使用方法

<cn.hotapk.fastandrutils.widget.FEmptyView
        android:id="@+id/empty_lay"
        android:layout_width="match_parent"
        android:layout_height="match_parent"/>

複製程式碼

FEmptyView 不能在xml下加子View 只能在oncreat() 中這樣新增資料介面

        empty_lay.addChildView(childView);

複製程式碼

之後的使用第一種

第三種使用方法

可自定義emptyView

 <cn.hotapk.fastandrutils.widget.FEmptyView
        android:id="@+id/empty_lay"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        app:empty_button="@+id/custom_empty_bt"//自定義layout的button的id
        app:empty_imageView="@+id/custom_empty_img"//自定義layout的imageView的id
        app:empty_textView="@+id/custom_empty_tv"//自定義layout的textView的id
        app:empty_layout="@+layout/custom_empty_layout"//自定義的空 layout介面
        app:include_layout="@+layout/data_layout" />//展示資料的layout
複製程式碼

FEmptyView 同樣不能在xml下加子View 只能這樣新增資料介面

  app:include_layout="@+layout/data_layout"
複製程式碼

之後的使用同第一種

第四種使用方法

可深度自定義emptyView

 <cn.hotapk.fastandrutils.widget.FEmptyView
        android:id="@+id/empty_lay"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        app:empty_layout="@+layout/custom_empty_layout"//自定義的空 layout介面
        app:include_layout="@+layout/data_layout" />//展示資料的layout
複製程式碼

深度自定義的話 程式碼中會返回自定義的emptyView

    public View getEmptyView() {
        return emptyView;
    }
複製程式碼

可以findViewById獲取自定義的控制元件 之後的使用同第一種差不多

Android 自定義空資料提示介面 EmptyView 解說完畢

希望各位在使用中遇到什麼問題或建議可以用以下聯絡方式進行反饋

android開發討論群 320120776

個人部落格

相關文章