# ContactListView

**Repository Path**: qwq/ContactListView

## Basic Information

- **Project Name**: ContactListView
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-05
- **Last Updated**: 2025-11-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ContactListView
基于 RecyclerView 实现的通讯录，主要功能如下：

- 副导航栏功能
- 拼音分组

## 效果图

![效果图](https://gitee.com/qwq/ContactListView/blob/master/jdfw.gif)

## 功能说明

### 主要组件

- `MainActivity`: 主界面，负责初始化通讯录列表和副导航栏。
- `ContactAdapter`: 继承自 `BaseRecyclerAdapter`，用于展示联系人列表。
- `Friend`: 联系人实体类，包含姓名、电话、拼音等信息。
- `PinYinComparator`: 联系人拼音比较器，用于排序。
- `Pinyin4jUtil`: 拼音工具类，用于将汉字转换为拼音。
- `CircleTextView`: 自定义控件，用于显示圆形文本。
- `PinYinSlideView`: 自定义控件，用于实现副导航栏的滑动选择功能。

### 拼音分组

通过 `Pinyin4jUtil` 将联系人的中文名称转换为拼音，并通过 `PinYinComparator` 对联系人进行排序，实现按拼音首字母分组的功能。

### 副导航栏

`PinYinSlideView` 实现了滑动选择功能，用户可以通过滑动右侧的字母列表快速定位到相应的联系人分组。

## 使用方法

1. 克隆项目到本地：

   ```bash
   git clone https://gitee.com/qwq/ContactListView.git
   ```

2. 使用 Android Studio 打开项目。

3. 运行项目，即可看到通讯录列表和副导航栏功能。

## 自定义

- 如果需要自定义联系人信息，可以修改 `Friend` 类。
- 如果需要调整界面样式，可以修改 `contact_item.xml` 和 `activity_main.xml`。
- 如果需要修改拼音排序规则，可以修改 `PinYinComparator` 类。

## 许可证

本项目基于 MIT 许可证发布，详情请查看项目中的 LICENSE 文件。