Kotlin 实现字母滑动定位通讯录列表

在 Kotlin 中，可以使用 RecyclerView 和 AlphabetIndexer 来实现按字母滑动定位通讯录列表。

首先，创建一个 RecyclerView 和一个 TextView，用于显示字母滑动定位的效果。在布局文件中添加以下代码：

<androidx.recyclerview.widget.RecyclerView
    android:id="@id/recyclerView"
    android:layout_width="match_parent"
    android:layout_height="match_parent"/>

<TextView
    android:id="@id/overlay"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:layout_gravity="center"
    android:background="@drawable/overlay_background"
    android:padding="8dp"
    android:textColor="#FFFFFF"
    android:textSize="32sp"
    android:visibility="invisible"/>

然后，创建一个数据模型类 Contact，用于表示通讯录中的每个联系人。在代码中添加以下代码：

data class Contact(val name: String)

接下来，创建一个自定义的 RecyclerView.Adapter，用于显示通讯录列表。在代码中添加以下代码：

class ContactsAdapter(private val contacts: List<Contact>) : RecyclerView.Adapter<ContactsAdapter.ContactViewHolder>() {

    class ContactViewHolder(itemView: View) : RecyclerView.ViewHolder(itemView) {
        val nameTextView: TextView = itemView.findViewById(R.id.nameTextView)
    }

    override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): ContactViewHolder {
        val itemView = LayoutInflater.from(parent.context).inflate(R.layout.item_contact, parent, false)
        return ContactViewHolder(itemView)
    }

    override fun onBindViewHolder(holder: ContactViewHolder, position: Int) {
        val contact = contacts[position]
        holder.nameTextView.text = contact.name
    }

    override fun getItemCount(): Int {
        return contacts.size
    }
}

接下来，创建一个 Activity 或 Fragment，用于显示通讯录列表。在代码中添加以下代码：

class MainActivity : AppCompatActivity() {

    private lateinit var recyclerView: RecyclerView
    private lateinit var overlay: TextView
    private lateinit var contactsAdapter: ContactsAdapter

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        recyclerView = findViewById(R.id.recyclerView)
        overlay = findViewById(R.id.overlay)

        val contacts = mutableListOf<Contact>()
        // 添加通讯录数据
        contacts.add(Contact('Alice'))
        contacts.add(Contact('Bob'))
        contacts.add(Contact('Charlie'))
        contacts.add(Contact('David'))
        // 其他联系人...

        // 根据联系人名称进行排序
        contacts.sortBy { it.name }

        // 创建适配器
        contactsAdapter = ContactsAdapter(contacts)

        // 设置 RecyclerView 布局管理器
        recyclerView.layoutManager = LinearLayoutManager(this)

        // 设置 RecyclerView 适配器
        recyclerView.adapter = contactsAdapter

        // 设置字母滑动定位效果
        val alphabetIndexer = AlphabetIndexer(
            overlay,
            recyclerView.layoutManager as LinearLayoutManager,
            contacts.map { it.name }
        )
        recyclerView.addOnScrollListener(alphabetIndexer)
    }
}

最后，创建一个 AlphabetIndexer 类，用于实现字母滑动定位的效果。在代码中添加以下代码：

class AlphabetIndexer(
    private val overlay: TextView,
    private val layoutManager: LinearLayoutManager,
    private val names: List<String>
) : RecyclerView.OnScrollListener() {

    private val alphabet = 'ABCDEFGHIJKLMNOPQRSTUVWXYZ'

    override fun onScrollStateChanged(recyclerView: RecyclerView, newState: Int) {
        super.onScrollStateChanged(recyclerView, newState)
        if (newState == RecyclerView.SCROLL_STATE_DRAGGING) {
            overlay.visibility = View.VISIBLE
        } else if (newState == RecyclerView.SCROLL_STATE_IDLE) {
            overlay.visibility = View.INVISIBLE
        }
    }

    override fun onScrolled(recyclerView: RecyclerView, dx: Int, dy: Int) {
        super.onScrolled(recyclerView, dx, dy)
        val firstVisibleItemPosition = layoutManager.findFirstVisibleItemPosition()
        val section = getSectionForPosition(firstVisibleItemPosition)
        overlay.text = alphabet[section].toString()
    }

    private fun getSectionForPosition(position: Int): Int {
        val name = names[position]
        return alphabet.indexOf(name[0].toUpperCase())
    }
}

以上代码实现了按字母滑动定位通讯录列表的功能。在 MainActivity 中，通过添加 AlphabetIndexer 作为 RecyclerView 的滚动监听器，实现了根据滚动位置显示当前字母的功能。同时，通过设置 overlay 的可见性，实现了字母滑动定位时的显示和隐藏效果。通过 ContactsAdapter 来显示通讯录列表的内容。

最后，记得在 AndroidManifest.xml 文件中添加以下权限：

<uses-permission android:name="android.permission.READ_CONTACTS"/>