Flutter Contact Picker

https://pub.dev/documentation/fluttercontactpicker/latest/
Admin
The Flutter Contact Picker library allows you to interact with native OS contact pickers using...
Tokens:32,288
Snippets:366
Trust Score:9.9
Update:4 months ago
Show doc for...
Tokens:
Raw
### ContactPickerPlatform()

Source: https://pub.dev/documentation/fluttercontactpicker/latest/fluttercontactpicker/ContactPickerPlatform/ContactPickerPlatform.html

Constructs a new instance of the ContactPickerPlatform. This is the primary way to get an instance of the contact picker interface.

```APIDOC
## ContactPickerPlatform()

### Description
Constructs a new instance of the ContactPickerPlatform. This is the primary way to get an instance of the contact picker interface.

### Method
Constructor

### Endpoint
N/A

### Parameters
None

### Request Example
```dart
final contactPicker = ContactPickerPlatform();
```

### Response
#### Success Response
An instance of `ContactPickerPlatform`.

### Response Example
```dart
// Instance of ContactPickerPlatform
```
```

--------------------------------

### PhoneContact.fromMap Factory Constructor

Source: https://pub.dev/documentation/fluttercontactpicker/latest/fluttercontactpicker/PhoneContact/PhoneContact.fromMap.html

The `fromMap` factory constructor allows you to create a `PhoneContact` object by parsing a `Map`. This is useful when deserializing data, for example, from JSON.

```APIDOC
## PhoneContact.fromMap(Map map)

### Description
Creates a `PhoneContact` object from a `Map`.

### Parameters
#### Path Parameters
- **map** (Map<dynamic, dynamic>) - Required - A map containing the contact details, including 'fullName' and 'phoneNumber'.
```

--------------------------------

### InstantMessenger Constructors

Source: https://pub.dev/documentation/fluttercontactpicker/latest/fluttercontactpicker/InstantMessenger-class.html

Provides information on how to instantiate the InstantMessenger class.

```APIDOC
## Constructors

InstantMessenger(int type, String? customLabel, String? im, String? protocol)

InstantMessenger.fromMap(Map map)
```

--------------------------------

### asResizedProvider Method Implementation

Source: https://pub.dev/documentation/fluttercontactpicker/latest/fluttercontactpicker/Photo/asResizedProvider.html

This snippet shows the implementation of the asResizedProvider method. It takes optional cacheWidth, cacheHeight, and scale parameters to control the resizing and returns a ResizeImage instance.

```dart
ImageProvider asResizedProvider({
  double scale = 1.0,
  int? cacheWidth,
  int? cacheHeight,
})
    =>
    ResizeImage.resizeIfNeeded(
        cacheWidth, cacheHeight, MemoryImage(bytes, scale: scale));

```

--------------------------------

### Get Default Instance

Source: https://pub.dev/documentation/fluttercontactpicker/latest/fluttercontactpicker/ContactPickerPlatform/instance.html

Retrieves the default ContactPickerPlatform instance. This is typically used to interact with the contact picking functionality.

```APIDOC
## ContactPickerPlatform get instance

### Description
The default ContactPickerPlatform to use.
Defaults to `MethodChannelContactPicker`.

### Implementation
```dart
static ContactPickerPlatform get instance => _instance;
```
```

--------------------------------

### Get Default ContactPickerPlatform Instance

Source: https://pub.dev/documentation/fluttercontactpicker/latest/fluttercontactpicker/ContactPickerPlatform/instance.html

Retrieve the default ContactPickerPlatform instance. This is typically used to access plugin functionality.

```dart
static ContactPickerPlatform get instance => _instance;
```

--------------------------------

### asProvider Method Implementation

Source: https://pub.dev/documentation/fluttercontactpicker/latest/fluttercontactpicker/Photo/asProvider.html

This snippet shows the implementation of the asProvider method, which returns a MemoryImage created from the image's bytes.

```dart
ImageProvider asProvider() => MemoryImage(bytes);
```

--------------------------------

### Relation Constructors

Source: https://pub.dev/documentation/fluttercontactpicker/latest/fluttercontactpicker/Relation-class.html

Provides information on how to instantiate the Relation class.

```APIDOC
## Constructors

Relation(String? name, RelationType type)
    
const 

Relation.fromMap(Map map) 
    
factory
```

--------------------------------

### EmailAddress Constructors

Source: https://pub.dev/documentation/fluttercontactpicker/latest/fluttercontactpicker/EmailAddress-class.html

Provides information on how to create instances of the EmailAddress class.

```APIDOC
## Constructors

EmailAddress(String? email, String? label)
    
const 

EmailAddress.fromMap(Map map)
    
factory
```

--------------------------------

### FullContact Constructor Implementation

Source: https://pub.dev/documentation/fluttercontactpicker/latest/fluttercontactpicker/FullContact/FullContact.html

This code shows the implementation of the FullContact constructor, which initializes various contact details.

```dart
FullContact(
    this.instantMessengers,
    this.emails,
    this.phones,
    this.addresses,
    this.name,
    this.photo,
    this.note,
    this.company,
    this.sip,
    this.relations,
    this.customFields);

```

--------------------------------

### InstantMessenger Methods

Source: https://pub.dev/documentation/fluttercontactpicker/latest/fluttercontactpicker/InstantMessenger-class.html

Lists the methods available for the InstantMessenger class.

```APIDOC
## Methods 

noSuchMethod(Invocation invocation) → dynamic

tostring() → String
```

--------------------------------

### EmailContact Constructors

Source: https://pub.dev/documentation/fluttercontactpicker/latest/fluttercontactpicker/EmailContact-class.html

Provides information on how to create instances of the EmailContact class.

```APIDOC
## Constructors

EmailContact(String? fullName, EmailAddress? email)
    
const 

EmailContact.fromMap(Map map)
    
factory
```

--------------------------------

### StructuredName Constructors

Source: https://pub.dev/documentation/fluttercontactpicker/latest/fluttercontactpicker/StructuredName-class.html

Provides information on how to create instances of the StructuredName class.

```APIDOC
## Constructors

### StructuredName

```dart
StructuredName(String? firstName, String? middleName, String? nickName, String? lastName)
```

### StructuredName.fromMap

```dart
factory StructuredName.fromMap(Map map)
```
```

--------------------------------

### FullContact Methods

Source: https://pub.dev/documentation/fluttercontactpicker/latest/fluttercontactpicker/FullContact-class.html

Lists the methods available for the FullContact class, including `noSuchMethod` for handling non-existent method calls and `toString` for a string representation of the object.

```APIDOC
## Methods

noSuchMethod(Invocation invocation) → dynamic
tosString() → String
```

--------------------------------

### Address Constructor Implementation

Source: https://pub.dev/documentation/fluttercontactpicker/latest/fluttercontactpicker/Address/Address.html

This code shows the implementation of the Address constructor, which accepts various optional parameters for address details.

