Android 控制元件 —— ListView

ListView 的簡單用法

在布局中加入 ListView 控制元件還算簡單，先為 ListView 指定一個 id，然后將寬度和高度都設定為 match_parent，這樣 ListView 就占滿了整個布局的空間

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:orientation="vertical"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <ListView
        android:id="@+id/listView"
        android:layout_width="match_parent"
        android:layout_height="match_parent" />

</LinearLayout>

接下來修改 MainActivity 中的代碼

class MainActivity : AppCompatActivity() {

    private val data = listOf("Apple", "Banana", "Orange", "Watermelon",
        "Pear", "Grape", "Pineapple", "Strawberry", "Cherry", "Mango",
        "Apple", "Banana", "Orange", "Watermelon", "Pear", "Grape",
        "Pineapple", "Strawberry", "Cherry", "Mango")

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        val adapter = ArrayAdapter<String>(this, android.R.layout.simple_list_item_1, data)
        listView.adapter = adapter
    }
}

先將資料準備好，然后借助配接器將資料傳遞給 ListView，ArrayAdapter 是 Android 提供的一種配接器的實作類，可以通過泛型來指定要適配的資料型別，然后在建構式中把要適配的資料傳入，在 ArrayAdapter 的建構式中依次傳入 Activity 的實體、ListView 子項布局的 id、資料源，這里我們使用了 android.R.layout.simple_list_item_1 作為 ListView 子項布局的 id，這是一個 Android 內置的布局檔案，里面只有一個 TextView，可用于簡單地顯式一段文本，最后，呼叫 ListView 的 setAdapter() 方法，將構建好的配接器物件傳遞進去，這樣 ListView 和資料之間的關聯就建立完成了

定制 ListView 的界面

只能顯示一段文本的 ListView 實在太單調了，我們現在希望定制 ListView 的界面，讓它能顯示文本和圖片

在需要 ListView 的子項指定一個我們自定義的布局，在 layout 目錄下新建 fruit_item.xml

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="60dp">

    <ImageView
        android:id="@+id/fruitImage"
        android:layout_width="40dp"
        android:layout_height="40dp"
        android:layout_gravity="center_vertical"
        android:layout_marginLeft="10dp"
        tools:ignore="ContentDescription,RtlHardcoded" />

    <TextView
        android:id="@+id/fruitName"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_gravity="center_vertical"
        android:layout_marginLeft="10dp"
        tools:ignore="RtlHardcoded" />

</LinearLayout>

定義一個物體類，作為 ListView 配接器的適配型別

class FruitAdapter(activity: Activity, val resourceId: Int, data: List<Fruit>) :
    ArrayAdapter<Fruit>(activity, resourceId, data) {

    @SuppressLint("ViewHolder")
    override fun getView(position: Int, convertView: View?, parent: ViewGroup): View {
        val view = LayoutInflater.from(context).inflate(resourceId, parent, false)
        val fruitImage: ImageView = view.findViewById(R.id.fruitImage)
        val fruitName: TextView = view.findViewById(R.id.fruitName)
        val fruit = getItem(position)
        if (fruit != null) {
            fruitImage.setImageResource(fruit.imageId)
            fruitName.text = fruit.name
        }
        return view
    }
}

FruitAdapter 類繼承自 ArrayAdapter，并泛型指定為 Fruit 類，重寫 getView() 方法，在 getView() 方法中，首先使用 LayoutInflater 來為這個子項加載我們傳入的布局，再呼叫 View 的 findViewById() 方法分別獲取 ImageView 和 TextView，然后通過 getItem() 方法得到當前項的 Fruit 實體，設定顯示的圖片和文字，最后將布局回傳

最后修改 MainActivity 中的代碼

class MainActivity : AppCompatActivity() {

    private val fruitList = ArrayList<Fruit>()

