Home

Awesome

A fix to the famous iOS zoom bug on orientation change to portrait

By Sergio Lopes, from Brazil. Public domain.

I work at Alura teaching Front-end and Mobile online courses.

Before you continue

This bug was officially fixed by Apple on iOS 6. Prior versions still suffer from this problem, so this project may help. Or you can simply ignore this bug for old users and assume that everybody will upgrade to a fixed iOS. I use this strategy now.

Quickstart

See the full demo on your iOS device.

If you never saw the iOS zoom bug, see this demo on an iOS device in portrait mode and rotate the device to landscape. You'll see an annoying zoom that only occurs in iOS.

The trick

By setting the viewport to width=device-width, without initial-scale, we prevent the bug from happening. But the viewport is always stuck to device-width size, even in landscape. That means 320px in iPhone and 768px in iPad no matter if portrait or landscape.

The trick is to change the viewport to width=device-height so that we have full screen realstate. But in portrait that will mean a 480px width on iPhone and 1024px on iPad, effectivily zooming out our page.

So we apply apply a CSS3 scale transform to scale up the content in portrait mode.

The final effect is a perfectly zoomable page without the famous bug and working both in portrait and landscape with the right size.

Applying the trick

The only requirement is that you use a container div wrapping all your page (if you are using Mobile Boilerplate you already have this):

<html>
...

<body>
    <div id="container">
        <!-- Your page here -->
    </div>
</body>
</html>

Then, just include the script at the bottom of the page. Use the minified version.

Also, you shouldn't style your html, body and #container elements with properties that can mess with size manipulation (width, max-width, margin etc). Always assume your #container will take the entire screen and build your page inside it.

One notice about media queries

A minor drawback is that the device is stuck in width=device-height size no matter if you're in portrait or landscape. This can cause you problems when dealing with media queries.

For example, people usually do this to target iPhone in landscape:

@media screen and (min-width: 480px)

If you do, this will stop working on iOS when you use this script. You'll need a more hackish media querie to target a landscaped iPhone without wrongly affecting its portrait behavior:

@media screen and (device-height: 480px) and (device-width: 320px) and (width: 480px) and (max-height: 320px)

For a real use of this media queries, including a bullet proof version targeting non-iOS devices as well, see the demos CSS.

Other tricks

If you don't want to give your wrapper div a container id, you can configure another id name via <body data-container="myid">.

For performance reasons, it's recommended that the script is called at the bottom of the page. But your users will see a small screen flick effect when visiting the page on portrait mode. If you want to avoid this, you can put the script right after the opening container div.

Real world demos

I applied the hack to two famous responsive mobile sites to see how it would act in the real world.

Colly.com

BostonGlobe.com

(TODO: still needs to adjust the media queries not to target portrait iOS as landscape)

Other solutions

Many smart people have thought about this bug, resulting in several different solutions. Here are some known solutions, and my comments:

I think that all solutions have serious drawbacks. That's why this project has born.

Testing and contributions

The script seems pretty solid. I tested it on an 2nd generation iPod Touch running iOS 4.2.1, a iPad 2 running iOS 4.3.3 and on iOS emulators versions 4.3 and 5.0 both for iPhone and iPad.

But you find any bugs and want to contribute, file a issue, fork the project, send a pull request etc.

License & Credits

Created by Sérgio Lopes.

Released in public domain, do whatever you want with the code.