Documentation

Dojo Version:

Getting Started

Dojo Start: Difficulty: Beginner Dojo Version: 1.9
How do I start learning Dojo? Where are the docs? How do I get support and training? Which Dojo version should I use? Why do I need to use a web server? How can I avoid common mistakes? How do I report issues? How do I contribute and get involved? These questions and more are answered with this introductory start tutorial.

Hello Dojo!: Difficulty: Beginner Dojo Version: 1.9
Welcome to Dojo! In this tutorial, you’ll learn how to load Dojo and begin exploring some of its core functionality. You’ll also learn about Dojo’s AMD-based module architecture, discover how to load additional modules to add extra functionality to your Web site or application, and find out how to get help when things go wrong.

Modern Dojo: Difficulty: Intermediate Dojo Version: 1.9
You may have been away from Dojo for a while, or you have been struggling to keep your older Dojo 1.6 applications working under 1.8 and you find yourself not sure of what is going on. You keep hearing talk of "AMD" and "baseless", but you aren't sure what to do or where to start. This tutorial will help you with that.

Configuring Dojo with dojoConfig: Difficulty: Beginner Dojo Version: 1.9
The dojoConfig object (formerly djConfig) allows you to set options and default behavior for various aspects of the toolkit. In this tutorial we'll explore what's possible and how you can put dojoConfig to use in your code.

Fundamentals

Classy JavaScript with dojo/_base/declare: Difficulty: Beginner Dojo Version: 1.9

The dojo/_base/declare module is the foundation of class creation within the Dojo Toolkit. declare allows for multiple inheritance to allow developers to create flexible code and avoid writing the same code routines. Dojo, Dijit, and Dojox modules all use declare; in this tutorial, you'll learn why you should too.

Creating Template-based Widgets: Difficulty: Intermediate Dojo Version: 1.9
In this tutorial, you'll learn about the importance of Dijit's _TemplatedMixin mixin, and how to use templates to quickly create your own custom widgets.

Using dojo/query: Difficulty: Beginner Dojo Version: 1.9
In this tutorial, we will learn about DOM querying and how the dojo/query module allows you to easily select nodes and work with them.

NodeList Extensions: Difficulty: Beginner Dojo Version: 1.9
Dojo includes a range of extensions to the NodeList collection that is used by dojo/query. In this tutorial, we’ll look at what extended functionality is available and how to put it to good use.

Making Functions with hitch and partial: Difficulty: Intermediate Dojo Version: 1.9
The dojo/_base/lang resource contains helpful methods for working with functions in JavaScript. In this tutorial, you'll learn the basics of the Function object—and how to bind contexts to functions using lang.hitch. From there, you'll learn how to bind specific arguments to a function using lang.partial, and how lang.hitch can combine the two operations.

Introduction to AMD Modules: Difficulty: Beginner Dojo Version: 1.9
Dojo supports modules written in the Asynchronous Module Definition (AMD) format, which makes code easier to author and debug. In this tutorial, we explain the basics of understanding and using AMD.

Using Declarative Syntax: Difficulty: Intermediate Dojo Version: 1.9
One of the quickest ways to start using Dojo, especially with widgets like Dijit, is to leverage the dojo/parser and declarative syntax. This tutorial will help you get the most out of this style of programming.

Ajax and Data Modeling

Ajax with dojo/request: Difficulty: Beginner Dojo Version: 1.9
dojo/request is a new API (introduced in Dojo 1.8) for making requests to a server from the client. This tutorial introduces the dojo/request API: you'll learn how to request a text file from the server, handle errors if they occur, post information to the server, take advantage of the notify API, and use the registry to use the same code to request data from different locations.

Getting Jiggy with JSONP: Difficulty: Beginner Dojo Version: 1.9
JSON with Padding (JSONP) has become a common technique for accessing cross-domain resources from the browser. In this tutorial you learn what JSONP is and how you can use it to retrieve data from cross-domain sources.

