A UIImageView subclass which allows you to align the image left/right/top/bottom, even when contentMode is AspectFit.
Switch branches/tags
Nothing to show
Clone or download
Andrei Stanescu
Andrei Stanescu updated podspec
Latest commit 4102815 Oct 22, 2015
Type Name Latest commit message Commit time
Failed to load latest commit information.
Example removed All Rights Reserved from file headers Feb 2, 2015
UIImageViewAligned removed All Rights Reserved from file headers Feb 2, 2015
docs using png instead of jpg Jul 29, 2013
.gitignore Initial commit Jul 29, 2013
LICENSE Update LICENSE Jul 29, 2013
README.md Update README.md Jul 29, 2013
UIImageViewAligned.podspec updated podspec Oct 22, 2015


What is it?

It is a subclass of UIImageView that allows you to customize the alignment of the displayed image inside the view's frame. This works even if the contentMode is set to AspectFit, AspectFill or ScaleToFill.

Why a subclass of UIImageView, and not a standard UIView?

Because there are many cool categories built on top of UIImageView. Subclassing a standard UIView would mean losing them.

For example, AFNetworking's async UIImageView category works perfectly using this container class, and you don't have to worry about a thing.

How does it work?

When initialized, UIImageViewAligned will create a inner UIImageView which will actually hold the image displayed. The main class then just repositions this inner UIImageView to achieve your desired alignment.

At runtime, you can change the image, contentMode or alignment and the image will reposition itself correctly.

The image property of UIImageViewAligned is overwritten to forward the calls to the inner UIImageView, so you can just drag-n-drop into your app.


From what I tested, it works on iOS 6.0+. Also, it supports autorotation and will reposition the image correctly.

Using Interface Builder

You can setup the alignment from Interface Builder using the Identity Inspector tab for the UIImageViewAligned. There, you can add custom boolean properties that will be set when the view is instantiated. The possible boolean names are: alignLeft alignRight alignTop alignBottom

Below is a screenshot of an example. You will not get an immediate feedback in IB regarding your alignment, but it will work at runtime.

alt tag