Flutter联系人选择插件contactor_picker的使用

联系人选择器 contactor_picker 是一个用于在 Flutter 应用程序中轻松选择联系人的插件。通过此插件，用户可以方便地从联系人列表中选择联系人，甚至可以通过搜索功能快速找到特定联系人。

安装

首先，在项目的 pubspec.yaml 文件中添加 contactor_picker 依赖项：

dependencies:
  contactor_picker: ^0.0.6

然后，从命令行安装依赖项：

$ flutter packages get

使用方法

列表加搜索

ContactorPicker.showPicker(
  context,
  /// 数据源
  dataList: [],
  /// 是否展示code，默认不展示
  showGroupCode: true,
  /// 选中数据
  onSelectedData: (data) {
    // 回调函数，当用户选择某个联系人时执行
  },
  /// 标题
  title: '联系人',
  /// 页面背景色
  backgroundColor: Color(0xFFFAFAFA),
  /// 当前字母颜色
  letterSelectedColor: Colors.blueAccent,
);

仅搜索

ContactorPicker.showSearchPicker(
  context,
  /// 是否展示code，默认不展示
  showGroupCode: true,
  /// 数据源
  dataList: [],
  /// 背景色
  backgroundColor: Color(0xFFFAFAFA),
  /// 选中数据
  onSelectedData: (data) {
    // 回调函数，当用户选择某个联系人时执行
  },
);

支持嵌入其他Widget

以下是一个完整的示例代码，展示了如何将 ContactorView 嵌入到 Flutter 应用程序中，并实现联系人选择功能：

import 'package:flutter/material.dart';
import 'package:contactor_picker/contactor_picker.dart';
import 'package:lpinyin/lpinyin.dart';

void main() {
  runApp(MaterialApp(home: MyApp()));
}

class MyApp extends StatefulWidget {
  [@override](/user/override)
  _MyAppState createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  String _currentData = '';

  [@override](/user/override)
  void initState() {
    super.initState();
    print('length----${DataUtil.dataList.length}');
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: const Text('Plugin example app'),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            TextButton(
              onPressed: () {
                ContactorPicker.showPicker(
                  context,
                  showGroupCode: true,
                  dataList: DataUtil.dataList.map((element) {
                    String pinyin = PinyinHelper.getPinyinE(element['name'],
                        separator: "",
                        defPinyin: '#',
                        format: PinyinFormat.WITHOUT_TONE);
                    return ContactorDataListData(
                      name: element['name'],
                      id: int.tryParse(element['zip']),
                      pinyin: pinyin,
                      // headerImageUrl: 'https://picsum.photos/250?image=9',
                      code: element['label'],
                      groupCode: element['zip'],
                    );
                  }).toList(),
                  title: '地址簿',
                  extendWidget: Column(
                    crossAxisAlignment: CrossAxisAlignment.start,
                    children: [
                      Container(
                        alignment: Alignment.centerLeft,
                        height: 40,
                        child: Text('666666'),
                      ),
                      Container(
                        height: 40,
                        alignment: Alignment.centerLeft,
                        child: Text('555555'),
                      ),
                      Expanded(
                        child: Container(
                          height: 40,
                          alignment: Alignment.centerLeft,
                          child: Text('888888'),
                        ),
                      )
                    ],
                  ),
                  letterSelectedColor: Colors.blueAccent,
                  onSelectedData: (data, pageNum) {
                    print(data.toJson());
                    _currentData = data.toJson().toString();
                    setState(() {});
                  },
                );
              },
              child: Text('地址簿'),
            ),
            TextButton(
              onPressed: () {
                ContactorPicker.showSearchPicker(
                  context,
                  showGroupCode: true,
                  dataList: DataUtil.dataList.map((element) {
                    String pinyin = PinyinHelper.getPinyinE(element['name'],
                        separator: " ",
                        defPinyin: '#',
                        format: PinyinFormat.WITHOUT_TONE);
                    return ContactorDataListData(
                      name: element['name'],
                      id: int.tryParse(element['zip']),
                      pinyin: pinyin,
                      code: element['label'],
                      groupCode: element['zip'],
                    );
                  }).toList(),
                  backgroundColor: Color(0xFFFAFAFA),
                  onSelectedData: (data, pageNum) {
                    print(data.toJson());
                    _currentData = data.toJson().toString();
                    setState(() {});
                  },
                );
              },
              child: Text('搜索'),
            ),
            Container(
              padding: EdgeInsets.symmetric(horizontal: 30),
              child: Text('currentData: $_currentData\n'),
            ),
          ],
        ),
      ),
    );
  }
}