Dojo Object Store: Difficulty: Intermediate Dojo Version: 1.9
Separation of concerns is a fundamental aspect of good programming. Keeping presentation distinct from the data model is a key separation to employ. The Dojo object store architecture establishes a consistent interface for data interaction inspired by the HTML5 object store API.

Data Modeling for MVC Applications: Difficulty: Expert Dojo Version: 1.9
The Model-Viewer-Controller (MVC) is a dominant paradigm for application development. Here we will look at the foundation Dojo provides for MVC-advised applications. We will learn how we can leverage Dojo object stores and Stateful objects for the foundational model, and how we can build modular viewer and controller code on top of the model.

DOM, Events and Effects

Dojo DOM Functions: Difficulty: Beginner Dojo Version: 1.9
In this tutorial, you'll learn about how to use Dojo to manipulate the DOM in a simple, cross-browser way. Using basic DOM knowledge and only a few Dojo functions, you will be able to efficiently create, read, update and delete elements in the page on the fly.

Events with Dojo: Difficulty: Beginner Dojo Version: 1.9
In this tutorial, we will be exploring dojo/on and how Dojo makes it easy to connect to DOM events. We will also explore Dojo's publish/subscribe framework: dojo/topic.

Keyboard Events with Dojo: Difficulty: Beginner Dojo Version: 1.9
In this tutorial, we will be exploring Dojo's event normalization and dojo/keys and how Dojo makes it easy to handle keyboard events.

Dojo Effects: Difficulty: Beginner Dojo Version: 1.9
In this tutorial, we will explore the effects that Dojo provides, which allow us to jazz up your page or application!

Animations: Difficulty: Beginner Dojo Version: 1.9
In this tutorial, you will learn how to use Dojo to create and combine effects for customized animation of elements on the page.

Widgets and Apps

Layout with Dijit: Difficulty: Intermediate Dojo Version: 1.9
Creating dynamic and interactive layouts is a challenge common to any graphical user interface. We have a lot of ability to create layout with HTML and CSS. Where CSS leaves off, Dojo picks up with a set of extensible widgets as a part of Dijit - Dojo's UI framework. In this tutorial, we'll explain how Dijit addresses common layout needs and see how easy it can be to create even complex layouts with just a few flexible widgets.

Understanding _WidgetBase: Difficulty: Intermediate Dojo Version: 1.9
In this tutorial, you'll learn what Dijit's _WidgetBase module is, and how it serves as the foundation for all widgets in the Dojo Toolkit.

Dijit Themes, Buttons, and Textboxes: Difficulty: Beginner Dojo Version: 1.9
In this tutorial, we will show you the basics of creating and using simple form elements using Dijit—including how to set up a Dijit theme for your web application.

Application Controller: Difficulty: Intermediate Dojo Version: 1.9
A page-level controller is the glue that ties together modular functionality to make a living, breathing application. We'll implement configuration and an explicit lifecycle over a loosely coupled architecture to assemble a single-page-application of many moving parts.

Using dojo/hash and dojo/router: Difficulty: Beginner Dojo Version: 1.9
In JavaScript applications, modifying the URL hash is a great way to provide bookmarkable, history-enabled page states. With dojo/hash, adding this functionality is easy. Coupled with dojo/router, dojo/hash can be a powerful tool for creating robust and interactive applications.

A Loading Overlay: Difficulty: Intermediate Dojo Version: 1.9
In this tutorial, we'll create an overlay that puts us in control of the user experience while the loading of dependencies and rendering of the UI takes place in the background.

Build Optimization and Testing

Creating Builds: Difficulty: Advanced Dojo Version: 1.9
Dojo's build system provides a way to "build" Dojo and your other JavaScript resources and CSS files, so they can be more efficiently used in a production environment by your applications.

Feature Detection and Device Optimized Builds: Difficulty: Intermediate Dojo Version: 1.9
Dojo now uses the popular has() pattern for feature detection in combination with a has()-aware build system. While it is easy enough to write feature detection tests with ad-hoc JavaScript expressions, the has() pattern defines a specific syntax such that the build system can detect these feature-based branches, and one can create application builds that are highly optimized for specific devices, with known feature shims factored out.

