Click here to Skip to main content
13,766,769 members
Click here to Skip to main content
Add your own
alternative version

Tagged as


3 bookmarked
Posted 12 Apr 2016
Licenced CPOL

Working with D3 - Having an AJAX Loader Image

, 12 Apr 2016
Rate this:
Please Sign up or sign in to vote.
Working with D3 - having an Ajax Loader Image

D3 makes it easy to get started adding interesting visualizations to your web application and there are a lot of great examples on The problem is that almost none of these examples are ready for prime-time without some serious tweaking. Either they need to be converted from using static data to relying on AJAX calls, or more importantly they do not support updates.

One suggestion is to use the excellent library by individuals who have taken the time to address these issues and provide a product that is production ready.

Another change you may need is to provide some kind of indication to the user while data is being loaded into the visualization.

Preparing for Adding a Loader - CSS Code

First, you will need to prepare an image to be used as your loading image. One with a transparent background would likely work best.

In your style.css or whatever you are using for your style-sheet, place the following code that specifies the positioning of the loading image and opacity D3 svg container. Also, you'll probably want to specify a minimum size of the container that will hold the D3 chart so the loading image knows where to position itself.

div.ajax_loading {
    position: relative;

/* Grab only the direct descendant of the div that is an image */
div.ajax_loading > img {
    position: absolute;
    left: 0;
    top: 0;
    right: 0;
    bottom: 0;
    margin: auto;

/* Mark all children svg objects as being 50% transparent */
div.ajax_loading svg {
    opacity: 0.5;

/* It is best to size your chart so the loader always knows where to display */
/* An id specifier '#' was used here */
#performance_chart {
    min-width: 400px;
    min-height: 300px;

Add the Loading Image to the HTML Code

Now, you will need to add the 'ajax_loading' class to the HTML DIV that will contain the D3 visualization. Within that DIV, you will add the image.

<div id="performance_chart" class="ajax_loading">
    <img src="img/ajax-loader.gif"/>

This will display the loading image by default and also show a nice dimming effect on any svg objects contained in the target DIV.

The image I used has an opaque background, so it only looks right if you are dimming the DIV as we are doing here. Otherwise, you may want to use one with a transparent background.

Loading Image    

Add Javascript Code to Control the Loading Image

You'll need to activate and deactivate the loading image from whatever code you are using to call and load the data. In my case, before every AJAX call, I display the loader and once the data is received, I hide the loader using the following code:

function setLoadingIndicator(id, status) {"#" + id).classed("ajax_loading", status);"#" + id + " img").classed("hidden", !status);

Example program:

//Show loading indicator
setLoadingIndicator("chart_id", true);
//Make the call to get data
    success: function(data) {
        //Draw the D3 chart
        draw_chart("chart_id", data);
        //Hide loading indicator
        setLoadingIndicator("chart_id", false);
    error: function(result) {
        setLoadingIndicator("chart_id", false);

And that's all there is to it.


This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)


About the Author

Right Handed Monkey
Chief Technology Officer WorxForUs
United States United States
I am a programmer who posts rambling on about java, Android, PHP, or whatever I am motivated to type on my charcoal colored Kinesis Freestyle2 keyboard. Please send +1's, shared links, warm thoughts of encouragement, or emasculating flames of internet fury to my blog. Thanks for reading!

You may also be interested in...

Comments and Discussions

-- There are no messages in this forum --
Permalink | Advertise | Privacy | Cookies | Terms of Use | Mobile
Web01-2016 | 2.8.181114.1 | Last Updated 12 Apr 2016
Article Copyright 2016 by Right Handed Monkey
Everything else Copyright © CodeProject, 1999-2018
Layout: fixed | fluid