```dart
Address(
    {this.type,
    this.customLabel,
    this.addressLine,
    this.pobox,
    this.neighborhood,
    this.city,
    this.region,
    this.postcode,
    this.country,
    this.sortingCode,
    this.recipient,
    this.phone,
    this.organization,
    this.dependentLocality});

```

--------------------------------

### Pick Phone Contact Implementation

Source: https://pub.dev/documentation/fluttercontactpicker/latest/fluttercontactpicker/FlutterContactPicker/pickPhoneContact.html

This is the implementation of the `pickPhoneContact` static method. It delegates the actual contact picking to the platform instance and optionally requests permission.

```dart
static Future<PhoneContact> pickPhoneContact(
        {

        /// Whether to automatically request the required permission if needed or not (See [requestPermission] and [hasPermission])
        bool askForPermission = true}) async =>
    ContactPickerPlatform.instance
        .pickPhoneContact(askForPermission: askForPermission);
```

--------------------------------

### Address Class Constructors

Source: https://pub.dev/documentation/fluttercontactpicker/latest/fluttercontactpicker/Address-class.html

This section details the constructors available for the Address class, allowing for object instantiation either by providing individual address components or by mapping from an existing Map.

```APIDOC
## Constructors

### Address

```dart
Address({
  int? type,
  String? customLabel,
  List<String>? addressLine,
  String? pobox,
  String? neighborhood,
  String? city,
  String? region,
  String? postcode,
  String? country,
  String? sortingCode,
  String? recipient,
  String? phone,
  String? organization,
  String? dependentLocality
})
```

### Address.fromMap

```dart
Address.fromMap(Map map)
```
```

--------------------------------

### FullContact Constructor

Source: https://pub.dev/documentation/fluttercontactpicker/latest/fluttercontactpicker/FullContact/FullContact.html

The FullContact constructor allows you to initialize a FullContact object with various contact details including instant messengers, emails, phone numbers, addresses, name, photo, notes, company, SIP, relations, and custom fields.

```APIDOC
## FullContact Constructor

### Description
Initializes a new FullContact object with provided contact information.

### Parameters
- **instantMessengers** (List<InstantMessenger>) - A list of instant messenger contacts.
- **emails** (List<EmailAddress>) - A list of email addresses.
- **phones** (List<PhoneNumber>) - A list of phone numbers.
- **addresses** (List<Address>) - A list of physical addresses.
- **name** (StructuredName?) - The structured name of the contact (optional).
- **photo** (Photo?) - The photo of the contact (optional).
- **note** (String?) - A textual note about the contact (optional).
- **company** (String?) - The company the contact is associated with (optional).
- **sip** (String?) - The SIP address of the contact (optional).
- **relations** (List<Relation>) - A list of relations to other contacts.
- **customFields** (List<CustomField>) - A list of custom fields for additional information.
```

--------------------------------

### Photo.fromMap Factory Constructor

Source: https://pub.dev/documentation/fluttercontactpicker/latest/fluttercontactpicker/Photo/Photo.fromMap.html

The `fromMap` factory constructor allows you to create a `Photo` object by parsing a `Map`. It expects a map containing a 'photo' key with a `Uint8List` value.

```APIDOC
## Photo.fromMap factory constructor

### Description
Creates a `Photo` object from a `Map`.

### Parameters
#### Path Parameters
- **map** (Map<dynamic, dynamic>) - The map containing photo data. Expected to have a 'photo' key with a `Uint8List` value.

### Implementation
```dart
factory Photo.fromMap(Map<dynamic, dynamic> map) =>
    Photo(map['photo'] as Uint8List);
```
```

--------------------------------

### Contact Constructor

Source: https://pub.dev/documentation/fluttercontactpicker/latest/fluttercontactpicker/Contact/Contact.html

Initializes a new Contact object with a full name.

```APIDOC
## Contact Constructor

### Description
Creates a new Contact instance.

### Parameters
- **fullName** (String?) - The full name of the contact.
```

--------------------------------

### CustomField Constructor

Source: https://pub.dev/documentation/fluttercontactpicker/latest/fluttercontactpicker/CustomField/CustomField.html

Initializes a new CustomField with a name and a label.

```APIDOC
## CustomField Constructor

### Description
Initializes a new CustomField with a name and a label.

### Signature
```dart
const CustomField(String? name, String? label)
```

### Parameters
* **name** (String?) - The name of the custom field.
* **label** (String?) - The label for the custom field.
```

--------------------------------

### PhoneContact Constructor

Source: https://pub.dev/documentation/fluttercontactpicker/latest/fluttercontactpicker/PhoneContact/PhoneContact.html

Initializes a new instance of the PhoneContact class. It takes an optional full name and a required phone number.

```APIDOC
## const PhoneContact(String? fullName, PhoneNumber? phoneNumber)

### Description
Initializes a new instance of the PhoneContact class. It takes an optional full name and a required phone number.

### Parameters
#### Path Parameters
None

#### Query Parameters
None

#### Constructor Parameters
- **fullName** (String?) - Optional - The full name of the contact.
- **phoneNumber** (PhoneNumber?) - Optional - The phone number associated with the contact.

### Implementation
```dart
const PhoneContact(String? fullName, this.phoneNumber) : super(fullName);
```
```

--------------------------------

### asProvider Method

Source: https://pub.dev/documentation/fluttercontactpicker/latest/fluttercontactpicker/Photo/asProvider.html

This method returns the Image as an ImageProvider. It is useful for integrating the image with Flutter's image rendering system.

```APIDOC
## asProvider Method

### Description
Returns the Image as an ImageProvider.

### Signature
`ImageProvider<Object> asProvider()`

### Implementation
```dart
ImageProvider asProvider() => MemoryImage(bytes);
```
```

--------------------------------

### Photo.fromMap Factory Constructor Implementation

Source: https://pub.dev/documentation/fluttercontactpicker/latest/fluttercontactpicker/Photo/Photo.fromMap.html

This snippet shows the implementation of the Photo.fromMap factory constructor. It takes a map and extracts the 'photo' key, casting it to Uint8List to create a Photo object.

```dart
factory Photo.fromMap(Map<dynamic, dynamic> map) =>
    Photo(map['photo'] as Uint8List);
```

--------------------------------

### FullContact.fromMap Factory Constructor

Source: https://pub.dev/documentation/fluttercontactpicker/latest/fluttercontactpicker/FullContact/FullContact.fromMap.html

This factory constructor takes a Map and converts it into a FullContact object. It parses various nested objects like instant messengers, emails, phone numbers, addresses, structured names, photos, relations, and custom fields from the provided map.

```APIDOC
## FullContact.fromMap factory constructor

### Description
Creates a `FullContact` object by parsing data from a `Map`.

### Parameters
#### Parameters
- **map** (Map<dynamic, dynamic>) - The map containing the contact data.

### Returns
A new `FullContact` object populated with data from the map.
```

--------------------------------

### FullContact Constructors

Source: https://pub.dev/documentation/fluttercontactpicker/latest/fluttercontactpicker/FullContact-class.html