D.O.H. Test Suite: Difficulty: Intermediate Dojo Version: 1.9
Learn how to set up a suite of unit tests with the DOH test harness, and run them.

Core Concepts

Arrays Made Easy: Difficulty: Beginner Dojo Version: 1.9
In this tutorial, you'll learn about Dojo's cross-platform solution for easily working with arrays in JavaScript: dojo/_base/array.

Getting Started with Deferreds: Difficulty: Intermediate Dojo Version: 1.9
In this tutorial, you'll learn the basics of using Dojo's Deferred implementation, which are a way to easily work with asynchronous actions, such as Ajax calls.

Dojo Deferreds and Promises: Difficulty: Intermediate Dojo Version: 1.9
Deferreds are a wonderful and powerful thing, but they're really an implementation of something greater - a promise. In this tutorial, we'll cover what that means, as well as some additional pieces of Dojo's API to work with both promises and regular values in a uniform way.

Using Custom Modules with a CDN: Difficulty: Intermediate Dojo Version: 1.9
From time to time, it can be useful to load Dojo modules from a CDN. Doing so and using local modules at the same time can seem impossible, however. This tutorial demonstrates how it can be done.

Working with Dates in Dojo: Difficulty: Beginner Dojo Version: 1.9
Dates can be awkward to work with in JavaScript. This tutorial walks through the use of dojo/date—Dojo's answer to the need for a standard library for date math, comparisons, parsing and formatting.

Internationalization with the Dojo Toolkit: Difficulty: Intermediate Dojo Version: 1.9
In this tutorial, you'll learn how the Dojo Toolkit supports internationalization (i18n), including the use of dictionaries for string substitution, and how basic locale formatting for things such as Date objects, numbers and currencies are supported.

Augmenting Objects: Difficulty: Intermediate Dojo Version: 1.9
When you’re working with JavaScript, you’re working with objects. The dojo/_base/lang resource makes it easy to augment objects and prototypes using lang.mixin, lang.extend, and declare.safeMixin when using dojo/_base/declare.

Advanced AMD Usage: Difficulty: Intermediate Dojo Version: 1.9
Dojo now supports modules written in the Asynchronous Module Definition (AMD) format, which makes code easier to author and debug. In this tutorial, we learn all about this new module format, and explore how to write an application using it.

More Widgets

Dialogs & Tooltips: Difficulty: Beginner Dojo Version: 1.9
User interaction is extremely important in building responsive, interactive web applications. Web browsers provide basic methods for user interaction in the form of alerts and dialogs, but this functionality is neither elegant nor flexible. With dijit/Tooltip, dijit/Dialog, and dijit/TooltipDialog, Dijit, the Dojo Toolkit's UI framework, provides cross-browser, extendable, and themeable answers to what the browser's basic functionality lacks. In this tutorial, you'll learn about each of these widgets, sample usages of each, and the ins and outs of creating them.

HTML5 Multi-File Uploader: Difficulty: Beginner Dojo Version: 1.9
The HTML5 multi-file uploader is a widget that creates a stylable file-input button, with optional mult-file selection, using only HTML elements. Non-HTML5 browsers have fallback options of Flash or an iframe.

Form Management with dojox/form/Manager: Difficulty: Intermediate Dojo Version: 1.9
While there are elements within Dojo to allow for simple form validation, occasionally you may want a more powerful solution. The Dojo Toolkit offers a fantastic solution for detailed form management: dojox/form/Manager.

Forms and Validation: Difficulty: Beginner Dojo Version: 1.9
In this tutorial, you'll learn how to make use of the validation helpers in dojox/validate with your Dijit-based form widgets to create customizable, validating forms—all on the client side.

Slippin' Sliders with Dijit: Difficulty: Beginner Dojo Version: 1.9
The HTML5 specification provides many new features, such as the <input type="range"> element which allows users to choose from a range of values. Unfortunately, this new input type is not supported in all browsers, and looks different in each browser that does support it. That's where Dijit's HorizontalSlider and VerticalSlider widgets come in: flexible, themeable, and functional.

