Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/manuelescrig/MEVHorizontalContacts

An iOS UICollectionViewLayout subclass to show a list of contacts with configurable expandable items.
https://github.com/manuelescrig/MEVHorizontalContacts

cocoapods ios ios-animation objective-c objective-c-library

Last synced: about 2 months ago
JSON representation

An iOS UICollectionViewLayout subclass to show a list of contacts with configurable expandable items.

Lists

README 

        
# MEVHorizontalContacts

An **iOS** UICollectionViewLayout subclass to show a **list of contacts** with configurable expandable **items**.



[![CI Status](http://img.shields.io/travis/manuelescrig/MEVHorizontalContacts.svg?style=flat)](https://travis-ci.org/manuelescrig/MEVHorizontalContacts)

[![Version](https://img.shields.io/cocoapods/v/MEVHorizontalContacts.svg?style=flat)](http://cocoapods.org/pods/MEVHorizontalContacts)

[![License](https://img.shields.io/cocoapods/l/MEVHorizontalContacts.svg?style=flat)](http://cocoapods.org/pods/MEVHorizontalContacts)

[![Platform](https://img.shields.io/cocoapods/p/MEVHorizontalContacts.svg?style=flat)](http://cocoapods.org/pods/MEVHorizontalContacts)

[![Language](http://img.shields.io/badge/language-objective--c-blue.svg?style=flat)](https://developer.apple.com/library/mac/documentation/Cocoa/Conceptual/ProgrammingWithObjectiveC/Introduction/Introduction.html)






 

## Features

- [x] Customizable contacts cells

- [x] Customizable contact items cells

- [x] Different sizes and responsive design

- [x] Multiple delegate methods



## Demo App



Run the demo app and play with it!

[Demo App](https://appetize.io/app/y5mq0egpmtvvj6e7up8qg07qjg?device=iphone6splus&scale=50&orientation=portrait&osVersion=9.3&deviceColor=white)



## Demo Project



To run the example project, clone the repo, and run `pod install` from the Example directory first.



## Getting Started



### Requirements



Requires iOS SDK version > 7.0



Requires ARC



### Installation with CocoaPods



[CocoaPods](cocoapods.org) is a 3rd-party dependency manager for Swift and Objective-C projects. For more information, refer to the [CocoaPods Getting Started Guide](https://guides.cocoapods.org/using/getting-started.html). Otherwise, you can install CocoaPods with the following command:



```bash

$ gem install cocoapods

```



#### Podfile

To integrate MEVHorizontalContacts into your Xcode project using CocoaPods, specify it in your `Podfile`:



```ruby

source 'https://github.com/CocoaPods/Specs.git'

pod 'MEVHorizontalContacts'

```



Then, run the following command:



```bash

$ pod install

```



###  Installation Manually

To integrate MEVHorizontalContacts into your Xcode project manually, just include the filest from [/Pod/Classes/](https://github.com/manuelescrig/MEVHorizontalContacts/tree/master/MEVHorizontalContacts/Classes) folder in your App’s Xcode project.



Then, import the following file your classes:

```objc

#import "MEVHorizontalContacts.h"

```



## Quick Guide



### Usage



###### 1. Import class



```objective-c

#import "MEVHorizontalContacts.h"

```



###### 2. Add Datasource and Delegate protocols.



```objective-c

@interface ViewController () 

@property (nonatomic, strong) MEVHorizontalContacts *horizontalContacts;

@end

```



###### 3. Create, initialize and add MEVHorizontalContacts view.



```objective-c

_horizontalContacts = [MEVHorizontalContacts new];

_horizontalContacts.backgroundColor = [UIColor whiteColor];

_horizontalContacts.dataSource = self;

_horizontalContacts.delegate = self;

[self addSubview:_horizontalContacts];

[self addConstraints:[NSLayoutConstraint constraintsWithVisualFormat:@"H:|[horizontalContacts]|" options:NSLayoutFormatAlignAllCenterX metrics:nil views:@{@"horizontalContacts" : _horizontalContacts}]];

[self addConstraints:[NSLayoutConstraint constraintsWithVisualFormat:@"V:|[horizontalContacts]|" options:NSLayoutFormatAlignAllCenterY metrics:nil views:@{@"horizontalContacts" : _horizontalContacts}]];

```



###### 4. Implement Datasource Methods



```objective-c

#pragma mark - MEVHorizontalContactsDataSource Methods



- (NSInteger)numberOfContacts;

- (NSInteger)numberOfItemsAtContactIndex:(NSInteger)index;

- (MEVHorizontalContactsCell *)contactAtIndex:(NSInteger)index;

- (MEVHorizontalContactsCell *)item:(NSInteger)item atContactIndex:(NSInteger)index;

- (UIEdgeInsets)horizontalContactsInsets;

- (NSInteger)horizontalContactsSpacing;



```



###### 5. Implement Delegate Methods



```objective-c

#pragma mark - MEVHorizontalContactsDelegate Methods



- (void)contactSelectedAtIndex:(NSInteger)index;

- (void)item:(NSInteger)item selectedAtContactIndex:(NSInteger)index;



```



### Example



###### Customization 1






```objective-c

- (MEVHorizontalContactsCell *)contactAtIndex:(NSInteger)index {

    MEVHorizontalContactsCell *cell = [_horizontalContacts dequeueReusableContactCellForIndex:index];

    [cell.imageView setImage:[UIImage imageNamed:[self getImageNameAtIndex:index]]];

    [cell.imageView.layer setBorderColor:[UIColor colorWithRed:34/255.0f green:167/255.0f blue:240/255.0f alpha:1].CGColor];

    [cell.imageView.layer setBorderWidth:1.0f];

    [cell.label setText:[self getUserNameAtIndex:index]];

    [cell.label setFont:[UIFont boldSystemFontOfSize:12.0f]];

    return cell;

}



- (MEVHorizontalContactsCell *)item:(NSInteger)item atContactIndex:(NSInteger)index {



    UIImage *image;

    NSString *labelText;

    switch (item) {

        case 0:

            labelText = @"Call";

            image = [UIImage imageNamed:@"actionCall"];

            break;

        case 1:

            labelText = @"Email";

            image = [UIImage imageNamed:@"actionEmail"];

            break;

        case 2:

            labelText = @"Message";

            image = [UIImage imageNamed:@"actionMessage"];

            break;

        default:

            labelText = @"Call";

            image = [UIImage imageNamed:@"actionCall"];

            break;

    }

    

    MEVHorizontalContactsCell *cell = [_horizontalContacts dequeueReusableItemCellForIndex:index];

    [cell.imageView setImage:image];

    [cell.imageView setTintColor:[UIColor colorWithRed:34/255.0f green:167/255.0f blue:240/255.0f alpha:1]];

    [cell.imageView.layer setBorderColor:[UIColor colorWithRed:34/255.0f green:167/255.0f blue:240/255.0f alpha:1].CGColor];

    [cell.imageView.layer setBorderWidth:1.0f];

    [cell.label setText:labelText];

    [cell.label setFont:[UIFont boldSystemFontOfSize:10.0f]];



    return cell;

}



```



###### Customization 2






```objective-c

- (MEVHorizontalContactsCell *)contactAtIndex:(NSInteger)index {

    MEVHorizontalContactsCell *cell = [_horizontalContacts dequeueReusableContactCellForIndex:index];

    [cell.imageView setImage:[UIImage imageNamed:[self getImageNameAtIndex:index]]];

    [cell.label setText:[self getUserNameAtIndex:index]];

    return cell;

}



- (MEVHorizontalContactsCell *)item:(NSInteger)item atContactIndex:(NSInteger)index {

    

    UIImage *image;

    NSString *labelText;

    switch (item) {

        case 0:

            labelText = @"Call";

            image = [UIImage imageNamed:@"actionCall"];

            break;

        case 1:

            labelText = @"Email";

            image = [UIImage imageNamed:@"actionEmail"];

            break;

        case 2:

            labelText = @"Message";

            image = [UIImage imageNamed:@"actionMessage"];

            break;

        default:

            labelText = @"Call";

            image = [UIImage imageNamed:@"actionCall"];

            break;

    }

    

    MEVHorizontalContactsCell *cell = [_horizontalContacts dequeueReusableItemCellForIndex:index];

    [cell.imageView setImage:image];

    [cell.imageView setBackgroundColor:[UIColor colorWithRed:34/255.0f green:167/255.0f blue:240/255.0f alpha:1]];

    [cell.imageView setTintColor:[UIColor whiteColor]];

    [cell.label setText:labelText];

    [cell.label setTextColor:[UIColor colorWithRed:34/255.0f green:167/255.0f blue:240/255.0f alpha:1]];

    return cell;

}



```



## Roadmap

- [x] CocoaPods support

- [ ] Carthage support

- [ ] Tests



## Change Log



See [Changelog.md](https://github.com/manuelescrig/MEVHorizontalContacts/blob/master/CHANGELOG.md)



## Author



- Manuel Escrig Ventura, [@manuelescrig](https://www.twitter.com/manuelescrig/)

- Email [[email protected]](mailto:[email protected])

- Portfolio [http://ventura.media](http://ventura.media)



## Apps using this library



- [People Tracker App](http://itunes.apple.com/us/app/people-tracker-pro/id539205975?ls=1&mt=8), [www.peopletrackerapp.com](http://www.peopletrackerapp.com)



## License



MEVHorizontalContacts is available under the MIT license. See the [LICENSE](https://github.com/manuelescrig/MEVHorizontalContacts/blob/master/LICENSE) file for more info.



Icons made by [Gregor Cresnar](http://www.flaticon.com/authors/gregor-cresnar) is licensed by [Creative Commons BY 3.0](http://creativecommons.org/licenses/by/3.0/)