contacts 0.3.0-nullsafety.1
contacts: ^0.3.0-nullsafety.1 copied to clipboard

Flutter Android iOS

A set of classes useful for managing contacts, for save in a database and retrieve from it.

Contacts #

A set of classes useful for managing contacts. In order to save data in a database, each class has toMap() method, and to retrieve data from the database, each class has fromMap(Map<String, dynamic> map) method.

Contact class #

The main class of this package is definitely Contacts. All the other classes, although they can be useful separately, were created thinking about the formation of a contact and interaction with it.

For the choice of contact information, I referred to those that can be saved for a contact in Google Contacts. The idea is to make it easy to save a contact’s information in an exhaustive and, at the same time, well organized way.

Another important goal is to facilitate the saving of class instances in a database and, in the opposite sense, the retrieve of the instance starting from the information saved in the database.

To give an example, a Contact can look like this:

Contact(
    addresses: [address],
    birthday: birthday,
    chats: [chat],
    customFields: [customField],
    emails: [email1, email2],
    events: [event],
    internetCalls: [internetCall],
    jobs: [job],
    name: name,
    notes: 'Notes',
    phones: [phone1, phone2],
    relationships: [relationship1, relationship2],
    websites: [website],
)

Other classes #

The other classes of this package are:

  • Address

    An example:

    Address(
        city: 'City',
        countryRegion: 'CountryRegion',
        label: 'Label',
        postalCode: 'PostalCode',
        postOfficeBox: 'PostOfficeBox',
        province: 'Province',
        street: 'Street',
    )
    
  • Chat

    An example:

    Chat(
        chat: 'Chat',
        label: 'Label',
    )
    
  • ContactEvent

    An example:

    ContactEvent(
        date: DateTime(2020, 2, 27, 13, 27, 0),
        title: 'Event Title',
    ),
    
  • CustomField

    An example:

    CustomField(
        content: 'A simple content.',
        label: 'Label',
    )
    
  • Email

    An example:

    Email(
        address: 'example@email.com',
        label: 'Label',
    )
    

    We can send an email to this address with:

    mailTo(
        subject: 'The subject of the email',
        body: 'The body of the email.',
    );
    
  • InternetCall

    An example:

    InternetCall(
        internetCall: 'Name',
        label: 'Label',
    )
    
  • Job

    An example:

    Job(
        company: 'Company',
        department: 'Department',
        jobTitle: 'Job title',
    )
    
  • Name

    An example:

    Name(
        fileAs: 'File as',
        firstName: 'First name',
        lastName: 'Last name',
        middleName: 'Middle name',
        nickname: 'Nickname',
        phoneticFirst: 'Phonetic first',
        phoneticLast: 'Phonetic last',
        phoneticMiddle: 'Phonetic middle',
        prefix: 'Prefix',
        suffix: 'Suffix',
    )
    
  • Phone

    An example:

    Phone(
        countryCode: '39',
        label: 'Personal',
        local: '0123456789',
    )
    

    We can call this phone number with the method call(). Also, we can send a SMS using sms() method:

    sms(body: 'This is the body of the SMS.');
    
  • Relationship

    An example:

    Relationship(
        label: 'Friend',
        name: 'Name',
    )
    
  • Website

    An example:

    Website(
        label: 'Label',
        url: 'url.com',
    )
    

    We can open this website calling the open() method. It allows to set the bool forceSafariVC and bool forceWebView parameters.

1
likes
80
pub points
16%
popularity

A set of classes useful for managing contacts, for save in a database and retrieve from it.

Homepage

Documentation

API reference

Uploader

marco87developer@gmail.com

License

unknown (LICENSE)

Dependencies

flutter, pedantic, url_launcher

More

Packages that depend on contacts