Dijit Checkboxes: Difficulty: Beginner Dojo Version: 1.9
Dijit's collection of form widgets provides a convenient and flexible range of options for creating rich forms. In this tutorial we will look at the options available for checkbox-style interaction.

Getting Selective with Dijit: Difficulty: Beginner Dojo Version: 1.9
In this tutorial, we will explore widgets in the dijit/form namespace which enhance the user experience of HTML select elements: Select, FilteringSelect, and ComboBox.

Dijit Menus: Difficulty: Beginner Dojo Version: 1.9
Dijit is a powerful framework for allowing us to create very clean, professional-looking interfaces. Sometimes, that means that we need a desktop-like experience with a menu of options. With dijit/Menu, we have a very powerful yet easy-to-use tool to create these interfaces.

Creating a custom widget: Difficulty: Intermediate Dojo Version: 1.9
In this recipe, we'll be covering how to leverage pieces of Dojo and the Dijit framework to create your own custom widgets, specifically covering use of dijit/_WidgetBase and dijit/_TemplatedMixin to quickly and easily set up your widget.

Dijit Editor: Difficulty: Beginner Dojo Version: 1.9
Dijit's Editor widget is everything a developer looks for in a WYSIWYG editor: flexible, themeable, and above all, functional. In this tutorial, you'll learn how to easily implement dijit/Editor (programmatically and declaratively), customize its toolbars, and include Editor plugins from DojoX.

Working with Data

Introduction to the DataGrid: Difficulty: Intermediate Dojo Version: 1.9
The DataGrid is the central component of many applications due to its effective and usable presentation of tabular data. In this tutorial we will look at how to define a grid's layout and discuss the scrolling mechanism the DataGrid uses.

Populating your Grid using dojo/data: Difficulty: Intermediate Dojo Version: 1.9
The DataGrid is the central component of many applications due to its effective and usable presentation of tabular data. In this tutorial we will look at how to populate a grid and manipulate data in a grid.

Connecting a Store to a DataGrid: Difficulty: Beginner Dojo Version: 1.9
The DataGrid is the central component of many applications due to its effective and usable presentation of tabular data. In this tutorial we will look at how to connect the grid to a store for quick and efficient data retrieval and updating.

Connecting a Store to a Tree: Difficulty: Intermediate Dojo Version: 1.9
The Dojo Tree component is a powerful tool for visual presentation of hierarchical data. In this tutorial we will look at how to connect the tree to a store for quick and efficient data drill-down into nested data.

Working with the Grid: Difficulty: Intermediate Dojo Version: 1.9
In this tutorial, you'll learn about the Grid's event system, how to select rows, and how to set up your grid for editing.

Real-time Stores: Difficulty: Intermediate Dojo Version: 1.9
Web applications based on real-time stores give users a level of immediacy not possible with traditional web applications, allowing them to see data as it changes. The Dojo object store interface, which is the data model foundation of Dojo applications, was designed to support real-time data updates. In this tutorial we will see how to leverage the notification system to interact with real-time widgets.

Creating Dojo Stores: Difficulty: Intermediate Dojo Version: 1.9
In this tutorial, you'll learn the basic APIs all dojo/stores follow and how to create your own store—including how to handle query results.

Advanced Dijit Selects using Stores: Difficulty: Intermediate Dojo Version: 1.9
In this tutorial, we will further explore Dijit's select widgets—particularly how to create instances programmatically, populating their drop-down lists from dojo/data stores.

Using Dojo Data: Difficulty: Intermediate Dojo Version: 1.9
Dojo Data is the legacy data interface used to abstract data consumers (like widgets) from the concerns of data providers. While the new object store interface has superseded the dojo/data interface, there are a number of existing data stores that implement this API and is used by quite a few existing widgets. Here we will look at the dojo/data interface, see how data providers and widgets connect together, and learn how it can be adapted to the new interface.

Vector Graphics

