Ti.TiltImageView

com.caffeinalab.titanium.tiltimageview

This module emulate the Facebook Paper tilt-fullscreen ImageViewer.

It provides a scrollable, pinchable, zoomable and fullscreen ImageViewer.

The widget is fully compatible with iOS and Android, with different features.

On iOS 7+, it uses the new ti.coremotion Titanium module to move the image across your movements. So you need to install the ti.coremotion module or this feature will not work.

On Android, due system limitations, the image is not pinchable/zoomable.

Thanks to this post by SubjC for making me understand some things about this widget.

Original "Facebook Paper" Controller

Installation

Via Gittio

gittio install com.caffeinalab.titanium.tiltimageview

Via Github

Download the latest release, unzip in app/widgets and add in your config.json, under dependencies:

"dependencies": {
    "com.caffeinalab.titanium.tiltimageview": "*"
}

Usage

In Views

Require the widget in an Alloy View

<Widget src="com.caffeinalab.titanium.tiltimageview" id="paperImageView" image="http://lorempixel.com/1024/1024/city" title="This is the title!" />

And open when you need in the relative controller

$.paperImageView.open();

In Controllers

Instance the widget and open it

var tilter = Alloy.createWidget('com.caffeinalab.titanium.tiltimageview', { /* constructor options */ });
tilter.open();

Constructor options

image (String|Ti.Blob)

The image to show. Must be a URL or a Ti.Blob

[closeOnClick] (Boolean, default: true)

Add a listener to close the modal on the click over the image

[title] (String)

The title to show on the bottom of the View.

[subtitle] (String)

The subtitle to show

API

open()

Open the widget.

close()

Close the widget