Provides two constructors for creating FullContact objects: a primary constructor that takes all contact details as arguments, and a factory constructor for creating a FullContact object from a Map.

```APIDOC
## Constructors

FullContact(List<InstantMessenger> instantMessengers, List<EmailAddress> emails, List<PhoneNumber> phones, List<Address> addresses, StructuredName? name, Photo? photo, String? note, String? company, String? sip, List<Relation> relations, List<CustomField> customFields)

FullContact.fromMap(Map map)
```

--------------------------------

### PhoneContact Constructor Implementation

Source: https://pub.dev/documentation/fluttercontactpicker/latest/fluttercontactpicker/PhoneContact/PhoneContact.html

The actual implementation of the PhoneContact constructor, initializing its fields.

```dart
const PhoneContact(String? fullName, this.phoneNumber) : super(fullName);
```

--------------------------------

### Photo Constructors

Source: https://pub.dev/documentation/fluttercontactpicker/latest/fluttercontactpicker/Photo-class.html

Constructors for creating Photo objects.

```APIDOC
## Constructors

### Photo(Uint8List bytes)

Creates a Photo object from raw image bytes.

### Photo.fromMap(Map map)

Creates a Photo object from a Map. This is a factory constructor.
```

--------------------------------

### Implement pickPhoneContacts Method

Source: https://pub.dev/documentation/fluttercontactpicker/latest/fluttercontactpicker/FlutterContactPicker/pickPhoneContacts.html

This method is a sister to pickEmailContact for selecting multiple contacts. It throws an UnsupportedError on all platforms except the web. The `askForPermission` parameter does not function on the web.

```dart
Future<List<PhoneContact>> pickPhoneContacts(
    {

    /// This doesn't do anything as web does not have permissions for now
    bool askForPermission = true,

    /// Whether to request multiple contacts or not
    bool multiple = true}) {
  return ContactPickerPlatform.instance.pickPhoneContacts(
      askForPermission: askForPermission, multiple: multiple);
}
```

--------------------------------

### Creating an Address from a Map

Source: https://pub.dev/documentation/fluttercontactpicker/latest/fluttercontactpicker/Address/Address.fromMap.html

Use this factory constructor to instantiate an Address object by providing a Map containing address details. Ensure the map keys match the expected properties like 'type', 'customLabel', 'addressLine', etc.

```dart
factory Address.fromMap(Map<dynamic, dynamic> map) => Address(
    type: map['type'],
    customLabel: map['customLabel'],
    addressLine: (map['addressLine'] as List<dynamic>).cast<String>(),
    pobox: map['pobox'],
    neighborhood: map['neighborhood'],
    city: map['city'],
    region: map['region'],
    postcode: map['postcode'],
    country: map['country']);
```

--------------------------------

### pickEmailContact method

Source: https://pub.dev/documentation/fluttercontactpicker/latest/fluttercontactpicker/ContactPickerPlatform/pickEmailContact.html

Asynchronously picks an email contact. Optionally prompts the user for permission.

```APIDOC
## pickEmailContact

### Description
Asynchronously picks an email contact. This method can optionally prompt the user to grant permission before picking the contact.

### Method
Future<EmailContact>

### Parameters
#### Query Parameters
- **askForPermission** (bool) - Optional - Defaults to `true`. If true, the user will be prompted for permission.

### Response
#### Success Response
- Returns a `Future<EmailContact>` containing the selected email contact details.
```

--------------------------------

### Labeled Class

Source: https://pub.dev/documentation/fluttercontactpicker/latest/fluttercontactpicker/Labeled-class.html

Documentation for the Labeled class, including its constructor, properties, methods, and operators.

```APIDOC
## Labeled Class

### Description
Represents an item that can have an associated label. This is an abstract class.

### Constructors
#### Labeled(String? label)
Creates a Labeled object with an optional label.

### Properties
- **hashCode** (int) - The hash code for this object.
- **label** (String?) - Label of the labeled item. Can be null if the item can be labeled but has no label.
- **runtimeType** (Type) - A representation of the runtime type of the object.

### Methods
- **noSuchMethod(Invocation invocation)** (dynamic) - Invoked when a nonexistent method or property is accessed.
- **toString()** (String) - A string representation of this object.

### Operators
- **operator ==(Object other)** (bool) - The equality operator.
```

--------------------------------

### PhoneNumber Constructor Implementation

Source: https://pub.dev/documentation/fluttercontactpicker/latest/fluttercontactpicker/PhoneNumber/PhoneNumber.html

Shows the implementation of the PhoneNumber constructor, initializing the number and label properties.

```dart
const PhoneNumber(this.number, String? label) : super(label);
```

--------------------------------

### InstantMessenger Constructor

Source: https://pub.dev/documentation/fluttercontactpicker/latest/fluttercontactpicker/InstantMessenger/InstantMessenger.html

Initializes a new instance of the InstantMessenger class with the specified type, custom label, IM, and protocol.

```APIDOC
## InstantMessenger Constructor

### Description
Initializes a new instance of the InstantMessenger class.

### Parameters
#### Constructor Parameters
- **type** (int) - Required - The type of instant messenger.
- **customLabel** (String?) - Optional - A custom label for the instant messenger.
- **im** (String?) - Optional - The instant messenger identifier.
- **protocol** (String?) - Optional - The protocol used by the instant messenger.

### Implementation
```dart
InstantMessenger(this.type, this.customLabel, this.im, this.protocol);
```
```

--------------------------------

### Address Class Methods

Source: https://pub.dev/documentation/fluttercontactpicker/latest/fluttercontactpicker/Address-class.html

This section details the methods available for the Address class, including inherited methods like noSuchMethod and overridden methods like toString.

```APIDOC
## Methods

### noSuchMethod

```dart
noSuchMethod(Invocation invocation)
```
Invoked when a nonexistent method or property is accessed. (inherited)

### toString

```dart
toString() → String
```
A string representation of this object. (override)
```

--------------------------------

### pickEmailContacts Method Implementation

Source: https://pub.dev/documentation/fluttercontactpicker/latest/fluttercontactpicker/FlutterContactPicker/pickEmailContacts.html

This is the implementation of the pickEmailContacts method. It delegates the call to the ContactPickerPlatform instance. Note that the askForPermission parameter is non-functional on the web.

```dart
Future<List<EmailContact>> pickEmailContacts(
    {

    /// This doesn't do anything as web does not have permissions for now
    bool askForPermission = true,

    /// Whether to request multiple contacts or not
    bool multiple = true}) {
  return ContactPickerPlatform.instance.pickEmailContacts(
      askForPermission: askForPermission, multiple: multiple);
}
```

--------------------------------

### pickPhoneContacts Method Implementation

Source: https://pub.dev/documentation/fluttercontactpicker/latest/fluttercontactpicker/ContactPickerPlatform/pickPhoneContacts.html

Provides a basic implementation of the pickPhoneContacts method, currently throwing an UnimplementedError.