    private val data = listOf("Apple", "Banana", "Orange", "Watermelon",
        "Pear", "Grape", "Pineapple", "Strawberry", "Cherry", "Mango",
        "Apple", "Banana", "Orange", "Watermelon", "Pear", "Grape",
        "Pineapple", "Strawberry", "Cherry", "Mango")

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        initFruits()
        val adapter = FruitAdapter(this, R.layout.fruit_item, fruitList)
        listView.adapter = adapter
    }

    private fun initFruits() {
        repeat(2) {
            fruitList.add(Fruit("Apple", R.drawable.apple_pic))
            fruitList.add(Fruit("Banana", R.drawable.banana_pic))
            fruitList.add(Fruit("Orange", R.drawable.orange_pic))
            fruitList.add(Fruit("Watermelon", R.drawable.watermelon_pic))
            fruitList.add(Fruit("Pear", R.drawable.pear_pic))
            fruitList.add(Fruit("Grape", R.drawable.grape_pic))
            fruitList.add(Fruit("Pineapple", R.drawable.pineapple_pic))
            fruitList.add(Fruit("Strawberry", R.drawable.strawberry_pic))
            fruitList.add(Fruit("Cherry", R.drawable.cherry_pic))
            fruitList.add(Fruit("Mango", R.drawable.mango_pic))
        }
    }
}

提升 ListView 的運行效率

getView() 方法中還有一個 convertView 引數，這個引數用于將之前加載好的布局進行快取，以便之后進行重用，我們可以借助這個引數進行性能優化

class FruitAdapter(activity: Activity, val resourceId: Int, data: List<Fruit>) :
    ArrayAdapter<Fruit>(activity, resourceId, data) {

    @SuppressLint("ViewHolder")
    override fun getView(position: Int, convertView: View?, parent: ViewGroup): View {
        val view: View
        if (convertView == null) {
            view = LayoutInflater.from(context).inflate(resourceId, parent, false)
        } else {
            view = convertView
        }
        val fruitImage: ImageView = view.findViewById(R.id.fruitImage)
        val fruitName: TextView = view.findViewById(R.id.fruitName)
        val fruit = getItem(position)
        if (fruit != null) {
            fruitImage.setImageResource(fruit.imageId)
            fruitName.text = fruit.name
        }
        return view
    }
}

我們在 getView() 方法中進行了判斷：如果 convertView 為 null，則使用 LayoutInflater 去加載布局；如果不為 null，則直接對 convertView 進行重用

目前代碼還可以繼續優化，每次在 getView() 方法中仍然會呼叫 View 的 findViewById 方法去獲取一次控制元件的實體，我們可以借助一個 ViewHolder 來對這部分性能進行優化，修改 FruitAdapter 中的代碼

class FruitAdapter(activity: Activity, val resourceId: Int, data: List<Fruit>) :
    ArrayAdapter<Fruit>(activity, resourceId, data) {

    inner class ViewHolder(val fruitImage: ImageView, val fruitName: TextView)

    @SuppressLint("ViewHolder")
    override fun getView(position: Int, convertView: View?, parent: ViewGroup): View {
        val view: View
        val viewHolder: ViewHolder
        if (convertView == null) {
            view = LayoutInflater.from(context).inflate(resourceId, parent, false)
            val fruitImage: ImageView = view.findViewById(R.id.fruitImage)
            val fruitName: TextView = view.findViewById(R.id.fruitName)
            viewHolder = ViewHolder(fruitImage, fruitName)
            view.tag = viewHolder
        } else {
            view = convertView
            viewHolder = view.tag as ViewHolder
        }
        val fruit = getItem(position)
        if (fruit != null) {
            viewHolder.fruitImage.setImageResource(fruit.imageId)
            viewHolder.fruitName.text = fruit.name
        }
        return view
    }
}

我們新增一個內部類 ViewHolder，用于對 ImageView 和 TextView 的控制元件實體進行快取，當 convertView 為 null 時，創建一個 ViewHolder 物件，并將控制元件的實體存放在 ViewHolder 里，然后呼叫 View 的 setTag() 方法，將 ViewHolder 物件存盤在 View 中

ListView 的點擊事件

ListView 的滾動畢竟只是滿足我們視覺上的效果，因此本節學習 ListView 如何才能回應用戶的點擊事件

class MainActivity : AppCompatActivity() {

    private val fruitList = ArrayList<Fruit>()

    ...

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        initFruits()
        val adapter = FruitAdapter(this, R.layout.fruit_item, fruitList)
        listView.adapter = adapter
        /*val adapter = ArrayAdapter<String>(this, android.R.layout.simple_list_item_1, data)*/
        /*listView.adapter = adapter*/
        listView.setOnItemClickListener {parent, view, position, id ->
            val fruit = fruitList[position]
            Toast.makeText(this, fruit.name, Toast.LENGTH_SHORT).show()
        }
    }
}