Dojo Charting: Difficulty: Beginner Dojo Version: 1.9
Presenting statistical data in a readable, eye-catching manner is important, but it can also be difficult. The dojox/charting system was created to alleviate those pains by allowing developers to create dynamic, unique, and functional charts from varying sets of data. In addition, dojox/charting provides numerous themes and chart types to allow developers to display their data any way they'd like. This tutorial will show you how to create basic charts with varying data, plots, axes, and themes.

Advanced Charting with Dojo: Difficulty: Intermediate Dojo Version: 1.9
While most developers only need basic charts, dojox/charting is capable of highly advanced charts: charts with animations, charts that respond to changes in data, and charts that respond to events. In this tutorial, you will learn about using some these advanced capabilities within dojox/charting.

Vector Graphics with Dojo's GFX: Difficulty: Beginner Dojo Version: 1.9
Vector graphics can have many advantages, including flawless scaling with maximum portability. The problem with vector graphic creation is that it can be difficult—but not so with Dojo's GFX library. GFX provides a simple and flexible API (along with other utilities) for creating, animating, and managing amazing vector graphics.

Server-side JavaScript

Dojo and Node.js: Difficulty: Intermediate Dojo Version: 1.9
JavaScript is not just for the client side. With the rise of technologies like Node.js, server side JavaScript is a very viable option. Not only is JavaScript ready for the server side, AMD and the Dojo Toolkit also work well and this tutorial will explain how you can use Dojo with Node.js.

Mobile

Getting Started with dojox/mobile: Difficulty: Beginner Dojo Version: 1.9 Series: TweetView
Content on the web is evolving at a rapid pace, and the path is quickly moving towards mobile devices. As with many other problems on the web, the Dojo Toolkit has the solution: dojox/mobile. dojox/mobile is a framework of controllers, CSS3-based themes, and device-like widgets that will allow you to effortlessly create intelligent, flexible, and cross-device-compatible mobile web applications. This is the introductory post in a series of posts exploring dojox/mobile. Throughout the series, we will create a powerful Twitter-based web application called TweetView. Before we can get to that, we'll need to learn about why and how to use dojox/mobile.

Introduction to TweetView: Difficulty: Intermediate Dojo Version: 1.9 Series: TweetView
The first article in our series, Getting Started with dojox/mobile, detailed the fundamental concepts and usage of the Dojo Toolkit's dojox/mobile library. In the remaining posts in this series, we'll embark on creating our own fully functional dojox/mobile web application called TweetView. This post will focus on familiarizing you with what TweetView is, what we want it to do, and we'll get started on building the mobile application's HTML and CSS layout.

Getting Started with TweetView: Tweets and Mentions: Difficulty: Intermediate Dojo Version: 1.9 Series: TweetView
In the previous post, Introduction to TweetView, we introduced the mobile application we will be building with dojox/mobile: TweetView. We built the general layout template for our application and now it's time to make TweetView work. This tutorial will focus specifically on the "Tweets" and "Mentions" views of our application. Before we begin coding our application, let's set up our application file structure and review a few mobile app development concepts.

TweetView: Creating the Settings View: Difficulty: Intermediate Dojo Version: 1.9 Series: TweetView
In the previous post, Getting Started with TweetView: Tweets and Mentions, we solidified our mobile application's file structure, reviewed TweetView's goals, and created the Tweets and Mentions views by coding tweetview/_ViewMixin and tweetview/TweetView. This tutorial will focus specifically on the "Settings" view of our application: dependencies for the class, how the Settings view ties into the Tweet and Mention views, and coding the Settings view itself.

TweetView: Android, Packaging, and Review: Difficulty: Intermediate Dojo Version: 1.9 Series: TweetView
In the previous two posts, Getting Started with TweetView: Tweets and Mentions and TweetView: Creating the Settings View, we created the HTML, CSS, and JavaScript code required to power the TweetView mobile application. This tutorial will focus on implementing an Android theme, leveraging the Dojo build system to keep the application compact for production, and a basic review of the entire dojox/mobile-powered application.