```dart
Future<List<PhoneContact>> pickPhoneContacts(
    {bool askForPermission = true, bool multiple = true}) {
  throw UnimplementedError('pickPhoneContacts() has not been implemented');
}
```

--------------------------------

### pickPhoneContact Method

Source: https://pub.dev/documentation/fluttercontactpicker/latest/fluttercontactpicker/ContactPickerPlatform/pickPhoneContact.html

Asynchronously picks a phone contact. Optionally prompts the user for permission.

```APIDOC
## pickPhoneContact Method

### Description
Asynchronously picks a phone contact from the device. This method can optionally request permission from the user before proceeding.

### Method Signature
Future<PhoneContact> pickPhoneContact({ bool askForPermission = true })

### Parameters
#### Optional Parameters
- **askForPermission** (bool) - Optional - Defaults to `true`. If `true`, the method will request permission to access contacts before picking. If `false`, it assumes permission has already been granted or will be handled externally.

### Returns
- A `Future<PhoneContact>` that resolves with the selected phone contact. Throws an error if the contact cannot be picked or if permission is denied.
```

--------------------------------

### ContactPickerPlatform Constructor

Source: https://pub.dev/documentation/fluttercontactpicker/latest/fluttercontactpicker/ContactPickerPlatform/ContactPickerPlatform.html

Initializes a new instance of the ContactPickerPlatform class. This constructor is used internally and requires a token.

```dart
ContactPickerPlatform() : super(token: _token);
```

--------------------------------

### Implement requestPermission Method

Source: https://pub.dev/documentation/fluttercontactpicker/latest/fluttercontactpicker/ContactPickerPlatform/requestPermission.html

This snippet shows the basic implementation of the requestPermission method. It is marked as unimplemented and will throw an error if called.

```dart
Future<bool> requestPermission({bool force = false}) async {
  throw UnimplementedError('hasPermission() has not been implemented');
}
```

--------------------------------

### pickPhoneContacts Method

Source: https://pub.dev/documentation/fluttercontactpicker/latest/fluttercontactpicker/ContactPickerPlatform/pickPhoneContacts.html

Allows the selection of phone contacts. Users can specify whether to ask for permission before picking and whether to allow multiple selections.

```APIDOC
## pickPhoneContacts

### Description
Allows the selection of phone contacts from the device. Supports requesting permissions and selecting multiple contacts.

### Method Signature
`Future<List<PhoneContact>> pickPhoneContacts({bool askForPermission = true, bool multiple = true})`

### Parameters
#### Optional Parameters
- **askForPermission** (bool) - Optional - If true, prompts the user for permission to access contacts before picking. Defaults to `true`.
- **multiple** (bool) - Optional - If true, allows the user to select multiple contacts. Defaults to `true`.

### Returns
A `Future` that resolves to a `List` of `PhoneContact` objects representing the selected contacts.
```

--------------------------------

### InstantMessenger Constructor Implementation

Source: https://pub.dev/documentation/fluttercontactpicker/latest/fluttercontactpicker/InstantMessenger/InstantMessenger.html

The implementation of the InstantMessenger constructor, which initializes the object with provided type, custom label, IM, and protocol.

```Dart
InstantMessenger(this.type, this.customLabel, this.im, this.protocol);
```

--------------------------------

### Address Constructor

Source: https://pub.dev/documentation/fluttercontactpicker/latest/fluttercontactpicker/Address/Address.html

Constructs an Address object with various optional fields for detailed contact information.

```APIDOC
## Address Constructor

### Description

Constructs an Address object with various optional fields for detailed contact information.

### Parameters

- **type** (int?) - Optional - The type of address (e.g., home, work).
- **customLabel** (String?) - Optional - A custom label for the address.
- **addressLine** (List<String>?) - Optional - A list of strings representing the lines of the address.
- **pobox** (String?) - Optional - The post office box number.
- **neighborhood** (String?) - Optional - The neighborhood of the address.
- **city** (String?) - Optional - The city of the address.
- **region** (String?) - Optional - The region or state of the address.
- **postcode** (String?) - Optional - The postal code of the address.
- **country** (String?) - Optional - The country of the address.
- **sortingCode** (String?) - Optional - The sorting code for the address.
- **recipient** (String?) - Optional - The name of the recipient.
- **phone** (String?) - Optional - The phone number associated with the address.
- **organization** (String?) - Optional - The organization associated with the address.
- **dependentLocality** (String?) - Optional - The dependent locality of the address.
```

--------------------------------

### getAvailableProperties Method Implementation

Source: https://pub.dev/documentation/fluttercontactpicker/latest/fluttercontactpicker/ContactPickerPlatform/getAvailableProperties.html

This snippet shows the current implementation of the getAvailableProperties method. It is a placeholder that throws an UnimplementedError, meaning the functionality is not yet available.

```dart
Future<List<String>> getAvailableProperties() async =>
    throw UnimplementedError(
        'getAvailableProperties() has not been implemented');
```

--------------------------------

### pickEmailContacts Method Implementation

Source: https://pub.dev/documentation/fluttercontactpicker/latest/fluttercontactpicker/ContactPickerPlatform/pickEmailContacts.html

This snippet shows the basic implementation of the pickEmailContacts method. It throws an UnimplementedError, indicating that the actual contact picking logic needs to be added.

```dart
Future<List<EmailContact>> pickEmailContacts(
    {bool askForPermission = true, bool multiple = true}) {
  throw UnimplementedError('pickEmailContacts() has not been implemented');
}
```

--------------------------------

### pickPhoneContact Method Implementation

Source: https://pub.dev/documentation/fluttercontactpicker/latest/fluttercontactpicker/ContactPickerPlatform/pickPhoneContact.html

This snippet shows the basic implementation of the pickPhoneContact method. It throws an UnimplementedError, indicating that the actual contact picking logic needs to be provided by platform-specific implementations.

```dart
Future<PhoneContact> pickPhoneContact({bool askForPermission = true}) async {
  throw UnimplementedError('pickPhoneContact() has not been implemented');
}
```

--------------------------------

### EmailAddress Methods

Source: https://pub.dev/documentation/fluttercontactpicker/latest/fluttercontactpicker/EmailAddress-class.html

Lists the methods available for the EmailAddress class.

```APIDOC
## Methods 

noSuchMethod(Invocation invocation) → dynamic 
     Invoked when a nonexistent method or property is accessed. 
inherited 

twoString() → String 
     A string representation of this object. 
override
```

--------------------------------

### EmailContact.fromMap Factory Constructor Implementation

Source: https://pub.dev/documentation/fluttercontactpicker/latest/fluttercontactpicker/EmailContact/EmailContact.fromMap.html

This snippet shows the implementation of the EmailContact.fromMap factory constructor. It takes a Map and creates an EmailContact object by extracting 'fullName' and an EmailAddress object from the 'email' key within the map.

```dart
factory EmailContact.fromMap(Map<dynamic, dynamic> map) =>
    EmailContact(map['fullName'], EmailAddress.fromMap(map['email']));
```

