多是最簡單的 RecyclerView 適配器

這個適配器我珍藏已久(近兩年), 不斷看到別人發適配器相關的文章, 但我總以爲沒個人好用, 因此今日拿出來分享(宣傳)一下, 歡迎各位指正不足.

源碼地址: GitHub

功能

• 無需繼承 Adapter, 無需判斷 item 類型.
• 支持頁頭和頁腳.
• 支持自動展現空數據界面.
• 經過 Kotlin 的 lambda 大量縮減代碼.
• 支持全局 Item 類型
• 支持 diff 刷新

使用

添加依賴

implementation "com.dengzii.adapter:$latestVersion"
複製代碼

經過 lambda 快速使用, 這裏就快速綁定了四種 item 的佈局.

adapter.setEnableEmptyView(true, SuperAdapter.Empty())
adapter.addViewHolderForType<SuperAdapter.Empty>(R.layout.item_empty){
    onBindData { _, _ -> 
        findView<View>(R.id.bt_refresh).setOnClickListener { 
            // refresh your data
        }
    }
}
adapter.setHeader("This is header", R.layout.item_header) {
    onBindData { data, _ ->
        findView<TextView>(R.id.tv_title).text = data
    }
}
adapter.setFooter(listOf("This", "is", "footer"), R.layout.item_section) {
    onBindData { data, _ ->
        findView<TextView>(R.id.tv_title).text = data.joinToString(" ")
    }
}
adapter.addViewHolderForType<Header>(R.layout.item_header) {
    val title = findView<TextView>(R.id.tv_title)
    val content by lazyFindView<TextView>(R.id.tv_content)
    onBindData { data, _ ->
        title.text = data.title
        content.text = data.content
    }
}
複製代碼

或者不使用 lambda

val adapter = SuperAdapter(listOf("Item 1", "Item 2", "Item 3"))
adapter.addViewHolderForType(String::class.java, ItemViewHolder::class.java)
recyclerView.layoutManager = LinearLayoutManager(this)
recyclerView.adapter = adapter

class ItemViewHolder(parent: ViewGroup) : AbsViewHolder<String>(parent) {
    private lateinit var mTextView:TextView 
    override fun onCreate(parent: ViewGroup) {
        mTextView = TextView(context)
        mTextView.layoutParams = getLayoutParam(
                        ViewGroup.LayoutParams.WRAP_CONTENT,
                        ViewGroup.LayoutParams.WRAP_CONTENT
                )
        setContentView(mTextView)
    }

    override fun onBindData(data: String, position: Int) {
        mTextView.text = data
    }
}
複製代碼

無需繼承 SuperAdapter, 但須要爲每種 Item 實現並繼承繼承抽象類 AbsViewHolder, 並在改類中設置佈局和綁定 View, 數據.

AbsViewHolder 表明一種 Item 類型, 其中泛型 T 爲該 Item 對應的實體類

類 SuperAdapter 的做用

Adapter 構造器

public SuperAdapter(List<Object> data)
複製代碼

綁定 ViewHolder 到實體類型

public void addViewHolderForType(Class<?> type, Class<? extends AbsViewHolder> holder)
複製代碼

設置 Item 點擊事件

public void setOnItemClickListener(OnItemClickListener listener)
 
 public interface OnItemClickListener{
     void onItemClick(View v, Object itemData, int position);
 }
複製代碼

類 AbsViewHolder 的做用

每一個 AbsViewHolder 表示一種 item 類型.

構造器, 必須重寫帶參數構造器, 不然沒法使用, parent 與 Adapter#onCreateViewHolder 中 parent 一致

public AbsViewHolder(@NonNull ViewGroup parent) 
複製代碼

建立 Item 時調用 onCreate 方法, 其中 parent 是該 item 的容器佈局

public abstract void onCreate(@NonNull ViewGroup parent);
複製代碼

綁定數據

public abstract void onBindData(@NonNull T data, int position);     
複製代碼

Sample

設置 Adapter

var data:List<Any>
...
val adapter = SuperAdapter(data)
// 綁定數據類到 ViewHolder
adapter.addViewHolderForType(Item::class.java, ItemViewHolder::class.java)
adapter.addViewHolderForType(Header::class.java, HeaderViewHolder::class.java)
adapter.addViewHolderForType(Section::class.java, SectionViewHolder::class.java)

adapter.setOnItemClickListener(object : SuperAdapter.OnItemClickListener {
    override fun onItemClick(v: View?, itemData: Any?, position: Int) {

    }
})

recyclerView.layoutManager = LinearLayoutManager(this)
recyclerView.adapter = adapter
複製代碼

繼承 AbsViewHolder

class ItemViewHolder(parent: ViewGroup) : AbsViewHolder<Item>(parent) {
    private lateinit var mTvTitle: TextView
    private lateinit var mTvContent: TextView
    private lateinit var mIvImage:ImageView

    override fun onCreate(parent: ViewGroup) {
        setContentView(R.layout.item_item)
        mTvTitle = findViewById(R.id.tv_title)
        mTvContent = findViewById(R.id.tv_content)
        mIvImage = findViewById(R.id.iv_img)
    }

    override fun onBindData(data: Item, position: Int) {
        mTvTitle.text = data.title
        mTvContent.text = data.content
        mIvImage.setImageResource(data.img)
    }
}
複製代碼