Better onChange with Dijit’s intermediateChanges

By  on  

One of the things I love about Dojo's UI framework, Dijit, is that its widgets provide loads of functionality within one property that would take a bit of Javascript jousting to create on its own.  One of those widget properties is intermediateChanges.  intermediateChanges is a boolean property of dijit.form.* widgets (TextBox, ComboBox, etc.) that fires the onChange event whenever the value of the TextBox or other form widget changes.  Not the typical onChange event which only fires when the field is blurred -- the event fires on each keystroke which changes value within the widget.

The Dojo JavaScript

The intermediateChanges property is set to false by default so you will need to enable it if you want to use it:

// Create a TextBox that fires onChange whenever the input's value truly changes
var textbox = new dijit.form.TextBox({
	// Set intermediateChanges on
	intermediateChanges: true
});

Connection to the onChange event would look like:

// When the value changes...
dojo.connect(textbox,"onChange",function(value) {
	// Now do something with the value...
	console.log("Value is: ",value);
});

// Value is: D
// Value is: Da
// Value is: Dav
// Value is: Davu
// Value is: Dav
// Value is: Davi
// Value is: David
// Value is: David_
// Value is: David_W

The console.log statement will run with each valuable keystroke or if content is dragged into the box.  intermediateChanges is especially helpful when creating or modifying a widget that should act as an autocompleter.  Keep in mind that simple onKeyUp changes can be misleading, as the value may not change (imagine simply pressing the shift key) -- that's why intermediateChanges is helpful.  Even better is that you don't have to make that keyup connection an logic yourself -- it's baked right into Dijit!

While intermediateChanges property may seem like a very small feature (and in the grand scheme of Dijit, it is), it's very helpful when you need it!  Having this functionality baked into Dojo allows you to continue developing without the hassle of creating your own onChange logic.

Recent Features

  • By
    Create a CSS Flipping Animation

    CSS animations are a lot of fun; the beauty of them is that through many simple properties, you can create anything from an elegant fade in to a WTF-Pixar-would-be-proud effect. One CSS effect somewhere in between is the CSS flip effect, whereby there's...

  • By
    Regular Expressions for the Rest of Us

    Sooner or later you'll run across a regular expression. With their cryptic syntax, confusing documentation and massive learning curve, most developers settle for copying and pasting them from StackOverflow and hoping they work. But what if you could decode regular expressions and harness their power? In...

Incredible Demos

  • By
    MooTools Font-Size Scroller with Cookie Save

    Providing users as many preferences as possible always puts a smile on the user's face. One of those important preferences is font size. I can see fine but the next guy may have difficulty with the font size I choose. That's why...

  • By
    New MooTools Plugin:  ElementFilter

    My new MooTools plugin, ElementFilter, provides a great way for you to allow users to search through the text of any mix of elements. Simply provide a text input box and ElementFilter does the rest of the work. The XHTML I've used a list for this example...

Discussion

  1. You need a bigger screen. : P

  2. Now you just need to port this functionality to MooTools.

    http://mootools.net/docs/core/Element/Element.Event#Element-Events

  3. That’s really cool. Too bad I didn’t have that a while back. I used setInterval() to poll the textbox value while it was focused for this effect; not a very clean solution.

  4. Bill

    Your demo does not work in IE7 nor IE8, if you clear the textbox without using keystrokes (i.e. right-click the textbox that has at least one character, then select “delete”). It works fine in FF.

  5. Tas

    Ah, thanks for this! I think intermediateChanges should be true by default, just like in Flex. I do not understand why it isn’t.

  6. Ryan

    Thanks for posting this!!! For anyone else having trouble catching changes on text fields in the arcgis javascript attributeInspector, this property is the ticket!

  7. Mitesh Agrawal

    Hi,

    Using intermediateChanges solved one of my problem. But I am facing another issue. Whenever my dijit fields are getting focus onchange event is getting fired. Can you tell me where is the problem and how can we overcome it?

  8. I was banging my head for capturing the onChange when I type in the validation text box. one flag makes it all happening. That intermediateChanges should be true by default :(
    But anyhow you made my day for sure :)
    Thank you David!

Wrap your code in <pre class="{language}"></pre> tags, link to a GitHub gist, JSFiddle fiddle, or CodePen pen to embed!