--------------------------------

### Contact Class

Source: https://pub.dev/documentation/fluttercontactpicker/latest/fluttercontactpicker/Contact-class.html

Provides details on the Contact class, including its constructor, properties, and methods.

```APIDOC
## Contact Class

### Description
Represents a contact with properties like full name.

### Constructors
#### Contact(String? fullName)
- **fullName** (String?) - The full name of the contact.

### Properties
#### fullName → String?
- **Description**: Full name of the contact. On Flutter Web, this can be null if the user unselects the name in the contact picker interface.
- **Type**: String?
- **Modifier**: final

#### hashCode → int
- **Description**: The hash code for this object.
- **Type**: int
- **Modifier**: no setter, override

#### runtimeType → Type
- **Description**: A representation of the runtime type of the object.
- **Type**: Type
- **Modifier**: no setter, inherited

### Methods
#### noSuchMethod(Invocation invocation) → dynamic
- **Description**: Invoked when a nonexistent method or property is accessed.
- **Type**: dynamic
- **Modifier**: inherited

#### toString() → String
- **Description**: A string representation of this object.
- **Type**: String
- **Modifier**: override

### Operators
#### operator ==(Object other) → bool
- **Description**: The equality operator.
- **Type**: bool
- **Modifier**: override
```

--------------------------------

### CustomField Constructors

Source: https://pub.dev/documentation/fluttercontactpicker/latest/fluttercontactpicker/CustomField-class.html

Provides constructors for creating CustomField instances.

```APIDOC
## Constructors

### CustomField(String? name, String? label)

Creates a new CustomField instance.

- **name** (String?): The name of the custom field.
- **label** (String?): The label associated with the custom field.

### CustomField.fromMap(Map map)

Creates a CustomField instance from a Map.

- **map** (Map): The map containing the custom field data.
```

--------------------------------

### Relation.fromMap Factory Constructor Implementation

Source: https://pub.dev/documentation/fluttercontactpicker/latest/fluttercontactpicker/Relation/Relation.fromMap.html

This snippet shows the implementation of the Relation.fromMap factory constructor. It takes a Map and uses its 'name' and 'type' keys to instantiate a Relation object.

```dart
factory Relation.fromMap(Map<dynamic, dynamic> map) =>
    Relation(map['name'], _typeByName(map['type']));
```

--------------------------------

### pickEmailContacts Method

Source: https://pub.dev/documentation/fluttercontactpicker/latest/fluttercontactpicker/ContactPickerPlatform/pickEmailContacts.html

Allows users to pick email contacts from their device. Supports single or multiple selections and an option to prompt for permission.

```APIDOC
## pickEmailContacts

### Description
Allows users to pick email contacts from their device. Supports single or multiple selections and an option to prompt for permission.

### Method Signature
Future<List<EmailContact>> pickEmailContacts({ bool askForPermission = true, bool multiple = true })

### Parameters
#### Optional Parameters
- **askForPermission** (bool) - Optional - If true, prompts the user for permission to access contacts. Defaults to true.
- **multiple** (bool) - Optional - If true, allows the selection of multiple contacts. Defaults to true.

### Returns
- A Future list of EmailContact objects representing the selected contacts.
```

--------------------------------

### available

Source: https://pub.dev/documentation/fluttercontactpicker/latest/fluttercontactpicker/FlutterContactPicker-class.html

Checks if the current browser environment supports contact pickers. This property is only relevant for web platforms.

```APIDOC
## available

### Description
Checks if the current browser environment supports contact pickers. This property is only relevant for web platforms.

### Property
`available` → bool

### See Also
- https://web.dev/contact-picker/
- https://developer.mozilla.org/en-US/docs/Web/API/Contact_Picker_API#Browser_compatibility
```

--------------------------------

### Labeled Constructor Implementation

Source: https://pub.dev/documentation/fluttercontactpicker/latest/fluttercontactpicker/Labeled/Labeled.html

This snippet shows the implementation of the Labeled constructor, which takes a nullable string label.

```dart
const Labeled(this.label);
```

--------------------------------

### Image asWidget Method Implementation

Source: https://pub.dev/documentation/fluttercontactpicker/latest/fluttercontactpicker/Photo/asWidget.html

This method converts image bytes into an Image widget. It accepts optional scale, cacheWidth, and cacheHeight parameters for customization. Use this when you need to display image data stored as bytes.

```dart
Image asWidget({
  double scale = 1.0,
  int? cacheWidth,
  int? cacheHeight,
}) =>
    Image.memory(
      bytes,
      scale: scale,
      cacheHeight: cacheHeight,
      cacheWidth: cacheWidth,
    );
```

--------------------------------

### Address toString Method Implementation

Source: https://pub.dev/documentation/fluttercontactpicker/latest/fluttercontactpicker/Address/toString.html

This snippet shows the implementation of the toString method for the Address class. It returns a formatted string containing all the fields of the Address object.

```dart
@override
String toString() {
  return 'Address{type: $type, customLabel: $customLabel, addressLine: $addressLine, pobox: $pobox, neighborhood: $neighborhood, city: $city, region: $region, postcode: $postcode, sortingCode: $sortingCode, recipient: $recipient, country: $country, phone: $phone, organization: $organization, dependentLocality: $dependentLocality}';
}
```

--------------------------------

### ContactPickerPlatform Methods

Source: https://pub.dev/documentation/fluttercontactpicker/latest/fluttercontactpicker/ContactPickerPlatform-class.html

Methods for interacting with contact picking functionalities.

