Skip to content

Instantly share code, notes, and snippets.

Created August 31, 2011 11:42
Star You must be signed in to star a gist
What would you like to do?
Normalized hide address bar for iOS & Android
* Normalized hide address bar for iOS & Android
* (c) Scott Jehl,
* MIT License
(function( win ){
var doc = win.document;
// If there's a hash, or addEventListener is undefined, stop here
if( !location.hash && win.addEventListener ){
//scroll to 1
window.scrollTo( 0, 1 );
var scrollTop = 1,
getScrollTop = function(){
return win.pageYOffset || doc.compatMode === "CSS1Compat" && doc.documentElement.scrollTop || doc.body.scrollTop || 0;
//reset to 0 on bodyready, if needed
bodycheck = setInterval(function(){
if( doc.body ){
clearInterval( bodycheck );
scrollTop = getScrollTop();
win.scrollTo( 0, scrollTop === 1 ? 0 : 1 );
}, 15 );
win.addEventListener( "load", function(){
//at load, if user hasn't scrolled more than 20 or so...
if( getScrollTop() < 20 ){
//reset to hide addr bar at onload
win.scrollTo( 0, scrollTop === 1 ? 0 : 1 );
}, 0);
} );
})( this );
Copy link

Hi Scott, thanks for the response. I have added the part to exclude opera mini. In mobile boilerplate there is already the UA detection due to the iPhone viewport scale bug, so I thought it makes sense to use something we already have. But I must admit your approach with detecting the behavior is naturally much cooler and also not depending on other code.

Copy link

After analyzing this code I found some issues that in my opinion need some more discussion.

  1. Line 6
    ( !location.hash || !win.addEventListener ) is according to De Morgans Laws equivalent to:
    !( location.hash && win.addEventListener ) and this is probably not, what we want to have here. I think the idea is to stop, when one (or both) of the operands are false. So I suggest to replace line 6 with: ( !location.hash && win.addEventListener )

  2. Line 12
    The getScrollTop function always returns 0 because of a hard to catch error. This results always in a final y offset of 1, also on iOS! Well, 1 pixel is hard to see and the url bar is hidden. But our intention was to detect the behaviour and hide the bar on iOS with 0 pixel. But why is the function failing? Firstly, "scrollTop" in doc.body is always true. So always doc.body.scrollTop is returned. And this is always 0! It seems to be a mobile browser implementation issue. The idea here was to set scrollTop and get the vertical scroll position with it. But this is not working. If you do something like:

window.document.body.scrollTop = 99;
var x = window.document.body.scrollTop;

x remains 0 on all mobile browsers I have tested so far. So I suggest to replace Line 12 with:
return ( win.pageYOffset === doc.body.scrollTop ) ? 1 : 0;

Now we get 1 as return value on iOS and 0 on other systems. Frankly speaking, the return value depends more on the browser than of the OS. And yes, we can hide the url bar with a vertival scroll of 0 on Android! Eg. the Dolphin Browser is very happy with zero!

Through our change in line 12 we don't get the „hypothetical“ scroll position that line 27 expects. So I change line 27 to:
if( !( ( win.pageYOffset || doc.body.scrollTop ) > 20 ) ){

Some browsers deliver the first operand, others the second and even some both. With the implementation above we are happy whatever we get.

If you have no space to scroll you can't scroll. It's that simple. I don't consider this a bug. Seems to be very reasonable...;-)
But you can analyze the size of you page and add something to the bottom if needed. You can add this little snippet to make it work:

if ( (doc.body.clientHeight - 100) < win.innerHeight ) {
var pageFill = doc.createElement("DIV"); = ( win.innerHeight - doc.body.clientHeight + 100 ) + "px";
doc.getElementsByTagName('body')[0].appendChild( pageFill );

After that the url bar is hidden as wanted. I have uploaded my version of the „hide url bar“-problem which also looks at the screen width to avoid 1 px scrolling on desktop browsers. You might delete this part and also the page extension part above if not needed. Both are very rough approaches that probably need more fine tuning but they are ok for the web project I am working on at the moment .

Anyway, the basic idea behind Scott's approach is great and I learned a lot by analyzing it. I guess my approach is far away from beeing perfect or errorfree, so let me know what you think about it and what to improve. Thanks!

Copy link

@JulesNeck -
Yes, I realized that afterwards & was trying to set some sort of min-height with CSS and somehow add the height of the URL bar, but failed to get it working, so I'll definitely try out your js code. Thanks you!
~ JK ~

Copy link

jwlms commented Oct 28, 2011

Is this going to make it into jQuery Mobile?

Copy link

I wrote this. Works on iOS and Android:

hideAddressBar : function(){
if (navigator.userAgent.match(/Android/i)) {
window.scrollTo(0,0); // reset in case prev not scrolled
var nPageH = $(document).height();
var nViewH = window.outerHeight;
if (nViewH > nPageH ) {
nViewH = nViewH / window.devicePixelRatio;
$('BODY').css('height',nViewH + 'px');
addEventListener("load", function() {
setTimeout(hideURLbar, 0);
setTimeout(hideURLbar, 500);
}, false);
function hideURLbar(){
return this;

Copy link

ambientp commented Dec 9, 2011

Hi this is my first time using github and I may be doing it wrong

If I put the raw code inside script tags in the head or body nothing happens
if I use the embed code it seems to give the desired effect only the code appears on the pages as the page loads and then disappears once the content is loaded. If the page is not long enough then the code is visible after where the page ends.

I would really appreciate some advice on this. I've spent a long time looking for an address bar solution and this is the only one that comes close


Copy link

@ambientp The code I pasted was raw from my project, and the hideAddressBar function is part of an object. If you want to use it in the most vanilla sense do this:

<script type="text/javascript"> $(function(){ hideAddressBar(); }); function hideAddressBar(){ if (navigator.userAgent.match(/Android/i)) { window.scrollTo(0,0); // reset in case prev not scrolled var nPageH = $(document).height(); var nViewH = window.outerHeight; if (nViewH > nPageH ) { nViewH = nViewH / window.devicePixelRatio; $('BODY').css('height',nViewH + 'px'); } window.scrollTo(0,1); }else{ addEventListener("load", function() { setTimeout(hideURLbar, 0); setTimeout(hideURLbar, 500); }, false); } function hideURLbar(){ if(!pageYOffset){ window.scrollTo(0,1); } } return this; } <script> Also be sure to include jQuery in your project BEFORE this script tag.

Copy link

ambientp commented Dec 9, 2011

Hi @Fresheyeball
I copy/pasted it just before the and it doesn't seem to be working.
I'm kinda new to all this, is there anything else I need to do to get it to work?
Also I'm testing this on an itouch. Not sure if that makes a difference or not

Copy link

@ambientp can I get the url of your site? You can contact me on skype at skype id = 'fresheyeball'

Copy link

ambientp commented Dec 10, 2011 via email

Copy link

@ambientp, I just tested your site on ios4 iso5 and android 3. and the address bar got hidden.

Copy link

ambientp commented Jan 3, 2012 via email

Copy link

kreaninw commented Feb 2, 2012

Thanks for the code. At first I tested and the code didn't work, I though it has to be something wrong. And just to note that, if your site contains an event that use jQuery scrollTop to y 0, it will override the code and cause it not to work on Android. So, I added +1 to my scrollTop value and it solved the issue completely.

Copy link

Not working :/

Copy link

It's working perfectly(not test on ICS yet). The other thing that it won't work is your page is too shot.

Copy link

There's a repo here with more recent code, fwiw

Copy link

chriv commented Apr 30, 2012

I swear, I cannot get any version of this to work. window.scrollTo(0,0) ; window.scrollTo(0,1) ; hideAddressBar() above ; hideaddressbar.js ; anything. here's where I'm trying it: . Cannot imagine what I'm doing wrong. I keep uploading code to my server and I test it in four browsers:

  • Android (ICS) Browser (usually fails)
  • Android Dolphin HD Browser (only scrolls 1 pixel or nothing)
  • Android Chrome Beta Browser (doesn't scroll)
  • Android FireFox Browser (not beta) (worse than doesn't scroll - extends page too far)
    I don't have an iPhone to test on.
    I'm open to suggestions. I've been tweaking code to do this for 2 months (no, it's not the only thing I've been coding).

Copy link

hedefalk commented Mar 1, 2013

Does this work in ios6? I had a simple window.scrollTo( 0, 1 ); that works in <= ios5 but not in ios6.

Thanks, Viktor

Copy link

NeroLang commented May 6, 2014

it doesn't work.

Copy link

Apparently, not working properly anymore. It adds extra padding...

Copy link

does this work?

Copy link

It doesn't work in Android v4.x

Copy link

This is outdated. Thanks for this snippet. Works on iOS 7- only.

Copy link

2020 | That does not work (

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment