Preventing Form Caching With Javascript And jQuery

Posted May 8, 2009 at 9:48 AM

Tags: Javascript / DHTML, HTML / CSS

Form caching is the browser mechanism where by you can navigate away from a form and then back to the same form (using the browser navigation buttons) and the form data that you entered remains in the form. Normally, this is a really awesome feature as the basis for re-navigating to a page is to update information that you entered previously. However, in a small percentage of use-cases, form caching can cause serious problems; specifically, if you have dynamic form rendering in which the display is changed on the fly due to user interaction. In cases like that, form caching may present the user with an unusable interface (especially when cached hidden form fields are being used to store state information).

So, in the small percentage of use-cases where we want to prevent form data from being cached, what can we do? I am not sure if this solution is the best one, and in fact, it uses some voodoo magic that I don't fully understand; but, this is the only cross-browser compatible solution that I could come up with:

NOTE: Working on scaling this video. In the mean time, you can view SWF here.

 
 
 
 
 
 
 
 
 
 

As you can see, the trick is to manually reset() the form right after the form XHTML loads. This works in Google Chrome right way. But, to get this manual reset to work in IE, we need to give it a slight delay using setTimeout(). Getting it to work in FireFox requires one more update and this is the voodoo magic that I was referring to above; by simply including the jQuery Javascript library, the setTimeout() trick works in Firefox, Chrome, and IE. Even though we are not using the jQuery library in any way, if we exclude it, then the manual reset never executes in Firefox.

So, even though I don't fully understand why this works (must be the way jQuery hooks into the event listening framework of the browser), it seems that jQuery saves our butts again! (Oh jQuery, how do I love thee, let me count the ways).

If you want to see the code, here it is:

 Launch code in new window » Download code as text file »

  • <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
  • <html>
  • <head>
  • <title>Form Cache Issue</title>
  •  
  • <!---
  • Include the jQuery Javascript library. I am not sure
  • why this makes a difference, but by including it, the
  • Javascript below takes effect.
  • --->
  • <script type="text/javascript" src="jquery-1.3.2.min.js"></script>
  • </head>
  • <body>
  •  
  • <h1>
  • Form Cache Issue
  • </h1>
  •  
  • <form id="form">
  •  
  • <p>
  • Name:<br />
  • <input type="text" name="name" size="40" />
  • </p>
  •  
  • <p>
  • Newsletter:<br />
  •  
  • <input type="radio" name="newsletter" value="1"
  • checked="true"
  • />
  • Daily Digest<br />
  •  
  • <input type="radio" name="newsletter" value="2" />
  • Deals / Discounts Only<br />
  • </p>
  •  
  • <p>
  • Preferred Contact Time:<br />
  • <select name="contact_time">
  • <option value="1" selected="true">Day Time</option>
  • <option value="2">Night Time</option>
  • </select>
  • </p>
  •  
  • <p>
  • <input type="submit" value="Submit" />
  • </p>
  •  
  • </form>
  •  
  •  
  • <!---
  • Right after the form HTML has been rendered, set a timeout
  • for the form reset. A slight timeout is needed for this
  • code to work in Internet Explorer.
  • --->
  • <script type="text/javascript">
  •  
  • setTimeout(
  • function(){
  • document.getElementById( "form" ).reset();
  • },
  • 5
  • );
  •  
  • </script>
  •  
  • </body>
  • </html>

Form caching is a really useful mechanism for the user experience. But, in the small percentage of use-cases where we want to disable it, we need to do a little fenagling.

NOTE: No use of headers (pragma, cache-control, etc.) had any effect on form caching.

Download Code Snippet ZIP File

Post Comment  |  Ask Ben  |  Permalink  |  Other Searches  |  Print Page



Learning ColdFusion 9 - ColdFusion 9 tutorials, samples, examples, demos

Reader Comments

May 8, 2009 at 11:47 AM // reply »
9 Comments

Wow, I was just trying to figure this out. Thanks Ben!


May 8, 2009 at 11:48 AM // reply »
6,516 Comments

@Chris,

No problem my man :)


May 8, 2009 at 12:02 PM // reply »
1 Comments

I'm skeptical about the jQuery trickery for Firefox thing. I just tried your code in FF and it worked no problem without the jQuery lib. It also works without the timeout (but I'm not surprised the timeout is needed for IE). I really can't see any reason why FF would not reset the form with a simple reset() call.

I know no-one likes to hear this but: Are you 100% sure you tested in Firefox correctly? :) I just can't duplicate it.


May 8, 2009 at 12:12 PM // reply »
6,516 Comments

@Martin,

I definitely testing this thoroughly. However, that doesn't mean that my version of Firefox might just be a bit different. Maybe the different versions or even the settings can affect this??


May 8, 2009 at 12:42 PM // reply »
20 Comments

I tried it with and without and I get the same results as Martin. What version of FF are you using?


May 8, 2009 at 12:48 PM // reply »
6,516 Comments

@anthony,

Firefox 3.0.10


May 8, 2009 at 5:11 PM // reply »
1 Comments

Not sure of the browser compatibility, but I've had good luck in the past by adding autocomplete="off" to the form.


May 8, 2009 at 5:46 PM // reply »
6,516 Comments

@6dust,

I've only ever used it with individual fields; I have not tried putting it on the form element before.


May 10, 2009 at 7:05 AM // reply »
24 Comments

Hi Ben,

If your using JQuery a more elegant solution might be to utilise the document ready method and a selector to access the form. This way you don't have to worry about using a timeout. I just tested this and it works in all 3 browsers (hoping the code will display ok):

$(document).ready(function() { $("#form").get(0).reset(); })


May 10, 2009 at 4:32 PM // reply »
6,516 Comments

@James,

The only reason I didn't want to use the document-ready method is that I didn't want someone to start interacting with the form before the page finished loading (say on a long-running JS include at the bottom or something) and then the form resets after they have entered some data.

Using the setTimeout() I can basically run this the moment the FORM HTML can be interacted with.

That aside, it's nice to know that the $() ready function works in all the browsers to do form resets. Sweet!


May 10, 2009 at 5:05 PM // reply »
24 Comments

Aha yeah, I see where you coming from now - I hadn't considered the form being interacted with if the page was slow to fully render.
I was thinking that you must have had a very good reason for going with the non-JQuery method.

Your solution handles this issue very well indeed.

I know I've said it on Twitter but way to go on the new design - it looks fantastic. Fresh and modern.. Great job.


May 11, 2009 at 4:30 AM // reply »
1 Comments

If you need to reset a form element, it's often because the element performs an action which changes the form in some way.

In these cases I often perform that action again on load so the user is presented with the form display they left the page with.

This is really simple with jQuery. Presuming the event is being assigned on DOM ready you can chain the call to run the event after the call to assign it. Something like:

$(function () {
$("#makes").change(function () {
populateSelect($("#models"), this.value)
}).change()
})

Of course this example only works if the populateSelect function here rewrites #models rather than altering it.


May 11, 2009 at 9:14 AM // reply »
6,516 Comments

@Sean,

That's definitely another way to go; you could have a form "initialization" method that updates the display based on the form values. This could be used at any point.

The more complex the layout, the harder this would become, I assume.


May 15, 2009 at 8:22 PM // reply »
1 Comments

This truly saved my sanity on a complicated booking form! What a great JS trick to add to the "webvoodoo" magic bag. Many awesome thanks for sharing this with us all :D


ewr
Oct 6, 2009 at 11:22 PM // reply »
1 Comments

erwr


Post Comment  |  Ask Ben

Recent Blog Comments
Nov 21, 2009 at 1:13 PM
My First ColdFusion Builder Extension - Encrypting And Decrypting CFM / CFC Files
@Ben, Because I am pedantic, I just want to make sure that everyone knows there is absolutely no encryption going on. There is only encoding and obfuscation. The cfencode tool only obfuscates your C ... read »
Nov 21, 2009 at 12:28 PM
Using ColdFusion Structures To Remove Duplicate List Values
@Jody I can't seem to get your code sample to work. If you are still having problems, try this code out and see if it gets you what you wanted. <!--- Comma delimited list with various duplicates ... read »
Nov 21, 2009 at 11:03 AM
Groovy Operator Overloading Does Not Work In The ColdFusion Context
Hi Ben, Thanks for this informative post. Now I am reading ur old posts too ... read »
Nov 21, 2009 at 10:56 AM
HostMySite.com Has The Best ColdFusion Hosting
@Mehul, Yes very nice people, however several downtimes per day which was not acceptable. Hence we had to move out. I am glad you are having good luck with them so far. ... read »
Nov 20, 2009 at 11:32 PM
Five Months Without Hungarian Notation And I'm Loving It
I've used headless camel case for years for not only ColdFusion variables, but also SQL tables and fields... pretty much everything involving code. I also subscribe to the "don't abbreviate and clea ... read »
Nov 20, 2009 at 11:00 PM
Five Months Without Hungarian Notation And I'm Loving It
@Marcel, Yeah, I always err on the side of longer but more readable variable names. As for the camel casing of CF methods and the headless camel casing of custom items, I get around this by always ... read »
Nov 20, 2009 at 10:56 PM
Five Months Without Hungarian Notation And I'm Loving It
I use the following and love it: my.namespace.MyComponents.functionMethodsOrUDF() CONSTANT_VALUES_OR_PROPERTIES One thing I always try is to CamelCaseBuiltInColdFusionFunctions() so others can tell ... read »