```APIDOC
## Methods

### getAvailableProperties()
- **Returns**: `Future<List<String>>`
- **Description**: Retrieves a list of available contact properties that can be picked.

### hasPermission()
- **Returns**: `Future<bool>`
- **Description**: Checks if the application has been granted permission to access contacts.

### pickEmailContact({bool askForPermission = true})
- **Parameters**:
  - **askForPermission** (`bool`, Optional): If true, prompts the user for permission before picking. Defaults to true.
- **Returns**: `Future<EmailContact>`
- **Description**: Picks a single email contact. If `askForPermission` is true, it will request permission first.

### pickEmailContacts({bool askForPermission = true, bool multiple = true})
- **Parameters**:
  - **askForPermission** (`bool`, Optional): If true, prompts the user for permission before picking. Defaults to true.
  - **multiple** (`bool`, Optional): If true, allows picking multiple email contacts. Defaults to true.
- **Returns**: `Future<List<EmailContact>>`
- **Description**: Picks one or more email contacts. Handles permission requests based on `askForPermission`.

### pickFullContact({bool askForPermission = true})
- **Parameters**:
  - **askForPermission** (`bool`, Optional): If true, prompts the user for permission before picking. Defaults to true.
- **Returns**: `Future<FullContact>`
- **Description**: Picks a single full contact (including name, phone, email, etc.). Requests permission if `askForPermission` is true.

### pickFullContacts({bool askForPermission = true, bool multiple = true})
- **Parameters**:
  - **askForPermission** (`bool`, Optional): If true, prompts the user for permission before picking. Defaults to true.
  - **multiple** (`bool`, Optional): If true, allows picking multiple full contacts. Defaults to true.
- **Returns**: `Future<List<FullContact>>`
- **Description**: Picks one or more full contacts. Permission is requested if `askForPermission` is true.

### pickPhoneContact({bool askForPermission = true})
- **Parameters**:
  - **askForPermission** (`bool`, Optional): If true, prompts the user for permission before picking. Defaults to true.
- **Returns**: `Future<PhoneContact>`
- **Description**: Picks a single phone contact. Requests permission if `askForPermission` is true.

### pickPhoneContacts({bool askForPermission = true, bool multiple = true})
- **Parameters**:
  - **askForPermission** (`bool`, Optional): If true, prompts the user for permission before picking. Defaults to true.
  - **multiple** (`bool`, Optional): If true, allows picking multiple phone contacts. Defaults to true.
- **Returns**: `Future<List<PhoneContact>>`
- **Description**: Picks one or more phone contacts. Handles permission requests based on `askForPermission`.

### requestPermission({bool force = false})
- **Parameters**:
  - **force** (`bool`, Optional): If true, forces the permission request even if already granted. Defaults to false.
- **Returns**: `Future<bool>`
- **Description**: Requests permission to access contacts. Returns true if permission is granted, false otherwise.

### noSuchMethod(Invocation invocation)
- **Parameters**:
  - **invocation** (`Invocation`): The invocation details for the nonexistent method or property.
- **Returns**: `dynamic`
- **Description**: Invoked when a nonexistent method or property is accessed (inherited from Object).
```

--------------------------------

### EmailAddress Constructor

Source: https://pub.dev/documentation/fluttercontactpicker/latest/fluttercontactpicker/EmailAddress/EmailAddress.html

Constructs an EmailAddress object with an optional email and label.

```APIDOC
## EmailAddress Constructor

### Description
Creates a new EmailAddress instance.

### Parameters
- **email** (String?) - The email address string. Optional.
- **label** (String?) - A label for the email address (e.g., 'home', 'work'). Optional.

### Example
```dart
const EmailAddress('test@example.com', 'personal');
```
```

--------------------------------

### PhoneContact Constructors

Source: https://pub.dev/documentation/fluttercontactpicker/latest/fluttercontactpicker/PhoneContact-class.html

Constructors for creating PhoneContact objects.

```APIDOC
## Constructors

### PhoneContact(String? fullName, PhoneNumber? phoneNumber)

Creates a new PhoneContact object.

### const PhoneContact.fromMap(Map map)

Creates a PhoneContact object from a Map.
```

--------------------------------

### EmailAddress Constructor

Source: https://pub.dev/documentation/fluttercontactpicker/latest/fluttercontactpicker/EmailAddress/EmailAddress.html

Initializes an EmailAddress object with an email and an optional label. The label is inherited from the base class.

```dart
const EmailAddress(
  this.email,
  String? label
) : super(label);
```

--------------------------------

### getAvailableProperties static method

Source: https://pub.dev/documentation/fluttercontactpicker/latest/fluttercontactpicker/FlutterContactPicker/getAvailableProperties.html

Fetches a list of all available properties of a contact. This method only works for web platforms. Refer to https://web.dev/contact-picker/ for more information on the underlying web API.

```APIDOC
## getAvailableProperties static method

### Description
Fetches a list of all available properties of a contact. This method is specifically designed for web implementations and leverages the browser's Contact Picker API.

### Method Signature
`static Future<List<String>> getAvailableProperties()`

### Platform
Web only

### Returns
A `Future` that resolves to a `List<String>` containing the names of all available contact properties that can be requested.

### See Also
- [Contact Picker API - web.dev](https://web.dev/contact-picker/)
```

--------------------------------

### Pick Full Contact Implementation

Source: https://pub.dev/documentation/fluttercontactpicker/latest/fluttercontactpicker/FlutterContactPicker/pickFullContact.html

This is the implementation of the pickFullContact static method. It delegates the call to the platform instance and can be configured to automatically request necessary permissions.

```dart
static Future<FullContact> pickFullContact(
        {

        /// Whether to automatically request the required permission if needed or not (See [requestPermission] and [hasPermission])
        bool askForPermission = true}) async =>
    ContactPickerPlatform.instance
        .pickFullContact(askForPermission: askForPermission);
```

--------------------------------

### pickEmailContact Method Implementation

Source: https://pub.dev/documentation/fluttercontactpicker/latest/fluttercontactpicker/ContactPickerPlatform/pickEmailContact.html

The current implementation of the pickEmailContact method, which throws an UnimplementedError.

```dart
Future<EmailContact> pickEmailContact({bool askForPermission = true}) async {
  throw UnimplementedError('pickEmailContact() has not been implemented');
}
```

--------------------------------

### Photo Constructor Implementation

Source: https://pub.dev/documentation/fluttercontactpicker/latest/fluttercontactpicker/Photo/Photo.html

The Photo constructor takes a Uint8List, typically representing image data, and assigns it to the 'bytes' property.

```dart
Photo(this.bytes);
```

--------------------------------

### Relation.fromMap Factory Constructor

Source: https://pub.dev/documentation/fluttercontactpicker/latest/fluttercontactpicker/Relation/Relation.fromMap.html

Creates a Relation object by parsing a Map. It expects 'name' and 'type' keys within the map.

```APIDOC
## Relation.fromMap(Map map)

### Description
Factory constructor to create a `Relation` object from a `Map`. It extracts the 'name' and 'type' from the provided map to initialize the `Relation`.

### Parameters
#### Path Parameters
* **map** (Map) - Required - A map containing the relation data, expected to have 'name' and 'type' keys.

### Implementation
```dart
factory Relation.fromMap(Map<dynamic, dynamic> map) =>
    Relation(map['name'], _typeByName(map['type']));
```
```

--------------------------------

### asResizedProvider Method Signature

Source: https://pub.dev/documentation/fluttercontactpicker/latest/fluttercontactpicker/Photo/asResizedProvider.html

The asResizedProvider method returns an ImageProvider for an image, with options to control scaling and caching dimensions.

```APIDOC
## asResizedProvider

### Description
Returns the Image as a `ResizeImage`. See `Image.memory` for more details.

### Method Signature
```dart
ImageProvider<Object> asResizedProvider({
  double scale = 1.0,
  int? cacheWidth,
  int? cacheHeight,
})
```

### Parameters
#### Optional Parameters
- **scale** (double) - Optional - The scaling factor for the image. Defaults to 1.0.
- **cacheWidth** (int) - Optional - The desired width for caching the image.
- **cacheHeight** (int) - Optional - The desired height for caching the image.

### Returns
- `ImageProvider<Object>` - An `ImageProvider` that can be used to display the resized image.
```

--------------------------------

### CustomField Constructor Implementation

