Released 4 years ago , Last update 4 years ago

Beautiful viewController with a tableView and amazing effects like a viewController in the Spotify app.


This code must be used under ARC. If your code doesn't use ARC you can mark this source with the compiler flag -fobjc-arc

Example Usage

In the package is included an example to use this class.

The best thing to do, is to extend the MGSpotyViewController. In the package see the class MGViewController.{h,m} as example.

Here the explanation:

Init is easy. You have just to pass the main image for the blur effect:

MGViewController *spotyViewController = [[MGViewController alloc] initWithMainImage:[UIImage imageNamed:@"example"]];

MGViewController extends MGSpotyViewController:

//  MGViewController.h
//  MGSpotyView
//  Created by Matteo Gobbi on 25/06/2014.
//  Copyright (c) 2014 Matteo Gobbi. All rights reserved.

#import "MGSpotyViewController.h"

@interface MGViewController : MGSpotyViewController


In the implementation file, first of all you should set the overView. The overView is basically the header view which remains over the blur image:

- (void)viewDidLoad {
    [self setOverView:self.myOverView];

//This is just an example view created by code, but you can return any type of view.
- (UIView *)myOverView {
    UIView *view = [[UIView alloc] initWithFrame:self.overView.bounds];

    //Add an example imageView
    UIImageView *imageView = [[UIImageView alloc] initWithFrame:CGRectMake(,, 100.0, 100.0)];
    [imageView setContentMode:UIViewContentModeScaleAspectFill];
    [imageView setClipsToBounds:YES];
    [imageView setImage:[UIImage imageNamed:@"example"]];
    [imageView.layer setBorderColor:[UIColor whiteColor].CGColor];
    [imageView.layer setBorderWidth:2.0];
    [imageView.layer setCornerRadius:imageView.frame.size.width/2.0];

    //Add an example label
    UILabel *lblTitle = [[UILabel alloc] initWithFrame:CGRectMake(,, 240.0, 50.0)];
    [lblTitle setText:@"Name Surname"];
    [lblTitle setFont:[UIFont boldSystemFontOfSize:25.0]];
    [lblTitle setTextAlignment:NSTextAlignmentCenter];
    [lblTitle setTextColor:[UIColor whiteColor]];

    [view addSubview:imageView];
    [view addSubview:lblTitle];

    return view;

The best overView to set should be a squared view with transparent background, with the same width and height of self.overView which is a flexible container view in the class MGSpotyViewController. Width and height are so equal and they correspond with the width of the screen.

So for a classic iPhone the best frame would be: {0, 0, 320.0, 320.0} with flexible width and height.

But to make the size adaptable to the screen starting from the first time, the best thing to do would be set the same bounds of the property self.overView.

For this reason you see the line:

UIView *view = [[UIView alloc] initWithFrame:self.overView.bounds];

The other thing to configure is the tableView. The tableView is already in the MGSpotyViewController, you have just to override the UITableViewDelegate and UITableViewDatasource methods.

You have just to remember that the section 0 is reserved, so you have to return 1 section in more and managing only your sections (section > 0):

#pragma mark - UITableView Delegate & Datasource

- (NSInteger)numberOfSectionsInTableView:(UITableView *)tableView {
    NSInteger mySections = 1;

    return mySections + 1;

- (NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection:(NSInteger)section {    
    if (section == 1)
        return 20;

    return 0;

- (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath {
    static NSString *identifier = @"CellID";
    UITableViewCell *cell = [tableView dequeueReusableCellWithIdentifier:identifier];

    if(!cell) {
        cell = [[UITableViewCell alloc] initWithStyle:UITableViewCellStyleDefault reuseIdentifier:identifier];
        [cell setBackgroundColor:[UIColor darkGrayColor]];
        [cell.textLabel setTextColor:[UIColor whiteColor]];

    [cell.textLabel setText:@"Cell"];

    return cell;

And, if you need to manage sections header title or sections header view, for the section 0 you should call the superclass method, like in the example below:

//Here call the superclass method
- (UIView *)tableView:(UITableView *)tableView viewForHeaderInSection:(NSInteger)section {
    if(section == 0)
        return [super tableView:tableView viewForHeaderInSection:section];

    return nil;

- (NSString *)tableView:(UITableView *)tableView titleForHeaderInSection:(NSInteger)section {
    if(section == 1)
        return @"My Section";

    return nil;

//Here call the superclass method
- (CGFloat)tableView:(UITableView *)tableView heightForHeaderInSection:(NSInteger)section {
    if(section == 0)
        return [super tableView:tableView heightForHeaderInSection:section];

    if(section == 1)
        return 20.0;

    return 0.0;



MIT license

The MIT license is an open-source license.

Need custom services for this product? Get a quote
License » MIT license Download

Get A Quote

What do you need?
  • Custom development
  • Integration
  • Customization / Reskinning
  • Consultation
When do you need it?
  • Soon
  • Next week
  • Next month
  • Anytime

Thanks for getting in touch!

Your quote details have been received and we'll get back to you soon.

or Get a quote

for customization or integration services

Or enter your name and Email
No comments have been posted yet.