Source: https://pub.dev/documentation/fluttercontactpicker/latest/fluttercontactpicker/CustomField/CustomField.html

The implementation of the CustomField constructor, initializing name and calling the super constructor with the label.

```dart
const CustomField(this.name, String? label) : super(label);
```

--------------------------------

### EmailContact Constructor

Source: https://pub.dev/documentation/fluttercontactpicker/latest/fluttercontactpicker/EmailContact/EmailContact.html

Constructs an instance of the EmailContact class. It takes an optional full name and an EmailAddress object.

```APIDOC
## EmailContact()

### Description
Constructs an instance of the EmailContact class. It takes an optional full name and an EmailAddress object.

### Parameters
#### Path Parameters
None

#### Query Parameters
None

#### Constructor Parameters
- **fullName** (String?) - Optional - The full name of the contact.
- **email** (EmailAddress) - Required - The email address of the contact.

### Implementation
```dart
const EmailContact(String? fullName, this.email) : super(fullName);
```
```

--------------------------------

### InstantMessenger Properties

Source: https://pub.dev/documentation/fluttercontactpicker/latest/fluttercontactpicker/InstantMessenger-class.html

Details the properties available for an InstantMessenger object.

```APIDOC
## Properties 

customLabel → String?

im → String?

protocol → String?

type → int
```

--------------------------------

### Fetch Available Contact Properties (Web)

Source: https://pub.dev/documentation/fluttercontactpicker/latest/fluttercontactpicker/FlutterContactPicker/getAvailableProperties.html

Use this static method to retrieve a list of all available properties for contacts. This functionality is specific to web platforms. Refer to web.dev/contact-picker/ for more details.

```dart
static Future<List<String>> getAvailableProperties() =>
    ContactPickerPlatform.instance.getAvailableProperties();
```

--------------------------------

### EmailContact Methods

Source: https://pub.dev/documentation/fluttercontactpicker/latest/fluttercontactpicker/EmailContact-class.html

Lists the methods available for the EmailContact class.

```APIDOC
## Methods 

noSuchMethod(Invocation invocation) → dynamic 
     Invoked when a nonexistent method or property is accessed. 
inherited 

toString() → String 
     A string representation of this object. 
override
```

--------------------------------

### EmailAddress.fromMap Factory Constructor

Source: https://pub.dev/documentation/fluttercontactpicker/latest/fluttercontactpicker/EmailAddress/EmailAddress.fromMap.html

Use this factory constructor to create an EmailAddress object by parsing a Map. It expects the map to contain 'email' and 'label' keys.

```dart
factory EmailAddress.fromMap(Map<dynamic, dynamic> map) =>
    EmailAddress(map['email'], map['label']);
```

--------------------------------

### pickFullContact Method Implementation

Source: https://pub.dev/documentation/fluttercontactpicker/latest/fluttercontactpicker/ContactPickerPlatform/pickFullContact.html

This snippet shows the signature and placeholder implementation of the pickFullContact method. It indicates that the method is not yet implemented and will throw an UnimplementedError when called.

```dart
Future<FullContact> pickFullContact({bool askForPermission = true}) {
  throw UnimplementedError('pickFullContact() has not been implemented');
}
```

--------------------------------

### Pick Email Contact Implementation

Source: https://pub.dev/documentation/fluttercontactpicker/latest/fluttercontactpicker/FlutterContactPicker/pickEmailContact.html

This is the implementation of the static pickEmailContact method. It handles requesting permissions automatically if needed. Requires hasPermission on Android 11+ and Xiaomi devices.

```dart
static Future<EmailContact> pickEmailContact(
        {

        /// Whether to automatically request the required permission if needed or not (See [requestPermission] and [hasPermission])
        bool askForPermission = true}) async =>
    ContactPickerPlatform.instance
        .pickEmailContact(askForPermission: askForPermission);
```

--------------------------------

### Address.fromMap Factory Constructor

Source: https://pub.dev/documentation/fluttercontactpicker/latest/fluttercontactpicker/Address/Address.fromMap.html

The Address.fromMap constructor allows you to create an Address object by parsing a Map. This is useful for deserializing address data from external sources.

```APIDOC
## Address.fromMap(Map map)

### Description
Creates an Address object from a Map.

### Parameters
#### Path Parameters
- **map** (Map<dynamic, dynamic>) - Required - The map containing address data.

### Request Example
```dart
Map<String, dynamic> addressData = {
  'type': 'home',
  'customLabel': 'My House',
  'addressLine': ['123 Main St', 'Apt 4B'],
  'pobox': 'PO Box 123',
  'neighborhood': 'Downtown',
  'city': 'Anytown',
  'region': 'CA',
  'postcode': '90210',
  'country': 'USA'
};
Address myAddress = Address.fromMap(addressData);
```

### Response
#### Success Response
- **Address** - An instance of the Address class populated with data from the map.
```

--------------------------------

### InstantMessenger.fromMap Factory Constructor

Source: https://pub.dev/documentation/fluttercontactpicker/latest/fluttercontactpicker/InstantMessenger/InstantMessenger.fromMap.html

Use this factory constructor to create an InstantMessenger instance from a Map. It extracts 'type', 'customLabel', 'im', and 'protocol' from the map.

```dart
factory InstantMessenger.fromMap(Map<dynamic, dynamic> map) =>
    InstantMessenger(map['type'], map['customLabel'], map['im'], map['protocol']);
```

--------------------------------

### ContactPickerPlatform available property implementation

Source: https://pub.dev/documentation/fluttercontactpicker/latest/fluttercontactpicker/ContactPickerPlatform/available.html

This snippet shows the default implementation of the 'available' getter, which throws an UnimplementedError. This indicates that the concrete implementation must be provided by subclasses.

```dart
bool get available =>
    throw UnimplementedError('available has not been implemented');
```

--------------------------------

### Contact Constructor

Source: https://pub.dev/documentation/fluttercontactpicker/latest/fluttercontactpicker/Contact/Contact.html

Creates a new Contact object with a specified full name. This is the primary way to instantiate a Contact.

```dart
const Contact(this.fullName);
```

--------------------------------

### StructuredName.fromMap

Source: https://pub.dev/documentation/fluttercontactpicker/latest/fluttercontactpicker/StructuredName/StructuredName.fromMap.html

Creates a StructuredName instance from a Map. The map should contain keys like 'firstName', 'middleName', 'nickname', and 'lastName'.

```APIDOC
## StructuredName.fromMap(Map map)

### Description
Creates a StructuredName instance from a Map.

### Parameters
#### Path Parameters
- **map** (Map<dynamic, dynamic>) - A map containing the name components.

### Implementation
```dart
factory StructuredName.fromMap(Map<dynamic, dynamic> map) => StructuredName(
    map['firstName'], map['middleName'], map['nickname'], map['lastName']);
```
```

--------------------------------

### InstantMessenger Operators

Source: https://pub.dev/documentation/fluttercontactpicker/latest/fluttercontactpicker/InstantMessenger-class.html

Describes the operators supported by the InstantMessenger class.

```APIDOC
## Operators 

operator ==(Object other) → bool
```

--------------------------------

### StructuredName Methods

Source: https://pub.dev/documentation/fluttercontactpicker/latest/fluttercontactpicker/StructuredName-class.html

Information on the methods available for the StructuredName class.

```APIDOC
## Methods

### toString

- Returns: `String`
- Description: A string representation of this object.

### noSuchMethod

- Parameters:
  - `invocation` (Invocation): The invocation details.
- Returns: `dynamic`
- Description: Invoked when a nonexistent method or property is accessed.
```

--------------------------------

### InstantMessenger.fromMap

Source: https://pub.dev/documentation/fluttercontactpicker/latest/fluttercontactpicker/InstantMessenger/InstantMessenger.fromMap.html

Creates an InstantMessenger instance from a Map. This is a factory constructor that parses a map to initialize the object's properties.

```APIDOC
## InstantMessenger.fromMap(Map map)

### Description
Creates an InstantMessenger instance from a Map. This factory constructor parses a map to initialize the object's properties.

### Parameters
#### Path Parameters
- **map** (Map<dynamic, dynamic>) - Required - The map containing data to initialize the InstantMessenger.

### Implementation
```dart
factory InstantMessenger.fromMap(Map<dynamic, dynamic> map) =>
    InstantMessenger(
        map['type'], map['customLabel'], map['im'], map['protocol']);
```
```

--------------------------------

### EmailAddress.fromMap Factory Constructor

Source: https://pub.dev/documentation/fluttercontactpicker/latest/fluttercontactpicker/EmailAddress/EmailAddress.fromMap.html

The EmailAddress.fromMap factory constructor takes a Map and returns an EmailAddress object. It is used to deserialize EmailAddress data from a map format.

```APIDOC
## EmailAddress.fromMap factory constructor

### Description

Creates an `EmailAddress` object from a `Map`. This is useful for deserializing data from sources like JSON.

### Parameters

#### Map Parameters

- **map** (Map<dynamic, dynamic>) - Required - A map containing the email address and its label. Expected keys are 'email' and 'label'.

### Implementation

```dart
factory EmailAddress.fromMap(Map<dynamic, dynamic> map) =>
    EmailAddress(map['email'], map['label']);
```

### Example

```dart
// Assuming you have a map like this:
final Map<String, String> emailData = {
  'email': 'test@example.com',
  'label': 'Work',
};

// Create an EmailAddress object:
final EmailAddress emailAddress = EmailAddress.fromMap(emailData);

print(emailAddress.email); // Output: test@example.com
print(emailAddress.label); // Output: Work
```
```

--------------------------------

### StructuredName Constructor

Source: https://pub.dev/documentation/fluttercontactpicker/latest/fluttercontactpicker/StructuredName/StructuredName.html

The StructuredName constructor allows you to create an instance of StructuredName by providing optional first, middle, nickname, and last name strings.

```APIDOC
## StructuredName Constructor

### Description
Initializes a new instance of the StructuredName class.

### Parameters
#### Positional Parameters
- **firstName** (String?) - Optional - The first name.
- **middleName** (String?) - Optional - The middle name.
- **nickName** (String?) - Optional - The nickname.
- **lastName** (String?) - Optional - The last name.

### Implementation
```dart
StructuredName(this.firstName, this.middleName, this.nickName, this.lastName);
```
```

--------------------------------

### PhoneNumber Constructors

Source: https://pub.dev/documentation/fluttercontactpicker/latest/fluttercontactpicker/PhoneNumber-class.html

Constructors for creating PhoneNumber objects.

```APIDOC
## Constructors

### PhoneNumber(String? number, String? label)

Creates a new PhoneNumber object.

### PhoneNumber.fromMap(Map map)

Creates a PhoneNumber object from a Map.
```

--------------------------------

### hashCode Implementation

Source: https://pub.dev/documentation/fluttercontactpicker/latest/fluttercontactpicker/InstantMessenger/hashCode.html

This snippet shows the implementation of the hashCode getter, combining hash codes of several properties using the XOR operator.

```dart
@override
int get hashCode =>
    type.hashCode ^ customLabel.hashCode ^ im.hashCode ^ protocol.hashCode;
```

--------------------------------

### FullContact.fromMap Factory Constructor

Source: https://pub.dev/documentation/fluttercontactpicker/latest/fluttercontactpicker/FullContact/FullContact.fromMap.html

Use this factory constructor to parse a Map and create a FullContact object. It handles nested objects and lists for various contact details.

```dart
factory FullContact.fromMap(Map<dynamic, dynamic> map) {
  return FullContact(
    (map['instantMessengers'] as List<dynamic>)
        .map((element) => InstantMessenger.fromMap(element))
        .cast<InstantMessenger>()
        .toList(growable: false),
    (map['emails'] as List<dynamic>)
        .map((element) => EmailAddress.fromMap(element))
        .cast<EmailAddress>()
        .toList(growable: false),
    (map['phones'] as List<dynamic>)
        .map((element) => PhoneNumber.fromMap(element))
        .cast<PhoneNumber>()
        .toList(growable: false),
    (map['addresses'] as List<dynamic>)
        .map((element) => Address.fromMap(element))
        .cast<Address>()
        .toList(growable: false),
    StructuredName.fromMap(map["name"]),
    map['photo'] == null ? null : Photo.fromMap(map),
    map['note'],
    map['company'],
    map['sip'],
    (map['relations'] as List<dynamic>)
        .map((element) => Relation.fromMap(element))
        .cast<Relation>()
        .toList(growable: false),
    (map['custom_fields'] as List<dynamic>)
        .map((element) => CustomField.fromMap(element))
        .cast<CustomField>()
        .toList(growable: false),
  );
}
```

--------------------------------

### Pick a Phone Contact

Source: https://pub.dev/documentation/fluttercontactpicker/latest/index.html

Use this snippet to grab a phone contact using the native OS contact picker. Ensure the fluttercontactpicker package is imported.

```dart
final PhoneContact contact =
    await FlutterContactPicker.pickPhoneContact();

```

--------------------------------

### ContactPickerPlatform Static Properties

Source: https://pub.dev/documentation/fluttercontactpicker/latest/fluttercontactpicker/ContactPickerPlatform-class.html

Static properties of the ContactPickerPlatform class.

```APIDOC
## Static Properties

### instance
- **Type**: `ContactPickerPlatform`
- **Description**: The default ContactPickerPlatform instance to use. This is a getter/setter pair.
```

--------------------------------

### PhoneContact Constructor Signature

Source: https://pub.dev/documentation/fluttercontactpicker/latest/fluttercontactpicker/PhoneContact/PhoneContact.html

Defines the parameters for creating a new PhoneContact object.

```dart
const PhoneContact(
  1. String? fullName,
  2. PhoneNumber? phoneNumber

)
```
Tokens:
Raw